// Copyright 2014 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 or the MIT license // , at your // option. This file may not be copied, modified, or distributed // except according to those terms. use io::{IoResult, Writer}; use iter::{Iterator, IteratorExt}; use option::Option::{Some, None}; use result::Result::{Ok, Err}; use str::{StrPrelude, from_str}; use unicode::char::UnicodeChar; #[cfg(target_word_size = "64")] pub const HEX_WIDTH: uint = 18; #[cfg(target_word_size = "32")] pub const HEX_WIDTH: uint = 10; // All rust symbols are in theory lists of "::"-separated identifiers. Some // assemblers, however, can't handle these characters in symbol names. To get // around this, we use C++-style mangling. The mangling method is: // // 1. Prefix the symbol with "_ZN" // 2. For each element of the path, emit the length plus the element // 3. End the path with "E" // // For example, "_ZN4testE" => "test" and "_ZN3foo3bar" => "foo::bar". // // We're the ones printing our backtraces, so we can't rely on anything else to // demangle our symbols. It's *much* nicer to look at demangled symbols, so // this function is implemented to give us nice pretty output. // // Note that this demangler isn't quite as fancy as it could be. We have lots // of other information in our symbols like hashes, version, type information, // etc. Additionally, this doesn't handle glue symbols at all. pub fn demangle(writer: &mut Writer, s: &str) -> IoResult<()> { // First validate the symbol. If it doesn't look like anything we're // expecting, we just print it literally. Note that we must handle non-rust // symbols because we could have any function in the backtrace. let mut valid = true; let mut inner = s; if s.len() > 4 && s.starts_with("_ZN") && s.ends_with("E") { inner = s.slice(3, s.len() - 1); // On Windows, dbghelp strips leading underscores, so we accept "ZN...E" form too. } else if s.len() > 3 && s.starts_with("ZN") && s.ends_with("E") { inner = s.slice(2, s.len() - 1); } else { valid = false; } if valid { let mut chars = inner.chars(); while valid { let mut i = 0; for c in chars { if c.is_numeric() { i = i * 10 + c as uint - '0' as uint; } else { break } } if i == 0 { valid = chars.next().is_none(); break } else if chars.by_ref().take(i - 1).count() != i - 1 { valid = false; } } } // Alright, let's do this. if !valid { try!(writer.write_str(s)); } else { let mut first = true; while inner.len() > 0 { if !first { try!(writer.write_str("::")); } else { first = false; } let mut rest = inner; while rest.char_at(0).is_numeric() { rest = rest.slice_from(1); } let i: uint = from_str(inner.slice_to(inner.len() - rest.len())).unwrap(); inner = rest.slice_from(i); rest = rest.slice_to(i); while rest.len() > 0 { if rest.starts_with("$") { macro_rules! demangle { ($($pat:expr => $demangled:expr),*) => ({ $(if rest.starts_with($pat) { try!(writer.write_str($demangled)); rest = rest.slice_from($pat.len()); } else)* { try!(writer.write_str(rest)); break; } }) } // see src/librustc/back/link.rs for these mappings demangle! ( "$SP$" => "@", "$UP$" => "Box", "$RP$" => "*", "$BP$" => "&", "$LT$" => "<", "$GT$" => ">", "$LP$" => "(", "$RP$" => ")", "$C$" => ",", // in theory we can demangle any Unicode code point, but // for simplicity we just catch the common ones. "$x20" => " ", "$x27" => "'", "$x5b" => "[", "$x5d" => "]" ) } else { let idx = match rest.find('$') { None => rest.len(), Some(i) => i, }; try!(writer.write_str(rest.slice_to(idx))); rest = rest.slice_from(idx); } } } } Ok(()) }