dwww Home | Manual pages | Find package

exitsnoop(8)                System Manager's Manual               exitsnoop(8)

NAME
       exitsnoop  -  Trace  all process termination (exit, fatal signal). Uses
       Linux eBPF/bcc.

SYNOPSIS
       exitsnoop  [-h]  [-t]   [--utc]   [-x]   [-p   PID]   [--label   LABEL]
       [--per-thread]

DESCRIPTION
       exitsnoop traces process termination, showing the command name and rea-
       son for termination, either an exit or a fatal signal.

       It  catches processes of all users, processes in containers, as well as
       processes that become zombie.

       This works by tracing the kernel  sched_process_exit()  function  using
       dynamic  tracing,  and  will need updating to match any changes to this
       function.

       Since this uses BPF, only the root user can use this tool.

REQUIREMENTS
       CONFIG_BPF and bcc.

OPTIONS
       -h     Print usage message.

       -t     Include a timestamp column.

       --utc  Include a timestamp column, use UTC timezone.

       -x     Exclude successful exits, exit( 0 )

       -p PID Trace this process ID only (filtered in-kernel).

       --label LABEL
              Label each line with LABEL (default 'exit') in first column (2nd
              if timestamp is present).

       --per-thread
              Trace per thread termination

EXAMPLES
       Trace all process termination
              # exitsnoop

       Trace all process termination, and include timestamps:
              # exitsnoop -t

       Exclude successful exits, only include non-zero exit codes and fatal
       signals:
              # exitsnoop -x

       Trace PID 181 only:
              # exitsnoop -p 181

       Label each output line with 'EXIT':
              # exitsnoop --label EXIT

       Trace per thread termination
              # exitsnoop --per-thread

FIELDS
       TIME-TZ
              Time of  process  termination  HH:MM:SS.sss  with  milliseconds,
              where TZ is the local time zone, 'UTC' with --utc option.

       LABEL  The  optional  label  if --label option is used.  This is useful
              with the -t option for timestamps when  the  output  of  several
              tracing tools is sorted into one combined output.

       PCOMM  Process/command name.

       PID    Process ID

       PPID   The  process ID of the process that will be notified of PID ter-
              mination.

       TID    Thread ID.

       EXIT_CODE
              The exit code for exit() or the signal number for a  fatal  sig-
              nal.

OVERHEAD
       This  traces the kernel sched_process_exit() function and prints output
       for each event.  As the rate of this is generally expected to be low (<
       1000/s), the overhead is also expected to be negligible. If you have an
       application that has a high rate of process termination, then test  and
       understand overhead before use.

SOURCE
       This is from bcc.

              https://github.com/iovisor/bcc

       Also  look  in  the bcc distribution for a companion _examples.txt file
       containing example usage, output, and commentary for this tool.

OS
       Linux

STABILITY
       Unstable - in development.

AUTHOR
       Arturo Martin-de-Nicolas

SEE ALSO
       execsnoop(8)

USER COMMANDS                     2019-05-28                      exitsnoop(8)

Generated by dwww version 1.16 on Tue Dec 16 05:46:42 CET 2025.