NAME

pstat − print system facts

SYNOPSIS

pstat [ −aixptuf ] [ suboptions ] [ file ]

DESCRIPTION

Pstat interprets the contents of certain system tables.  If file is given, the tables are sought there, otherwise in /dev/mem.  The required namelist is taken from /unix.  Options are:

-aUnder −p, describe all process slots rather than just active ones. 

-iPrint the inode table with these headings:

LOC The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus:

Llocked

Uupdate time fs(4) must be corrected

Aaccess time must be corrected

Mfile system is mounted here

Wwanted by another process (L flag is on)

Tcontains a text file

Cchanged time must be corrected

CNT Number of open file table entries for this inode. 

DEV Major and minor device number of file system in which this inode resides. 

INO I-number within the device. 

MODE Mode bits, see chmod(2).

NLK Number of links to this inode. 

UID User ID of owner. 

SIZ/DEV Number of bytes in an ordinary file, or major and minor device of special file. 

-xPrint the text table with these headings:

LOC The core location of this table entry. 

FLAGS Miscellaneous state variables encoded thus:

Tptrace(2) in effect

Wtext not yet written on swap device

Lloading in progress

Klocked

wwanted (L flag is on)

DADDR Disk address in swap, measured in multiples of 512 bytes. 

CADDR Core address, measured in multiples of core clicks (machine dependent). 

SIZE Size of text segment, measured in multiples of core clicks (machine dependent). 

IPTR Core location of corresponding inode. 

CNT Number of processes using this text segment. 

CCNT Number of processes in core using this text segment. 

-pPrint process table for active processes with these headings:

LOC The core location of this table entry. 

S Run state encoded thus:

0no process

1waiting for some event

3runnable

4being created

5being terminated

6stopped under trace

F Miscellaneous state variables, or-ed together:

01loaded

02the scheduler process

04locked

010swapped out

020traced

040used in tracing

PRI Scheduling priority, see nice(2).

SIGNAL Signals received (signals 1-16 coded in bits 0-15),

UID Real user ID. 

TIM Time resident in seconds; times over 127 coded as 127. 

CPU Weighted integral of CPU time, for scheduler. 

NI Nice level, see nice(2).

PGRP Process number of root of process group (the opener of the controlling terminal). 

PID The process ID number. 

PPID The process ID of parent process. 

ADDR If in core, the physical address of the "u-area" of the process measured in multiples of 64 bytes.  If swapped out, the position in the swap area measured in multiples of 512 bytes. 

SIZE Size of process image in multiples of 64 bytes. 

WCHAN Wait channel number of a waiting process. 

LINK Link pointer in list of runnable processes. 

TEXTP If text is pure, pointer to location of text table entry. 

CLKT Countdown for alarm(2) measured in seconds.

-tPrint table for terminals (only DH11 and DL11 handled) with these headings:

RAW Number of characters in raw input queue. 

CAN Number of characters in canonicalized input queue. 

OUT Number of characters in output queue. 

MODE See termio(7).

ADDR Physical device address. 

DEL Number of delimiters (newlines) in canonicalized input queue. 

COL Calculated column position of terminal. 

STATE Miscellaneous state variables encoded thus:

Wwaiting for open to complete

Oopen

Shas special (output) start routine

Ccarrier is on

Bbusy doing output

Aprocess is awaiting output

Xopen for exclusive use

Hhangup on close

PGRP Process group for which this is controlling terminal. 

-uprint information about a user process; the next argument is its address as given by ps(1). The process must be in main memory, or the file used can be a core image and the address 0.

-fPrint the open file table with these headings:

LOC The core location of this table entry. 

FLG Miscellaneous state variables encoded thus:

Ropen for reading

Wopen for writing

Ppipe

CNT Number of processes that know this open file. 

INO The location of the inode table entry for this file. 

OFFS The file offset, see lseek(2).

FILES

/unixnamelist
/dev/memdefault source of tables

EXAMPLE

pstat -i

displays all the active inodes in a table format with headings. 

SEE ALSO

ps(1), stat(2), fs(4)
UNIX Implementation, by K. Thompson. 

Version 2.1  —  January 02, 1985