gstack - Print a stack trace of a running program
Contents
Copyright
Copyright (c) 1988-2024 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free
Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with
the Invariant Sections being "Free Software" and "Free Software Needs Free Documentation", with the
Front-Cover Texts being "A GNU Manual," and with the Back-Cover Texts as in (a) below.
(a) The FSF's Back-Cover Text is: "You are free to copy and modify this GNU Manual. Buying copies from
GNU Press supports the FSF in developing GNU and promoting software freedom."
gdb-16.2 2025-03-21 GSTACK(1)
Description
Print a stack trace of a running program with process ID pid. If the process is multi-threaded, gstack
outputs backtraces for every thread which exists in the process.
The script invokes GDB, attaches to the given process ID, prints the stack trace, and detaches from the
process.
gstack exits with non-zero status if "gdb" was unable to attach to the given process ID for any reason,
such as a non-existent process ID or insufficient privileges to attach to the process.
Environment
AWK Full file name for an Awk interpreter to use. If not set, PATH will be searched for an "awk"
program.
GDB Full file name for a GDB executable to use to generate stack backtraces. If not set, PATH will be
searched for a "gdb" program.
GDBARGS
Optional arguments to be passed to the "gdb" program.
Name
gstack - Print a stack trace of a running program
Options
--help-h List all options, with brief explanations.
--version-v Print version information and then exit.
See Also
The full documentation for GDB is maintained as a Texinfo manual. If the "info" and "gdb" programs and
GDB's Texinfo documentation are properly installed at your site, the command
info gdb
should give you access to the complete manual.
UsingGDB:AGuidetotheGNUSource-LevelDebugger, Richard M. Stallman and Roland H. Pesch, July 1991.
Synopsis
gstack [-h | --help] [-v | --version] pid