GSTACK(1)

📦
version 15.3.rel2 · 2 versions
, in nixpkgs unstable

💅 gstack — GSTACK(1) 💅

okay bestie, welcome to the GNU Development Tools manual page for gstack — yes, that's GSTACK(1), and it is literally here to print a stack trace of a running program. 🫶

✨ NAME ✨

gstack — Print a stack trace of a running program. 🔥

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

So here's the tea: gstack prints a stack trace of a running program with process ID pid. If that 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. iconic. ✨

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. no cap, if the attach doesn't work, it's a non-zero exit. 💀

🎀 OPTIONS 🎀

  • --help, -h — lists all options, with brief explanations. 💖
  • --version, -v — prints version information and then exits. ✨

🌈 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. 💜

⭐ 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. 👑

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

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

🫶 mwah! this page is from gdb-16.3.90.20250906-git, dated 2026-10-03, and it's GSTACK(1) forever. 💅

📦 where this page comes from