PSTAT(8) PSTAT(8)
NAME
pstat - print system facts
SYNOPSIS
/etc/pstat [ -afipstuxT ] [ suboptions ] [ file ] [ namelist
]
DESCRIPTION
Pstat interprets the contents of certain system tables. If
file is given, the tables are sought there, otherwise in The
required namelist is taken from namelist, default Options
are
-a Under -p, describe all process 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 modified time (filsys(5)) must be cor-
rected
A access time must be corrected
O file was opened
W wanted by another process (L flag is on)
T contains an active text
CNT Number of active references to this inode.
FS File system type, see fmount(2).
DEVICE Device number of file system in which this
inode resides.
INO I-number within the file system.
MODE Mode, see stat(2).
NLN Number of links to this inode.
UID Userid of owner.
SPTR Core location of corresponding stream header, 0
if this is not a stream.
SIZ/DEV Number of bytes in an ordinary file, or device
number of a special file.
MROOT Core location of root inode of file system
mounted here, 0 if none.
-x Print the text table with these headings:
LOC The core location of this table entry.
FLAGS Miscellaneous state variables encoded thus:
P resulted from demand-page-from-inode exec
format, see exec(2)
T traced through proc(4)
W text not yet written to swap device
L loading in progress
K locked
PSTAT(8) PSTAT(8)
w wanted (L flag is on)
DADDR Disk address in swap, in multiples of 512
bytes.
CADDR Head of a linked list of loaded processes using
this text segment.
RSS Size of physical memory occupied by text seg-
ment, in multiples of 512 bytes.
SIZE Size of text segment, in multiples of 512
bytes.
IPTR Core location of corresponding inode.
CNT Number of processes using this text segment.
CCNT Number of processes in core using this text
segment.
-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):
0000001 loaded in memory
0000002 special system process (swapper or
pager)
0000004 being swapped out
0000008 obscure swapout flag
0000010 traced
0000020 used in tracing
0000040 locked in core
0000080 waiting for pagein
0000100 prevented from swapping during fork(2)
0000200 gathering pages for raw i/o
0000400 exiting
0008000 associated text is demand paged from
file
0030000 anomalous paging behaviour expected,
see vlimit in deprecated(2)
0040000 in a sleep which will time out
0400000 in select(2)
0800000 traced via proc(4)
1000000 i/o via proc in progress
2000000 stop on exec
4000000 wanted by proc after pagein
ADDR The core location of the page table entry for
the first page of the `u-area.'
PRI Scheduling priority; smaller numbers run first.
PSTAT(8) PSTAT(8)
SIG Signals received; signals 1-32 coded in bits
0-31.
UID Real userid.
SLP Time blocked in seconds; times over 127 coded
as 127.
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 group number.
PID Process ID number.
PPID Process ID of parent process.
RSS Number of physical page frames allocated to
this process.
SRSS RSS at last swap, 0 if never swapped.
SIZE Virtual size of process image (data+stack) in
multiples of 512 bytes.
WCHAN Event address if waiting.
LINK Pointer to next entry in list of runnable pro-
cesses.
TEXTP If text is pure, pointer to location of text
table entry.
CLKT Countdown for alarm(2) measured in seconds.
-u Print information about a user process; the next argu-
ment is its address as given by `ADDR' under -p above.
The process must be in main memory, or the file used
can be a core image (core(5)) and the address 0.
-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
CNT Number of processes that know this open file.
INO The core 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
1024 byte pages used and free, and the number of pages
belonging to text images.
-T Print the number of used and free slots in several sys-
tem tables; useful to see if they are nearly full.
FILES
namelist
default source of tables
SEE ALSO
ps(1), stat(2), filsys(5)
PSTAT(8) PSTAT(8)
M. J. Bach, The Design of the UNIX Operating System,
Prentice-Hall, 1986
BUGS
This program is never up to date.