Skip to content

Default to full gdb backtraces#21

Merged
rousskov merged 2 commits intosquid-cache:mainfrom
measurement-factory:SQUID-111-bt-full
Feb 16, 2024
Merged

Default to full gdb backtraces#21
rousskov merged 2 commits intosquid-cache:mainfrom
measurement-factory:SQUID-111-bt-full

Conversation

@rousskov
Copy link
Copy Markdown
Contributor

Receiving a dump of local variables often reduces the number of requests
for more information in bug reports and speeds up triage. The downsides
(i.e. more output, slightly higher risk of exposing sensitive
information, and hypothetical lack of support in very old gdb) are not
significant enough to preserve the old "less info" default.

AFAICT, gdb supports backtrace full since 1998 commit 65b07dd (at
least). Since 2019, gdb prefers backtrace -full to backtrace full,
but we are not upgrading yet to accommodate older/more environments.
Other debuggers may not support "full", but our instructions are already
gdb-specific, and most folks folks can adapt them as needed.

Also do not distract the reader with an out-of-scope explanation on how
gdb commands may be abbreviated (e.g., "bt" instead of "backtrace").

Receiving a dump of local variables often reduces the number of requests
for more information in bug reports and speeds up triage. The downsides
(i.e. more output, slightly higher risk of exposing sensitive
information, and hypothetical lack of support in very old gdb) are not
significant enough to preserve the old "less info" default.

AFAICT, gdb supports `backtrace full` since 1998 commit 65b07dd (at
least). Since 2019, gdb prefers `backtrace -full` to `backtrace full`,
but we are not upgrading yet to accommodate older/more environments.
Other debuggers may not support "full", but our instructions are already
gdb-specific, and most folks folks can adapt them as needed.

Also do not distract the reader with an out-of-scope explanation on how
gdb commands may be abbreviated (e.g., "bt" instead of "backtrace").
Comment thread docs/SquidFaq/BugReporting.md Outdated
@rousskov rousskov merged commit 0cd8ce7 into squid-cache:main Feb 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants