f2db09b148
Fix the behaviour for atomic top where if you want to include additional fields to monitor, you now specificy one field per -o switch. For example: atomic top -o ppid -o time Closes: #780 Approved by: baude
1.7 KiB
% ATOMIC(1) Atomic Man Pages % Brent Baude % December 2015
NAME
atomic-top - Run a top-like list of active container processes
SYNOPSIS
atomic top [-h|--help] [-d][-o, --optional=[time, stime, ppid, uid, gid, user, group]][-n] [Containers to monitor]
DESCRIPTION
Atomic top displays an interactive, top-like view of the processes running in active containers.
While in the interactive view, you can sort the columns of information by pressing a single character that correlates to the column header. Any column that you can sort on will have a set of parentheses that surround a single character. For example, if you want to sort by the '(P)ID' column, simply press the 'p' key.
Like top, you can exit the interactive view and return to the command line, use the 'q' character key.
OPTIONS
-h --help Print usage statement
-d Define the interval in seconds on which you want to refresh the process information. The interval should be an integer greater than 0. The default interval is set to 1.
-n The number of iterations. Must be greater than 0.
-o --optional Add more fields of data to collect for each process. The fields resemble fields commonly used by ps -o. They currently are: [time, stime, ppid, uid, gid, user, group]
Specify one option per -o flag to include the fields.
EXAMPLES
Monitor processes with default fields.
atomic top
Monitor processes with default fields on a 5 second interval for 3 iterations
atomic top -d 5 -n 3
Monitor processes and add in the data for the parent PIDs and UID.
atomic top -o ppid -o uid
HISTORY
December 2015, Originally written by Brent Baude (bbaude at redhat dot com)