OS Manuals

/usr/bin/top

utilities for monitor processes on a system

From procps 4.0.7-r3 (os), captured 2026-11-05 by running top --help (exit 0). permalink

Usage:
 top [options]

Options:
 -A, --apply-defaults            if present, ignore config file(s)
 -b, --batch-mode                run in non-interactive batch mode
 -c, --cmdline-toggle            reverse last remembered 'c' state
 -d, --delay =SECS [.TENTHS]     iterative delay as SECS [.TENTHS]
 -E, --scale-summary-mem =SCALE  set mem as: k,m,g,t,p,e for SCALE
 -e, --scale-task-mem =SCALE     set mem with: k,m,g,t,p for SCALE
 -H, --threads-show              show tasks plus all their threads
 -i, --idle-toggle               reverse last remembered 'i' state
 -n, --iterations =NUMBER        exit on maximum iterations NUMBER
 -O, --list-fields               output all field names, then exit
 -o, --sort-override =FIELD      force sorting on this named FIELD
 -p, --pid =PIDLIST              monitor only the tasks in PIDLIST
 -S, --accum-time-toggle         reverse last remembered 'S' state
 -s, --secure-mode               run with secure mode restrictions
 -U, --filter-any-user =USER     show only processes owned by USER
 -u, --filter-only-euser =USER   show only processes owned by USER
 -w, --width [=COLUMNS]          change print width [,use COLUMNS]
 -1, --single-cpu-toggle         reverse last remembered '1' state

 -h, --help                      display this help text, then exit
 -V, --version                   output version information & exit

For more details see top(1).
Options (20)
OptionDescriptionSource
-A, --apply-defaultsRun top with build defaults only, ignoring all configuration files except /etc/toprc.help + man
-b, --batch-mode, --batchStarts top in Batch mode, which could be useful for sending output from top to other programs or to a file.help + man
-c, --cmdline-toggleStarts top with the last remembered ‘c’ state reversed.help + man
-d, --delay SECSiterative delay as SECS [.TENTHS]help
-E, --scale-summary-mem SCALEInstructs top to force summary area memory to be scaled as:help + man
-e, --scale-task-mem SCALEInstructs top to force task area memory to be scaled as:help + man
-H, --threads-showInstructs top to display individual threads.help + man
-i, --idle-toggleStarts top with the last remembered ‘i’ state reversed.help + man
-n, --iterations NUMBERSpecifies the maximum number of iterations, or frames, top should produce before ending.help + man
-O, --list-fieldsThis option acts as a form of help for the -o option shown below.help + man
-o, --sort-override FIELDSpecifies the name of the field on which tasks will be sorted, independent of what is reflected in the configuration file.help + man
-p, --pid PIDLISTmonitor only the tasks in PIDLISThelp + man
-S, --accum-time-toggleStarts top with the last remembered ‘S’ state reversed.help + man
-s, --secure-modeStarts top with secure mode forced, even for root.help + man
-U, --filter-any-user USERDisplay only processes with a user id or user name matching that given.help + man
-u, --filter-only-euser USERDisplay only processes with a user id or user name matching that given.help + man
-w, --width COLUMNSchange print width [,use COLUMNS]help
-1, --single-cpu-toggleStarts top with the last remembered Cpu States portion of the summary area reversed.help + man
-h, --helpDisplay usage help text, then quit.help + man
-V, --versionDisplay version information, then quit.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.