NAME

pstat − print system facts

SYNTAX

pstat [ −aixptuf ] [ suboptions ] [ corefile ] [ namelist ]

DESCRIPTION

The pstat command interprets the contents of certain system tables.  If corefile is given, the tables are sought there, otherwise in /dev/mem.  The required namelist is taken from /unix, unless the optional namelist argument is given.  If the namelist is specified then the corefile must also be specified. 

OPTIONS

−a Under −p, describe all process slots rather than just active ones. 

−i Print the inode table with the these headings:

LOCThe core location of this table entry. 

FLAGSMiscellaneous state variables encoded thus:

LLocked

UUpdate time filsys(5) 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

CNTNumber of open file table entries for this inode. 

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

INOInumber within the device. 

MODEMode bits, see chmod(2). 

NLKNumber of links to this inode. 

UIDUser ID of owner. 

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

−x Print the text table with these headings:

LOCThe core location of this table entry. 

FLAGSMiscellaneous state variables encoded thus:

Tptrace(2) in effect

WText not yet written on swap device

LLoading in progress

KLocked

wWanted (L flag is on)

DADDRDisk address in swap, measured in (decimal) multiples of 512 bytes. 

CADDRCore address, measured in (octal) multiples of 64 bytes. 

SIZESize of text segment, measured in (decimal) multiples of 64 bytes. 

IPTRCore location of corresponding inode. 

CNTNumber of processes using this text segment. 

CCNTNumber of processes in core using this text segment. 

LCNDNumber of locked processes using this text segment. 

−p Print process table for active processes with these headings:

LOCThe core location of this table entry. 

SRun state encoded thus:

0No process

1Waiting for some event

3Runnable

4Being created

5Being terminated

6Stopped under trace

FMiscellaneous state variables, or-ed together:

01Loaded

02The scheduler process

04Locked

010Swapped out

020Traced

040Used in tracing

0100Text locked in by lock(2) or plock(2)

0200Detached inherited by init

0400Using new signal mechanism. 

01000Locked in by lock(2) or plock(2). 

PRIScheduling priority, see nice(2). 

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

UIDReal user ID. 

TIMTime resident in seconds; times over 127 coded as 127. 

CPUWeighted integral of CPU time, for scheduler. 

NINice level, see nice(2). 

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

PIDThe process ID number. 

PPIDThe process ID of parent process. 

ADDRIf in core, the physical address of the ’u-area’ of the process measured in (octal) multiples of 64 bytes.  If swapped out, the position in the swap area measured in (decimal) multiples of 512 bytes. 

SIZEIf in core, size of process image in (decimal) multiples of 64 bytes.  If swapped out, size of the process image in (decimal) 512 byte blocks. 

WCHANWait channel number of a waiting process. 

LINKLink pointer in list of runnable processes. 

TEXTPIf text is pure, pointer to location of text table entry. 

CLKTCountdown for alarm(2) measured in seconds. 

−t Print table for terminals (DH, KL, DL, DZ, and DZV handled) with these headings:

RAWNumber of characters in raw input queue. 

CANNumber of characters in canonicalized input queue. 

OUTNumber of characters in output queue. 

MODESee tty(4). 

ADDRPhysical device address. 

DELNumber of delimiters (newlines) in canonicalized input queue. 

COLCalculated column position of terminal. 

STATEMiscellaneous state variables encoded thus:

TTimeout (carriage return or newline delay processing)

WWaiting for open to complete

OOpen

CCarrier is on

BBusy doing output

AProcess is awaiting output

XOpen for exclusive use

SOutput is stopped by stop character

MBlocked output, tandem mode, see tty(4),

HHangup on close

PGRPProcess group for which this is controlling terminal. 

ERRCNTNumber of errors on the line, since the system was last booted. 

LASTECLast error character, as received on the line.  Character in lo byte, error bits in hi byte. 

Bit 15 - Combined error bit
Bit 14 - Overrun error
Bit 13 - Framing error
Bit 12 - Parity error

For DL and KL all three types of errors are counted.  For DH, DHU/DHV, DZ/DZV, and DZQ, overruns are counted, framing errors are not counted, and parity errors are counted only if parity is enabled. 

−u Print 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. 

−f Print the open file table with these headings:

LOCThe core location of this table entry. 

FLGMiscellaneous state variables encoded thus:

Ropen for reading

Wopen for writing

Dopen with no delay

Aopen for append

Sfile descriptor is a socket

Popen pending (open blocked)

CNTNumber of processes that know this open file. 

INOThe location of the inode table entry for this file. 

OFFSThe file offset, see lseek(2). 

−T Display the number of used and free slots in the system tables. 

−U Display how long the system has been up.  This option is most useful when used with −T to determine the time range for the table listings. 

FILES

/unixdefault namelist
/dev/memdefault source of tables

SEE ALSO

ps(1), stat(2), filsys(5)
ULTRIX-11 System Management Guide
UNIX Implementation