Annotation of researchv10dc/man/adm/man8/pstat.8, revision 1.1.1.1

1.1       root        1: .TH PSTAT 8
                      2: .CT 1 sa_mortals
                      3: .SH NAME
                      4: pstat \- print system facts
                      5: .SH SYNOPSIS
                      6: .B /etc/pstat
                      7: [
                      8: .B \-afipstuxT
                      9: ]
                     10: [
                     11: .I suboptions
                     12: ]
                     13: [
                     14: .I file
                     15: ]
                     16: [
                     17: .I namelist
                     18: ]
                     19: .SH DESCRIPTION
                     20: .I Pstat
                     21: interprets the contents of certain system tables.
                     22: If
                     23: .I file
                     24: is given, the tables are sought there, otherwise
                     25: in
                     26: .FR /dev/kmem .
                     27: The required namelist is taken from
                     28: .IR namelist ,
                     29: default
                     30: .FR /unix .
                     31: Options are
                     32: .TP 
                     33: .B -a
                     34: Under
                     35: .BR -p ,
                     36: describe all process slots rather than just active ones.
                     37: .TP
                     38: .B -i
                     39: Print the inode table with the these headings:
                     40: .RS
                     41: .PD 0
                     42: .TF SIGNAL
                     43: .TP
                     44: .B LOC
                     45: The core location of this table entry.
                     46: .TP
                     47: .B FLAGS
                     48: Miscellaneous state variables encoded thus:
                     49: .RS
                     50: .TP
                     51: .B L
                     52: locked
                     53: .TP
                     54: .B U
                     55: modified time
                     56: .RI ( filsys (5))
                     57: must be corrected
                     58: .TP
                     59: .B A
                     60: access time must be corrected
                     61: .TP
                     62: .B O
                     63: file was opened
                     64: .TP
                     65: .B W
                     66: wanted by another process 
                     67: .RB ( L
                     68: flag is on)
                     69: .TP
                     70: .B T
                     71: contains an active text
                     72: .RE
                     73: .TP
                     74: .B CNT
                     75: Number of active references to this inode.
                     76: .TP
                     77: .B FS
                     78: File system type, see
                     79: .IR fmount (2).
                     80: .TP
                     81: .B DEVICE
                     82: Device number of file system in which
                     83: this inode resides.
                     84: .TP
                     85: .B INO
                     86: I-number within the file system.
                     87: .TP
                     88: .B MODE
                     89: Mode, see
                     90: .IR stat (2).
                     91: .TP
                     92: .B NLN
                     93: Number of links to this inode.
                     94: .TP
                     95: .B UID
                     96: Userid of owner.
                     97: .TP
                     98: .B SPTR
                     99: Core location of corresponding stream header,
                    100: 0 if this is not a stream.
                    101: .TP
                    102: .B SIZ/DEV
                    103: Number of bytes in an ordinary file, or
                    104: device number of a special file.
                    105: .TP
                    106: .B MROOT
                    107: Core location of root inode
                    108: of file system mounted here,
                    109: 0 if none.
                    110: .PD
                    111: .RE
                    112: .TP 0
                    113: .B -x
                    114: Print the text table with these headings:
                    115: .PD 0
                    116: .RS
                    117: .TF SIGNAL
                    118: .TP
                    119: .B LOC
                    120: The core location of this table entry.
                    121: .TP
                    122: .B FLAGS
                    123: Miscellaneous state variables encoded thus:
                    124: .RS
                    125: .TP
                    126: .B P
                    127: resulted from demand-page-from-inode exec format, see
                    128: .IR exec (2)
                    129: .TP
                    130: .B T
                    131: traced through
                    132: .IR proc (4)
                    133: .TP
                    134: .B W
                    135: text not yet written to swap device
                    136: .TP
                    137: .B L
                    138: loading in progress
                    139: .TP
                    140: .B K
                    141: locked
                    142: .TP
                    143: .B w
                    144: wanted 
                    145: .RB ( L
                    146: flag is on)
                    147: .RE
                    148: .TP
                    149: .B DADDR
                    150: Disk address in swap, in multiples of 512 bytes.
                    151: .TP
                    152: .B CADDR
                    153: Head of a linked list of loaded processes using this text segment.
                    154: .TP
                    155: .B RSS
                    156: Size of physical memory occupied
                    157: by text segment,
                    158: in multiples of 512 bytes.
                    159: .TP
                    160: .B SIZE
                    161: Size of text segment, in multiples of 512 bytes.
                    162: .TP
                    163: .B IPTR
                    164: Core location of corresponding inode.
                    165: .TP
                    166: .B CNT
                    167: Number of processes using this text segment.
                    168: .TP
                    169: .B CCNT
                    170: Number of processes in core using this text segment.
                    171: .PD
                    172: .RE
                    173: .TP 0
                    174: .B -p
                    175: Print process table for active processes with these headings:
                    176: .RS
                    177: .TP
                    178: .B LOC
                    179: The core location of this table entry.
                    180: .PD 0
                    181: .TF SIGNAL
                    182: .TP
                    183: .B S
                    184: Run state encoded thus:
                    185: .RS
                    186: .TP
                    187: .B 0
                    188: no process
                    189: .TP
                    190: .B 1
                    191: waiting for some event
                    192: .TP
                    193: .B 3
                    194: runnable
                    195: .TP
                    196: .B 4
                    197: being created
                    198: .TP
                    199: .B 5
                    200: being terminated
                    201: .TP
                    202: .B 6
                    203: stopped under trace
                    204: .RE
                    205: .TP
                    206: .B F
                    207: Miscellaneous state variables, or-ed together (hexadecimal):
                    208: .RS
                    209: .TF SIGNAL
                    210: .TP
                    211: .B 0000001
                    212: loaded in memory
                    213: .TP
                    214: .B 0000002
                    215: special system process (swapper or pager)
                    216: .TP
                    217: .B 0000004
                    218: being swapped out
                    219: .TP
                    220: .B 0000008
                    221: obscure swapout flag
                    222: .TP
                    223: .B 0000010
                    224: traced
                    225: .TP
                    226: .B 0000020
                    227: used in tracing
                    228: .TP
                    229: .B 0000040
                    230: locked in core
                    231: .TP
                    232: .B 0000080
                    233: waiting for pagein
                    234: .TP
                    235: .B 0000100
                    236: prevented from swapping during
                    237: .IR fork (2)
                    238: .TP
                    239: .B 0000200
                    240: gathering pages for raw i/o
                    241: .TP
                    242: .B 0000400
                    243: exiting
                    244: .TP
                    245: .B 0008000
                    246: associated text is demand paged from file
                    247: .TP
                    248: .B 0030000
                    249: anomalous paging behaviour expected,
                    250: see
                    251: .IR vlimit
                    252: in
                    253: .IR deprecated (2)
                    254: .TP
                    255: .B 0040000
                    256: in a sleep which will time out
                    257: .TP
                    258: .B 0400000
                    259: in
                    260: .IR select (2)
                    261: .TP
                    262: .B 0800000
                    263: traced via
                    264: .IR proc (4)
                    265: .TP
                    266: .B 1000000
                    267: i/o via
                    268: .IR proc
                    269: in progress
                    270: .TP
                    271: .B 2000000
                    272: stop on exec
                    273: .TP
                    274: .B 4000000
                    275: wanted by
                    276: .I proc
                    277: after pagein
                    278: .RE
                    279: .TF SIGNAL
                    280: .TP
                    281: .B ADDR
                    282: The core location of the page table entry for the first page of the `u-area.'
                    283: .TP
                    284: .B PRI
                    285: Scheduling priority;
                    286: smaller numbers run first.
                    287: .TP
                    288: .B SIG
                    289: Signals received; signals 1-32 coded in bits 0-31.
                    290: .TP
                    291: .B UID
                    292: Real userid.
                    293: .TP
                    294: .B SLP
                    295: Time blocked in seconds;
                    296: times over 127 coded as 127.
                    297: .TP
                    298: .B TIM
                    299: Time resident in seconds;
                    300: times over 127 coded as 127.
                    301: .TP
                    302: .B CPU
                    303: Weighted integral of CPU time, for scheduler.
                    304: .TP
                    305: .B NI
                    306: Nice level,
                    307: see
                    308: .IR nice (2).
                    309: .TP
                    310: .B PGRP
                    311: Process group number.
                    312: .TP
                    313: .B PID
                    314: Process ID number.
                    315: .TP
                    316: .B PPID
                    317: Process ID of parent process.
                    318: .TP
                    319: .B RSS
                    320: Number of physical page frames allocated
                    321: to this process.
                    322: .TP
                    323: .B SRSS
                    324: RSS at last swap, 0 if never swapped.
                    325: .TP
                    326: .B SIZE
                    327: Virtual size of process image (data+stack) in multiples of 512 bytes.
                    328: .TP
                    329: .B WCHAN
                    330: Event address if waiting.
                    331: .TP
                    332: .B LINK
                    333: Pointer to next entry in list of runnable processes.
                    334: .TP
                    335: .B TEXTP
                    336: If text is pure, pointer to location of text table entry.
                    337: .TP
                    338: .B CLKT
                    339: Countdown for
                    340: .IR alarm (2)
                    341: measured in seconds.
                    342: .PD
                    343: .RE
                    344: .TP 0
                    345: .B -u
                    346: Print information about a user process;
                    347: the next argument is its address as given
                    348: by
                    349: .L ADDR
                    350: under
                    351: .B -p
                    352: above.
                    353: The process must be in main memory, or the file used can
                    354: be a core image
                    355: .RI ( core (5))
                    356: and the address 0.
                    357: .TP
                    358: .B -f
                    359: Print the open file table with these headings:
                    360: .PD0
                    361: .RS
                    362: .TF SIGNAL
                    363: .TP
                    364: .B LOC
                    365: The core location of this table entry.
                    366: .PD 0
                    367: .TP
                    368: .B FLG
                    369: Miscellaneous state variables encoded thus:
                    370: .RS
                    371: .TP
                    372: .B R
                    373: open for reading
                    374: .TP
                    375: .B W
                    376: open for writing
                    377: .RE
                    378: .TP
                    379: .B CNT
                    380: Number of processes that know this open file.
                    381: .TP
                    382: .B INO
                    383: The core location of the inode table entry for this file.
                    384: .TP
                    385: .B OFFS
                    386: The file offset, see
                    387: .IR lseek (2).
                    388: .PD
                    389: .RE
                    390: .TP 0
                    391: .B -s
                    392: Print information about swap space usage:
                    393: the number of 1024 byte pages used
                    394: and free,
                    395: and the number of pages belonging
                    396: to text images.
                    397: .TP
                    398: .B -T
                    399: Print the number of used and free slots in several system tables;
                    400: useful to see if they are nearly full.
                    401: .SH FILES
                    402: .TF /dev/kmem
                    403: .TP
                    404: .F /unix
                    405: namelist
                    406: .TP
                    407: .F /dev/kmem
                    408: default source of tables
                    409: .SH SEE ALSO
                    410: .IR ps (1),
                    411: .IR stat (2), 
                    412: .IR filsys (5)
                    413: .br
                    414: M. J. Bach,
                    415: .IR "The Design of the UNIX Operating System" ,
                    416: Prentice-Hall, 1986
                    417: .SH BUGS
                    418: This program is never up to date.

unix.superglobalmegacorp.com

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