OS Manuals

/usr/bin/atopsar

advanced interactive monitor for Linux systems

From atop 2.13.0-r2 (os), captured 2026-11-05 by running atopsar --help (exit 1). permalink

/usr/bin/atopsar: invalid option -- '-'
Usage: /usr/bin/atopsar [-flags] [-r file|-|date|y...] [-R cnt] [-b time] [-e time]
		or
Usage: /usr/bin/atopsar [-flags] interval [samples]

	Today's atop logfile is used by default!

	Generic flags:
	  -r  read statistical data from specific atop logfile
	      (pathname, - for stdin, date in format YYYYMMDD, or y[y..])
	  -R  summarize <cnt> samples into one sample
	  -b  begin  showing data from  specified time as [YYYYMMDD]hhmm[ss]
	  -e  finish showing data after specified time as [YYYYMMDD]hhmm[ss]
	  -S  print timestamp on every line in case of more resources
	  -x  never  use colors to indicate overload (default: only if tty)
	  -C  always use colors to indicate overload (default: only if tty)
	  -M  use markers to indicate overload (* = critical, + = almost)
	  -H  repeat report headers (in case of tty: depending on screen lines)
	  -a  print all resources, even when inactive

	Specific flags to select reports:
	  -A  print all available reports
	  -c  cpu utilization
	  -p  process(or) load
	  -P  processes & threads
	  -g  gpu utilization
	  -m  memory & swapspace
	  -s  swap rate
	  -B  pressure stall info (PSI)
	  -l  logical volume activity
	  -f  multiple device activity
	  -d  disk activity
	  -h  infiniband utilization
	  -n  NFS client mounts
	  -j  NFS client activity
	  -J  NFS server activity
	  -i  net-interf (general)
	  -I  net-interf (errors)
	  -w  ip   v4    (general)
	  -W  ip   v4    (errors)
	  -y  icmp v4    (general)
	  -Y  icmp v4    (per type)
	  -u  udp  v4
	  -z  ip   v6    (general)
	  -Z  ip   v6    (errors)
	  -k  icmp v6    (general)
	  -K  icmp v6    (per type)
	  -U  udp  v6
	  -t  tcp        (general)
	  -T  tcp        (errors)
	  -O  top-3 processes cpu
	  -G  top-3 processes memory
	  -D  top-3 processes disk
	  -N  top-3 processes network

Please refer to the man-page of 'atopsar' for more details.
Options (43)
OptionDescriptionSource
-rread statistical data from specific atop logfile (pathname, - for stdin, date in format YYYYMMDD, or y[y..])help
-Rsummarize <cnt> samples into one samplehelp + man
-bbegin showing data from specified time as [YYYYMMDD]hhmm[ss]help
-efinish showing data after specified time as [YYYYMMDD]hhmm[ss]help
-SBy default the timestamp at the beginning of a line is suppressed if more lines are shown for one interval.help + man
-xBy default atopsar only uses colors if output is directed to a terminal (window).help + man
-CBy default atopsar only uses colors if output is directed to a terminal (window).help + man
-MUse markers at the end of a line to indicate that a critical occupation percentage has been reached ('') or has been almost reached ('+') for particular resources.help + man
-Hrepeat report headers (in case of tty: depending on screen lines)help + man
-aBy default certain resources as disks and network interfaces are only shown when they were active during the interval.help + man
-Aprint all available reportshelp + man
-cReport about CPU utilization (in total and per cpu).help + man
-pReport about processor-related matters, like load-averages and hardware interrupts.help + man
-PReport about processes.help + man
-gReport about GPU utilization (per GPU).help + man
-mCurrent memory- and swap-occupation.help + man
-sReport about paging- and swapping-activity, and overcommitment.help + man
-BReport about Pressure Stall Information (PSI).help + man
-lReport about utilization of logical volumes.help + man
-fReport about utilization of multiple devices.help + man
-dReport about utilization of disks.help + man
-hReport about Infiniband utilization.help + man
-nReport about NFS mounted filesystems on NFS client.help + man
-jReport about NFS client activity.help + man
-JReport about NFS server activity.help + man
-iReport about the network interfaces.help + man
-IReport about errors for network-interfaces.help + man
-wReport about IP version 4 network traffic.help + man
-WReport about errors for IP version 4 traffic.help + man
-yGeneral report about ICMP version 4 layer activity.help + man
-YPer-type report about ICMP version 4 layer activity.help + man
-uReport about UDP version 4 network traffic.help + man
-zReport about IP version 6 network traffic.help + man
-ZReport about errors for IP version 6 traffic.help + man
-kGeneral report about ICMP version 6 layer activity.help + man
-KPer-type report about ICMP version 6 layer activity.help + man
-UReport about UDP version 6 network traffic.help + man
-tReport about TCP network traffic.help + man
-TReport about errors for TCP-traffic.help + man
-OReport about top-3 processes consuming most processor capacity.help + man
-GReport about top-3 processes consuming most resident memory.help + man
-DReport about top-3 processes issuing most disk transfers.help + man
-NReport about top-3 processes issuing most IPv4/IPv6 socket transfers.help + 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.