1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
.TH PSRECORD "1" "November 2025" "psrecord 1.4-3" "User Commands"
.SH NAME
psrecord \- A small utility that records the CPU and memory activity of a process. Can also output results to a plot.
.SH DESCRIPTION
usage: psrecord [\-h] [\-\-log LOG] [\-\-log\-format LOG_FORMAT] [\-\-plot PLOT]
.IP
[\-\-duration DURATION] [\-\-interval INTERVAL]
[\-\-include\-children] [\-\-include\-io]
process_id_or_command
.PP
Record CPU and memory usage for a process
.SS "positional arguments:"
.TP
process_id_or_command
the process id or command.
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-\-log\fR LOG
output the statistics to a file. If neither \fB\-\-log\fR nor
\fB\-\-plot\fR are specified, print to print to standard
output.
.TP
\fB\-\-log\-format\fR LOG_FORMAT
the format of the log file, can be one of "plain" or
"csv"
.TP
\fB\-\-plot\fR PLOT
output the statistics to a plot.
.TP
\fB\-\-duration\fR DURATION
how long to record for (in seconds). If not specified,
the recording is continuous until the job exits.
.TP
\fB\-\-interval\fR INTERVAL
how long to wait between each sample (in seconds). By
default the process is sampled as often as possible. Note that
very short intervals might interfere with accuracy because of
psrecord overhead itself.
.TP
\fB\-\-include\-children\fR
include sub\-processes in statistics (results in a
slower maximum sampling rate).
.TP
\fB\-\-include\-io\fR
include include_io I/O stats
|
