gstack(1) — Linux manual page

GSTACK(1)                 GNU Development Tools                 GSTACK(1)

NAME         top

       gstack - Print a stack trace of a running program

SYNOPSIS         top

       gstack [-h | --help] [-v | --version] pid

DESCRIPTION         top

       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.

OPTIONS         top

       --help
       -h  List all options, with brief explanations.

       --version
       -v  Print version information and then exit.

ENVIRONMENT         top

       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.

SEE ALSO         top

       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.

       Using GDB: A Guide to the GNU Source-Level Debugger, Richard M.
       Stallman and Roland H. Pesch, July 1991.

COPYRIGHT         top

       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."

COLOPHON         top

       This page is part of the gdb (GNU debugger) project.  Information
       about the project can be found at 
       ⟨http://www.gnu.org/software/gdb/⟩.  If you have a bug report for
       this manual page, see ⟨http://www.gnu.org/software/gdb/bugs/⟩.
       This page was obtained from the tarball gdb-16.3.tar.gz fetched
       from ⟨https://ftp.gnu.org/gnu/gdb/⟩ on 2025-08-11.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for the
       page, or you have corrections or improvements to the information
       in this COLOPHON (which is not part of the original manual page),
       send a mail to man-pages@man7.org

gdb-16.3                        2025-04-20                      GSTACK(1)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.