OS Manuals

/usr/bin/pidstat

Performance monitoring tools

From sysstat 12.8.0-r0 (os), captured 2026-11-05 by running pidstat --help (exit 1). permalink

Usage: /usr/bin/pidstat [ options ] [ <interval> [ <count> ] ] [ -e <program> <args> ]
Options are:
[ -d ] [ -H ] [ -h ] [ -I ] [ -l ] [ -R ] [ -r ] [ -s ] [ -t ] [ -U [ <username> ] ]
[ -u ] [ -V ] [ -v ] [ -w ] [ -C <command> ] [ -G <process_name> ]
[ -p { <pid> [,...] | SELF | ALL } ] [ -T { TASK | CHILD | ALL } ]
[ --dec={ 0 | 1 | 2 } ] [ --human ] [ -o JSON ]
Options (20)
OptionDescriptionSource
-C commDisplay only tasks whose command name includes the string comm.man
-dReport I/O statistics (kernels 2.6.20 and later only).man
--decSpecify the number of decimal places to use (0 to 2, default value is 2).man
-e programExecute program with given arguments args and monitor it with pidstat.man
-G process_nameDisplay only processes whose command name includes the string process_name.man
-HDisplay timestamp in seconds since the epoch.man
-hDisplay all activities horizontally on a single line, with no average statistics at the end of the report.man
--humanPrint sizes in human readable format (e.g. 1.0k, 1.2M, etc.) The units displayed with this option supersede any other default units (e.g. kibibytes, sectors...) associated with the metrics.man
-IIn an SMP environment, indicate that tasks CPU usage (as displayed by option -u) should be divided by the total number of processors.man
-lDisplay the process command name and all its arguments.man
-o JSONDisplay the statistics in JSON (JavaScript Object Notation) format.man
-RReport realtime priority and scheduling policy information.man
-rReport page faults and memory utilization.man
-sReport stack utilization.man
-TThis option specifies what has to be monitored by the pidstat command.man
-tAlso display statistics for threads associated with selected tasks.man
-uReport CPU utilization.man
-VPrint version number then exit.man
-vReport values of some kernel tables.man
-wReport task switching activity (kernels 2.6.23 and later only).man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.