PSTAT(8) GENIX Programmer's Manual PSTAT(8)
NAME
pstat - print system facts
SYNOPSIS
/etc/pstat [ -aixptufT ] [ suboptions ] [ file ]
DESCRIPTION
Pstat interprets the contents of certain system tables. If file is
given, the tables are sought there; otherwise they are sought in
/dev/kmem. The required namelist is taken from /vmunix. Options
are
-a Under -p or -x, describe all process (or text) slots rather
than just active ones.
-i Print the inode table with the these headings:
LOC The core location of this table entry.
FLAGS Miscellaneous state variables encoded thus:
L locked
U update time (filsys(5)) must be corrected
A access time must be corrected
M file system is mounted here
W wanted by another process (L flag is on)
T contains a text file
C changed time must be corrected
P contains a pipe
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.
-x Print the shared text portion of the special page table with
these headings:
SPTI The index into the spt table.
LOC The address of this table entry.
FLAGS Miscellaneous state variables encoded thus:
I text being initialized or deleted
W some process waiting for text
D no further access allowed (unused)
X resident set size is too big
RSS Resident set size - the number of physical pages allocated to
this text segment.
TRSS Text resident set size - the number of physical pages allo-
cated which are read-only.
Printed 11/16/83 1
PSTAT(8) GENIX Programmer's Manual PSTAT(8)
SIZE Virtual size of text segment, in pages.
PTPGS Number of pages in use as page tables for this text segment.
PROCS Number of processes using this text segment.
SHARE Number of pages of processes which map to pages of this text
segment.
IPTR Address of corresponding inode.
PTE1 Address of level 1 page table.
AGE Age counter. More recently used texts have higher numbers.
-p Print process table for active processes with these headings:
LOC The core location of this table entry.
S Run state encoded thus:
0 no process
1 waiting for some event
3 runnable
4 being created
5 being terminated
6 stopped under trace
F Miscellaneous state variables, or-ed together (hexadecimal):
000001 loaded
000002 a system process
000004 locked for swap out
000008 swapped out
000010 traced
000020 used in tracing
000040 process resulted from a vfork(2).
000080 process used some new signal primitives, i.e. sig-
set(3); more system calls will restart.
000100 a parent of this process has exited and this process
is now considered detached.
000200 exiting
000400 in page-wait
001000 process has exceeded its cputime limit and is running
on grace time; see vlimit(2).
PRI Scheduling priority, see nice(2).
SIGNAL
Signals received (signals 1-32 coded in bits 0-31),
UID Real user ID.
SLP Amount of time process has been blocked.
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.
RSS Resident set size - the number of physical pages allocated to
this process.
SRSS RSS at last swap (0 if never swapped).
SIZE Virtual size of process image (data+stack) in multiples of
1024 bytes.
Printed 11/16/83 2
PSTAT(8) GENIX Programmer's Manual PSTAT(8)
WCHAN Wait channel number of a waiting process.
LINK Link pointer in list of runnable processes.
SPTI Index of the SPT table entry for this process.
PTE1 Address of level 1 page table for this process.
CLKT Countdown for alarm(2) measured in seconds.
-t Print table for terminals 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 tty(4).
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:
T delay timeout in progress
W waiting for open to complete
O open
C carrier is on
B busy doing output
A process is awaiting output
X open for exclusive use
H hangup on close
PGRP Process group for which this is controlling terminal.
DISC Line discipline; blank is old tty OTTYDISC or ``ntty'' for
NTTYDISC.
-u Print information about a user process; the next argument is
its pid as given by ps(1).
-f Print the open file table with these headings:
LOC The core location of this table entry.
FLG Miscellaneous state variables encoded thus:
R open for reading
W open for writing
P pipe
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).
-s Print information about swap space usage: the number of pages
used and free is given.
-T Print the number of used and free slots in the several system
tables. This is useful for checking to see how full system
tables have become if the system is under heavy load.
FILES
/vmunix namelist
/vmsymbols namelist used when file not given
Printed 11/16/83 3
PSTAT(8) GENIX Programmer's Manual PSTAT(8)
/dev/kmem default source of tables
SEE ALSO
ps(1), stat(2), filsys(5)
K. Thompson, UNIX Implementation
BUGS
It would be very useful if the system recorded "maximum occupancy"
on the tables reported by -T; even more useful if these tables were
dynamically allocated.
Printed 11/16/83 4