procdump1

Generate coredumps based on performance triggers.

Usage

procdump [ -n count ] [ -s seconds ] [ -c|-cl CPU usage ] [ -m|-ml usage ] [ -gcm [[gc-generation:|LOH:|POH:]mem_usage[,mem_usage,...]] ] [ -gcgen generation ] [ -tc threshold ] [ -fc threshold ] [ -sig number ] [ -e ] [ -f filter,... ] [ -pf frequency ] [ -o ] [ -log ] [[ [ -w name ] | [ -pgid pid ] ] [ file | folder ]]

Overview

procdump is a Linux reimagining of the class ProcDump tool from the Sysinternals suite of tools for Windows. Procdump provides a convenient way for Linux developers to create core dumps of their application based on performance triggers.

Options

-n: Number of dumps to write before exiting.

-s: Consecutive seconds before dump is written (default is 10).

-c: CPU threshold above which to create a dump of the process.

-cl: CPU threshold below which to create a dump of the process.

-m: Memory commit threshold(s) (MB) above which to create dumps.

-ml: Memory commit threshold(s) (MB) below which to create dumps.

-gcm: [.NET] GC memory threshold(s) (MB) above which to create dumps for the specified generation or heap (default is total .NET memory usage).

-gcgen: [.NET] Create dump when the garbage collection of the specified generation starts and finishes.

-tc: Thread count threshold above which to create a dump of the process.

-fc: File descriptor count threshold above which to create a dump of the process.

-sig: Signal number to intercept to create a dump of the process.

-e: [.NET] Create dump when the process encounters an exception.

-f: [.NET] Filter (include) on the (comma separated) exception name(s) and exception messages(s). Supports wildcards.

-pf: Polling frequency.

-o: Overwrite existing dump file.

-log: Writes extended ProcDump tracing to syslog.

-w: Wait for the specified process to launch if it's not running.

-pgid: Process ID specified refers to a process group ID.

Releases

3 releases since Debian 11 (Bullseye); the text changed 2 times.

-cl since Debian 13 (Trixie); -e since Debian 13 (Trixie); -f since Debian 13 (Trixie); -fc since Debian 13 (Trixie); -gcgen since Debian 13 (Trixie); -gcm since Debian 13 (Trixie); -log since Debian 13 (Trixie); -ml since Debian 13 (Trixie); -o since Debian 12 (Bookworm); -pf since Debian 13 (Trixie); -pgid since Debian 13 (Trixie); -sig since Debian 13 (Trixie); -tc since Debian 13 (Trixie).

-C until Debian 12 (Bookworm); -F until Debian 12 (Bookworm); -I until Debian 12 (Bookworm); -M until Debian 12 (Bookworm); -T until Debian 12 (Bookworm); -d until Debian 12 (Bookworm); -h until Debian 12 (Bookworm); -p until Debian 12 (Bookworm).