2012-12-03 18:48:01 -06:00
|
|
|
// Copyright 2012 The Rust Project Developers. See the COPYRIGHT
|
|
|
|
// file at the top-level directory of this distribution and at
|
|
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
|
|
// option. This file may not be copied, modified, or distributed
|
|
|
|
// except according to those terms.
|
|
|
|
|
2012-07-04 16:53:12 -05:00
|
|
|
//! Unsafe debugging functions for inspecting values.
|
2010-08-24 20:37:42 -05:00
|
|
|
|
2013-05-28 22:11:41 -05:00
|
|
|
#[allow(missing_doc)];
|
|
|
|
|
2013-04-20 09:27:16 -05:00
|
|
|
use core::cast::transmute;
|
2013-06-20 04:39:49 -05:00
|
|
|
#[cfg(stage0)]
|
|
|
|
use intrinsic::{get_tydesc};
|
|
|
|
#[cfg(not(stage0))]
|
|
|
|
use core::unstable::intrinsics::{get_tydesc};
|
2012-06-01 21:47:04 -05:00
|
|
|
|
2013-03-05 14:21:02 -06:00
|
|
|
pub mod rustrt {
|
2013-06-20 04:39:49 -05:00
|
|
|
#[cfg(stage0)]
|
|
|
|
use intrinsic::{TyDesc};
|
|
|
|
#[cfg(not(stage0))]
|
|
|
|
use core::unstable::intrinsics::{TyDesc};
|
2013-03-05 14:21:02 -06:00
|
|
|
|
|
|
|
#[abi = "cdecl"]
|
|
|
|
pub extern {
|
2013-06-20 04:39:49 -05:00
|
|
|
pub unsafe fn debug_tydesc(td: *TyDesc);
|
|
|
|
pub unsafe fn debug_opaque(td: *TyDesc, x: *());
|
|
|
|
pub unsafe fn debug_box(td: *TyDesc, x: *());
|
|
|
|
pub unsafe fn debug_tag(td: *TyDesc, x: *());
|
|
|
|
pub unsafe fn debug_fn(td: *TyDesc, x: *());
|
|
|
|
pub unsafe fn debug_ptrcast(td: *TyDesc, x: *()) -> *();
|
2013-03-05 14:21:02 -06:00
|
|
|
pub unsafe fn rust_dbg_breakpoint();
|
|
|
|
}
|
2010-08-24 20:37:42 -05:00
|
|
|
}
|
|
|
|
|
2012-09-27 20:03:00 -05:00
|
|
|
pub fn debug_tydesc<T>() {
|
2013-01-10 23:23:07 -06:00
|
|
|
unsafe {
|
2013-06-20 04:39:49 -05:00
|
|
|
rustrt::debug_tydesc(get_tydesc::<T>());
|
2013-01-10 23:23:07 -06:00
|
|
|
}
|
2011-10-20 19:06:52 -05:00
|
|
|
}
|
2010-08-24 20:37:42 -05:00
|
|
|
|
2012-10-03 14:21:48 -05:00
|
|
|
pub fn debug_opaque<T>(x: T) {
|
2013-01-10 23:23:07 -06:00
|
|
|
unsafe {
|
2013-06-20 04:39:49 -05:00
|
|
|
rustrt::debug_opaque(get_tydesc::<T>(), transmute(&x));
|
2013-01-10 23:23:07 -06:00
|
|
|
}
|
2011-10-20 19:06:52 -05:00
|
|
|
}
|
2010-08-24 20:37:42 -05:00
|
|
|
|
2012-09-27 20:03:00 -05:00
|
|
|
pub fn debug_box<T>(x: @T) {
|
2013-01-10 23:23:07 -06:00
|
|
|
unsafe {
|
2013-06-20 04:39:49 -05:00
|
|
|
rustrt::debug_box(get_tydesc::<T>(), transmute(&x));
|
2013-01-10 23:23:07 -06:00
|
|
|
}
|
2011-10-20 19:06:52 -05:00
|
|
|
}
|
2011-06-15 13:19:50 -05:00
|
|
|
|
2012-10-03 14:21:48 -05:00
|
|
|
pub fn debug_tag<T>(x: T) {
|
2013-01-10 23:23:07 -06:00
|
|
|
unsafe {
|
2013-06-20 04:39:49 -05:00
|
|
|
rustrt::debug_tag(get_tydesc::<T>(), transmute(&x));
|
2013-01-10 23:23:07 -06:00
|
|
|
}
|
2011-10-20 19:06:52 -05:00
|
|
|
}
|
2010-08-24 20:37:42 -05:00
|
|
|
|
2012-10-03 14:21:48 -05:00
|
|
|
pub fn debug_fn<T>(x: T) {
|
2013-01-10 23:23:07 -06:00
|
|
|
unsafe {
|
2013-06-20 04:39:49 -05:00
|
|
|
rustrt::debug_fn(get_tydesc::<T>(), transmute(&x));
|
2013-01-10 23:23:07 -06:00
|
|
|
}
|
2011-10-20 19:06:52 -05:00
|
|
|
}
|
2010-09-22 17:44:13 -05:00
|
|
|
|
2012-09-27 20:03:00 -05:00
|
|
|
pub unsafe fn ptr_cast<T, U>(x: @T) -> @U {
|
2013-04-20 09:27:16 -05:00
|
|
|
transmute(
|
2013-06-20 04:39:49 -05:00
|
|
|
rustrt::debug_ptrcast(get_tydesc::<T>(), transmute(x)))
|
2011-10-12 15:31:41 -05:00
|
|
|
}
|
2010-12-31 12:35:39 -06:00
|
|
|
|
2012-07-04 16:53:12 -05:00
|
|
|
/// Triggers a debugger breakpoint
|
2012-09-27 20:03:00 -05:00
|
|
|
pub fn breakpoint() {
|
2013-01-10 23:23:07 -06:00
|
|
|
unsafe {
|
|
|
|
rustrt::rust_dbg_breakpoint();
|
|
|
|
}
|
2012-06-01 02:11:51 -05:00
|
|
|
}
|
|
|
|
|
|
|
|
#[test]
|
|
|
|
fn test_breakpoint_should_not_abort_process_when_not_under_gdb() {
|
|
|
|
// Triggering a breakpoint involves raising SIGTRAP, which terminates
|
|
|
|
// the process under normal circumstances
|
|
|
|
breakpoint();
|
|
|
|
}
|