pstat(1M) pstat(1M)
NAME
pstat - print system facts
SYNOPSIS
pstat [-a] [-b] [-f] [-i] [-m] [-n] [-p] [-r] [-t] [-u] [-v
[suboptions]] file
DESCRIPTION
pstat interprets the contents of certain system tables. If
file is given, the tables are sought there, otherwise in
/dev/kmem . Unless the -n flag option is used, the required
namelist is taken from /unix. Flag options are:
-a Under -p, describe all process slots rather than just
active ones.
-b Print the system IO buffer header information with the
following headings:
LOC The core location of the buffer header.
FLAGS
R The buffer is to be read.
W The buffer is to be written.
D The IO is done.
E An error occurred during the buffer's IO operation.
B The buffer is busy.
P The buffer is being used for physical (raw) IO.
M The buffer has map space allocated (not all
machines).
W A process wants to access the buffer and is waiting
for it.
A The buffer has aged.
The buffer is doing an asyncronous operation (the
process that started the IO will not wait for it to
complete).
L A buffer's contents have changed and it needs to be
written out before it can be reallocated.
O The open routine has been called for this device.
S The buffer is ``stale.''
DEVICE The major and minor device numbers for the
device to which the buffer is queued (or
contains information from).
ADDR The core address of the data in the buffer.
BLKNO The block number of the block on DEVICE.
-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
Page 1 (last mod. 1/15/87)
pstat(1M) pstat(1M)
file.
OFFS The file offset, see lseek(2).
-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 fs(4) 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.
DEVICE Major and minor device number of file system in
which this inode resides.
INO Inumber 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.
LOCK Address of the locklist structure for this
inode.
-m Print information about core memory allocation and a dump
of the memory free map with these headings:
LOC The core address of the map entry.
ADDR The ``click'' address of the area this entry
refers to.
SIZE The size of this area in ``clicks''.
-n Used to specify a namelist (system code file) other than
the default of /unix. The next parameter specifies this
file.
-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
2 runnable
3 being terminated
4 stopped under trace
5 being created
6 running
7 being xswapped
F Flags (octal and additive) associated with the
Page 2 (last mod. 1/15/87)
pstat(1M) pstat(1M)
process:
0 swapped;
1 system process;
2 being traced by another process;
4 another tracing flag;
10 process cannot be woken by a signal;
20 in core;
40 locked in memory;
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 page
tables in the proc structure for the "u-area" of
the process. If swapped out, the position in
the swap area measured in multiples of 512
bytes.
SIZE Size of process image in multiples of logical
page size.
WCHAN Wait channel number of a waiting process.
LINK Link pointer in list of runnable processes.
CLKT Countdown for alarm(2) measured in seconds.
-r Used to make the execution of pstat repeat at a rate
defined by the next parameter.
-t Print table for terminals (only DH11 and DL11 handled)
with these headings:
LOC Core location of this table entry.
RAW Number of characters in raw input queue.
CAN Number of characters in canonicalized input
queue.
OUT Number of characters in output queue.
PROC Core location of the proc routine.
IFLAG Input modes (see termio(7)).
OFLAG Output modes (see termio(7)).
CFLAG Control modes (see termio(7)).
LFLAG Line discipline modes (see termio).
STATE Internal state.
TIMEOUT 00000001 Delay timeout in progress.
WOPEN 00000002 Waiting for open to complete.
ISOPEN 00000004 Device is open.
Page 3 (last mod. 1/15/87)
pstat(1M) pstat(1M)
TBLOCK 00000010
CARR_ON 00000020 Software copy of carrier-present.
BUSY 00000040 Output in progress.
OASLP 00000100 Wakeup when output done.
IASLP 00000200 Wakeup when input done.
TTSTOP 00000400 Output stopped by CTRL-s.
EXTPROC 00001000 External processing.
TACT 00002000
CLESC 00004000 Last char escape.
RTO 00010000
TTIOW 00020000
TTXON 00040000
TTXOFF 00100000
TS_RCOLL 00200000 Collision in read select.
TS_WCOLL 00400000 Collision in write select.
TS_NBIO 01000000 Tty in non-blocking mode.
TS_ASYNC 02000000 Tty in async I/O mode.
PGRP Process group for which this is controlling
terminal.
LN Line discipline.
DEL Number of delimiters (newlines) in canonicalized
input queue.
COL Calculated column position of terminal.
ROW Calculated row position of terminal.
IX Index to the table of core locations.
-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.
-v This flag option affects a number of the other flag
options. It make them give a more verbose output. Often
this means that they list table entries that are not
currently active or in use.
FILES
/unix namelist
/dev/kmem default source of tables
EXAMPLE
pstat -i
displays all the active inodes in a table format with
headings.
FILES
/bin/pstat
SEE ALSO
ps(1), stat(2), fs(4).
Page 4 (last mod. 1/15/87)
pstat(1M) pstat(1M)
Oreo Local System Administration.
Page 5 (last mod. 1/15/87)