Skip to content

Commit 827da1d

Browse files
committed
Fix short backtraces from stripped executables
Locate the beginning and ending frames for short backtraces by address in addition to symbol name, so that they work even when symbols have been stripped from the executable. We need to retain matching by symbol name for the time being, because rustc (and some associated ui tests) rely upon it to have ICE backtraces abbreviated. They can be updated once this commit lands in beta/stage0.
1 parent d222ddc commit 827da1d

4 files changed

Lines changed: 87 additions & 22 deletions

File tree

library/std/src/backtrace.rs

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,16 @@ use crate::panic::UnwindSafe;
9494
use crate::sync::LazyLock;
9595
use crate::sync::atomic::Ordering::Relaxed;
9696
use crate::sync::atomic::{Atomic, AtomicU8};
97+
#[unstable(
98+
feature = "short_backtrace_termini",
99+
reason = "for rustc to have ICE backtraces abbreviated",
100+
issue = "none"
101+
)]
102+
#[doc(hidden)]
103+
pub use crate::sys::backtrace::{
104+
__rust_begin_short_backtrace as begin_short_backtrace,
105+
__rust_end_short_backtrace as end_short_backtrace,
106+
};
97107
use crate::sys::backtrace::{lock, output_filename, set_image_base};
98108
use crate::{env, fmt};
99109

library/std/src/sys/backtrace.rs

Lines changed: 50 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@
44
use crate::backtrace_rs::{self, BacktraceFmt, BytesOrWideString, PrintFmt};
55
use crate::borrow::Cow;
66
use crate::io::prelude::*;
7+
use crate::mem::{ManuallyDrop, MaybeUninit};
78
use crate::path::{self, Path, PathBuf};
89
use crate::sync::{Mutex, MutexGuard, PoisonError};
910
use crate::{env, fmt, io};
@@ -81,12 +82,26 @@ unsafe fn _print_fmt(fmt: &mut fmt::Formatter<'_>, print_fmt: PrintFmt) -> fmt::
8182
let frame_ip = frame.ip();
8283
res = writeln!(bt_fmt.formatter(), "{idx:4}: {frame_ip:HEX_WIDTH$?}");
8384
} else {
85+
// `call_with_short_backtrace_marker::<End>` means we are done hiding symbols
86+
// for now. Print until we see `call_with_short_backtrace_marker::<Begin>`.
87+
if print_fmt == PrintFmt::Short {
88+
let sym = frame.symbol_address();
89+
if sym == call_with_short_backtrace_marker::<End> as _ {
90+
print = true;
91+
return true;
92+
} else if print && sym == call_with_short_backtrace_marker::<Begin> as _ {
93+
print = false;
94+
return true;
95+
}
96+
}
97+
8498
let mut hit = false;
8599
backtrace_rs::resolve_frame_unsynchronized(frame, |symbol| {
86100
hit = true;
87101

88-
// `__rust_end_short_backtrace` means we are done hiding symbols
89-
// for now. Print until we see `__rust_begin_short_backtrace`.
102+
// Hide `__rust_[begin|end]_short_backtrace` frames from short backtraces.
103+
// Unfortunately these generic functions have to be matched by name, as we do
104+
// not know their generic parameters.
90105
if print_fmt == PrintFmt::Short {
91106
if let Some(sym) = symbol.name().and_then(|s| s.as_str()) {
92107
if sym.contains("__rust_end_short_backtrace") {
@@ -159,32 +174,45 @@ unsafe fn _print_fmt(fmt: &mut fmt::Formatter<'_>, print_fmt: PrintFmt) -> fmt::
159174
/// this is only inline(never) when backtraces in std are enabled, otherwise
160175
/// it's fine to optimize away.
161176
#[cfg_attr(feature = "backtrace", inline(never))]
162-
pub fn __rust_begin_short_backtrace<F, T>(f: F) -> T
163-
where
164-
F: FnOnce() -> T,
165-
{
166-
let result = f();
177+
fn call_with_short_backtrace_marker<T: Terminus>(f: &mut dyn FnMut()) {
178+
f();
167179

168-
// prevent this frame from being tail-call optimised away
169-
crate::hint::black_box(());
180+
// (Try to) prevent both Identical Code Folding (which might merge the `Begin` and `End`
181+
// versions of this function, giving them the same address) and Tail Call Optimisation (which
182+
// could remove their frames from the call stack).
183+
crate::hint::black_box(T::ID);
184+
}
170185

171-
result
186+
trait Terminus {
187+
const ID: u32;
172188
}
173189

174-
/// Fixed frame used to clean the backtrace with `RUST_BACKTRACE=1`. Note that
175-
/// this is only inline(never) when backtraces in std are enabled, otherwise
176-
/// it's fine to optimize away.
177-
#[cfg_attr(feature = "backtrace", inline(never))]
178-
pub fn __rust_end_short_backtrace<F, T>(f: F) -> T
179-
where
180-
F: FnOnce() -> T,
181-
{
182-
let result = f();
190+
macro_rules! short_backtrace_termini {
191+
($($f:ident => $t:ident($id:literal)),* $(,)?) => {$(
192+
struct $t;
193+
impl Terminus for $t {
194+
const ID: u32 = $id;
195+
}
183196

184-
// prevent this frame from being tail-call optimised away
185-
crate::hint::black_box(());
197+
#[doc(hidden)]
198+
#[unstable(feature = "short_backtrace_termini", reason = "for rustc to have ICE backtraces abbreviated", issue = "none")]
199+
#[inline(always)]
200+
pub fn $f<F, T>(f: F) -> T
201+
where
202+
F: FnOnce() -> T,
203+
{
204+
let mut result = MaybeUninit::<T>::uninit();
205+
let mut f = ManuallyDrop::new(f);
206+
let mut f = || { result.write(unsafe { ManuallyDrop::take(&mut f) }()); };
207+
call_with_short_backtrace_marker::<$t>(&mut f);
208+
unsafe { result.assume_init() }
209+
}
210+
)*};
211+
}
186212

187-
result
213+
short_backtrace_termini! {
214+
__rust_begin_short_backtrace => Begin(0),
215+
__rust_end_short_backtrace => End(1),
188216
}
189217

190218
/// Prints the filename of the backtrace frame.
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
//! Short backtraces should still be emitted from stripped binaries.
2+
//! Regression test for https://github.com/rust-lang/rust/issues/147846
3+
//
4+
//@ compile-flags: -Cstrip=symbols
5+
//@ exec-env: RUST_BACKTRACE=1
6+
//@ run-fail
7+
//@ check-run-results
8+
//
9+
// Name mangling scheme differences
10+
//@ normalize-stderr: "begin_panic::<&str>" -> "begin_panic"
11+
//
12+
// macOS with `rust.debuginfo-level = "line-tables-only"` (#133997)
13+
//@ normalize-stderr: " begin_panic<&str>" -> " std::panicking::begin_panic"
14+
//
15+
// debuginfo
16+
//@ normalize-stderr: "\n +at [^\n]+" -> ""
17+
18+
fn main() { panic!(); }
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
2+
thread 'main' ($TID) panicked at $DIR/short-backtrace-in-stripped.rs:18:13:
3+
explicit panic
4+
stack backtrace:
5+
0: std::panicking::begin_panic
6+
1: <unknown>
7+
2: <unknown>
8+
3: <unknown>
9+
note: Some details are omitted, run with `RUST_BACKTRACE=full` for a verbose backtrace.

0 commit comments

Comments
 (0)