PSTAT(C) UNIX System V
Name
pstat - reports system information
Syntax
pstat [ -aipf ] [ -u ubase1 ubase2 ] [ -n namelist ] [ file
]
Description
pstat interprets the contents of certain system tables.
pstat searches for these tables in /dev/mem and /dev/kmem.
With the file given, the tables are sought in the specified
file rather than /dev/mem. The required namelist is taken
from /unix. Options are:
-a Under -p, describe all process slots rather than just
active ones.
-i Print the inode table with these headings:
LOC The core location of this table entry.
FLAGS Miscellaneous state variables encoded thus:
L Locked
U Update time filesystem(F) 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
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(S).
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.
-p
Prints 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, ORed together:
01 Loaded
02 The scheduler process
04 Locked
010 Swapped out
020 Traced
040 Used in tracing
0100 Locked in by lock(S).
PRI Scheduling priority, see nice(S).
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(S).
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.
ADDR1, ADDR2
If in core, the physical page frame numbers of the
u-area of the process. These numbers can be
translated into the addresses of the u-area, which
is split and stored in two pages. If swapped out,
the position in the swap area is measured in
multiples of BSIZE 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 (286 only).
INODP Pointer to location of shared inode (386 only).
CLKT Countdown for alarm(S) measured in seconds.
-u ubase1 ubase2
Print information about a user process. Ubase1 and Ubase2
are the physical page frame numbers of the u-area of the
process. The numbers may be obtained by using the long
listing ( -l option) of the ps(C) command.
-n namelist
Use the file namelist as an alternate namelist in place of
/unix.
-f
Print the open file table with these headings:
LOC The core location of this table entry.
FLG Miscellaneous state variables:
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(S).
Files
/unix Namelist
/dev/mem Default source of tables
See Also
ps(C), stat(S), filesystem(F)
Authorization
The behavior of this utility is affected by assignment of
the mem authorization, which is usually reserved for system
administrators. If you do not have this authorization, the
output will be restricted to data pertaining to your
activities only. Refer to the ``Using a Trusted System''
chapter of the User's Guide for more details.
Value Added
pstat is an extension of AT&T System V provided by the Santa
Cruz Operation.
(printed 9/19/89) PSTAT(C)