Specifies the maximum number of iterations, or frames, top should produce before ending.
-O, --list‐fields
This option acts as a form of help for the -o option shown below. It will cause top to print each of the available field names on a separate line, then quit. Such names are subject to NLS (National Language
Support) translation.
-o, --sort‐override = FIELDNAME
Specifies the name of the field on which tasks will be sorted, independent of what is reflected in the configuration file. You can prepend a ‘+’ or ‘-’ to the field name to also override the sort direction. A
leading ‘+’ will force sorting high to low, whereas a ‘-’ will ensure a low to high ordering.
This option exists primarily to support automated/scripted batch mode operation.
-p, --pid = PIDLIST (as: 1,2,3, ... or ‐p1 ‐p2 ‐p3 ...)
Monitor only processes with specified process IDs. However, when combined with Threads mode (‘H’), all processes in the thread group (see TGID) of each monitored PID will also be shown.
This option can be given up to 20 times, or you can provide a comma delimited list with up to 20 pids. Co‐mingling both approaches is permitted.
A pid value of zero will be treated as the process id of the top program itself once it is running.
This is a command-line option only and should you wish to return to normal operation, it is not necessary to quit and restart top -- just issue any of these interactive commands: ‘=’, ‘u’ or ‘U’.
The ‘p’, ‘u’ and ‘U’ command-line options are mutually exclusive.
-S, --accum‐time‐toggle
Starts top with the last remembered ‘S’ state reversed. When Cumulative time mode is On, each process is listed with the cpu time that it and its dead children have used. See the ‘S’ interactive command for
additional information regarding this mode.
-s, --secure‐mode
Starts top with secure mode forced, even for root. This mode is far better controlled through a system configuration file (see topic 6. FILES).
-U, --filter‐any‐user = USER (as: number or name)
Display only processes with a user id or user name matching that given. This option matches on any user (real, effective, saved, or filesystem).
Prepending an exclamation point (‘!’) to the user id or name instructs top to display only processes with users not matching the one provided.
The ‘p’, ‘U’ and ‘u’ command-line options are mutually exclusive.
-u, --filter‐only‐euser = USER (as: number or name)
Display only processes with a user id or user name matching that given. This option matches on the effective user id only.
Prepending an exclamation point (‘!’) to the user id or name instructs top to display only processes with users not matching the one provided.
The ‘p’, ‘U’ and ‘u’ command-line options are mutually exclusive.
-V, --version
Display version information, then quit.
-w, --width [=COLUMNS]
In Batch mode, when used without an argument top will format output using the COLUMNS= and LINES= environment variables, if set. Otherwise, width will be fixed at the maximum 512 columns. With an argument, output
width can be decreased or increased (up to 512) but the number of rows is considered unlimited.
In normal display mode, when used without an argument top will attempt to format output using the COLUMNS= and LINES= environment variables, if set. With an argument, output width can only be decreased, not
increased. Whether using environment variables or an argument with -w, when not in Batch mode actual terminal dimensions can never be exceeded.
Note: Without the use of this command-line option, output width is always based on the terminal at which top was invoked whether or not in Batch mode.
-1, --single‐cpu‐toggle