Annotation of researchv10dc/man/man1/ps.1, revision 1.1.1.1

1.1       root        1: .TH PS 1
                      2: .CT 1 proc_man sa_mortals
                      3: .SH NAME
                      4: ps \(mi process status
                      5: .SH SYNOPSIS
                      6: .B ps
                      7: .I option
                      8: \&...
                      9: .SH DESCRIPTION
                     10: .I Ps
                     11: prints information about processes.
                     12: .PP
                     13: For each process reported,
                     14: the process id,
                     15: control terminal,
                     16: status,
                     17: cpu time,
                     18: and command name are printed.
                     19: Status is at least one of the following letters:
                     20: .TP
                     21: .PD 0
                     22: .B R
                     23: Runnable.
                     24: .TP
                     25: .B S
                     26: Asleep for less than 20 seconds.
                     27: .TP
                     28: .B I
                     29: Asleep for 20 seconds or more.
                     30: .TP
                     31: .B P
                     32: Waiting for memory to be paged in.
                     33: .TP
                     34: .B T
                     35: Stopped by a debugger.
                     36: .TP
                     37: .B W
                     38: Swapped out of memory.
                     39: .TP
                     40: .B N
                     41: Positive scheduling priority;
                     42: see
                     43: .IR nice (2).
                     44: .PD
                     45: .PP
                     46: These options modify the report for each process:
                     47: .TP
                     48: .B f
                     49: Print additional lines listing each open file in use by the process.
                     50: .PD 0
                     51: .TP
                     52: .B ff
                     53: Print open files,
                     54: but omit the process id at the beginning of each line.
                     55: .TP
                     56: .B h
                     57: Print column headers.
                     58: .TP
                     59: .B l
                     60: Also print virtual size and current resident size in kilobytes,
                     61: parent process id,
                     62: and wait channel.
                     63: .TP
                     64: .B n
                     65: Don't sort the output.
                     66: .TP
                     67: .B u
                     68: Also print effective userid
                     69: and recent cpu share;
                     70: sort by cpu share
                     71: rather than by process id.
                     72: .PD
                     73: .PP
                     74: By default,
                     75: processes running under the current real userid
                     76: that don't appear to be shells
                     77: are reported.
                     78: These options pick different processes:
                     79: .TP
                     80: .B a
                     81: Report processes running under any userid.
                     82: .PD 0
                     83: .TP
                     84: .BI F file
                     85: Report processes using the named
                     86: .IR file .
                     87: .TP
                     88: .B r
                     89: Report processes with real or effective userid
                     90: matching the current real userid.
                     91: .TP
                     92: .BI t s
                     93: Report processes with controlling terminal
                     94: .IR s .
                     95: .I S
                     96: may be
                     97: .L .
                     98: (the current controlling terminal)
                     99: or one of the abbreviations printed by
                    100: .IR ps ,
                    101: e.g.
                    102: .L 03
                    103: for
                    104: .FR /dev/tty03 ,
                    105: .L dk26
                    106: for
                    107: .FR /dev/dk/dk26 ,
                    108: or
                    109: .L ?
                    110: for processes with no control terminal.
                    111: .TP
                    112: .B x
                    113: Include processes that appear to be shells.
                    114: .TP
                    115: .I num
                    116: Report the process with process id
                    117: .IR num .
                    118: .PD
                    119: .PP
                    120: Multiple
                    121: .BR F ", " t ", and"
                    122: .I num
                    123: options are allowed; the union of all selections is printed.
                    124: .PP
                    125: By default,
                    126: .I ps
                    127: looks for process data in the process file system
                    128: .IR proc (4),
                    129: but reads
                    130: .F /dev/drum
                    131: for information about swapped processes
                    132: (to avoid swapping them in just to look at them)
                    133: and
                    134: .F /dev/kmem
                    135: for information about open files.
                    136: These options cause it to gather information differently:
                    137: .TP
                    138: .B o
                    139: .PD 0
                    140: Ignore
                    141: .IR proc (4);
                    142: read directly from
                    143: .F /dev/mem
                    144: and the swap area.
                    145: Useful mostly in single-user mode
                    146: or when examining a crash dump.
                    147: .TP
                    148: .BI M mem
                    149: Read memory data from
                    150: .IR mem
                    151: instead of
                    152: .F /dev/mem
                    153: or
                    154: .FR /dev/kmem .
                    155: .TP
                    156: .BI D swap
                    157: Read swap data from
                    158: .I swap
                    159: instead of
                    160: .FR /dev/drum .
                    161: .TP
                    162: .BI Nname
                    163: Read symbols from
                    164: .I name
                    165: instead of
                    166: .FR /unix .
                    167: This matters only under
                    168: option
                    169: .BR o .
                    170: .PD
                    171: .PP
                    172: To examine a crash dump,
                    173: use
                    174: .BI "ps oM" dumpfile.
                    175: Option
                    176: .B M
                    177: changes the default swap device to
                    178: .FR /dev/null .
                    179: .SH FILES
                    180: .TF /lib/ttydevs
                    181: .TP
                    182: .F /proc
                    183: process images
                    184: .TP
                    185: .F /dev/drum
                    186: swap device
                    187: .TP
                    188: .F /dev/kmem
                    189: kernel memory
                    190: .TP
                    191: .F /dev/mem
                    192: physical memory
                    193: .TP
                    194: .F /lib/ttydevs
                    195: searched to find tty names
                    196: .TP
                    197: .F /etc/fstab
                    198: searched to find local file system names
                    199: .SH "SEE ALSO"
                    200: .IR kill (1), 
                    201: .IR proc (4), 
                    202: .IR load (1),
                    203: .IR pstat (8)
                    204: .SH BUGS
                    205: Things can change while
                    206: .I ps
                    207: is running.
                    208: .br
                    209: Since
                    210: .I ps
                    211: is usually set-userid,
                    212: filename arguments like that to
                    213: .L -M
                    214: are potential security botches.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.