pstat(8)pstat(8)Namepstat - print system facts
Syntax
/etc/pstat [-options ] [ system ] [ corefile ]
Description
The command interprets the contents of certain system tables. The con‐
tents of system tables can change while is running, so the information
it gives is a snapshot taken at a given time. If you specify the sys‐
tem argument, gets the namelist from the named system's kernel. If you
omit the system argument, uses the namelist in If you specify the core‐
file argument, uses the tables in the core file. Otherwise, uses the
tables in When you use the -k option, be sure to specify the system or
corefile argument.
Options-a When used with the -p option, displays all process slots, rather
than just active ones.
-f Displays the open file table with the following headings:
LOC The core location of this table entry.
TYPE The type of object the file table entry points to.
FLG Miscellaneous state variables, encoded as follows:
R Open for reading
W Open for writing
A Open for appending
S Shared lock
X Exclusive use
I Asynchronous input and output notification
B Block-if-in-use flag is set (shared line sema‐
phore)
CNT Number of processes that know this open file.
GNO The location of the gnode table entry for this file.
OFFS/SOCK The file offset or the core address of the associated
socket structure. (See for information on file off‐
sets.)
-i Displays the gnode table with the following headings:
LOC The core location of this table entry.
FLAGS Miscellaneous state variables, encoded as follows:
L Locked.
U Update time for the file system must be cor‐
rected. See for more information.
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.
S Shared lock applied.
E Exclusive lock applied.
Z Someone waiting for an exclusive lock.
I In-use flag is set (shared line semaphore).
CNT Number of open file table entries for this gnode.
DEV Major and minor device number of the file system in
which this gnode resides.
RDC Reference count of shared locks on the gnode.
WRC Reference count of exclusive locks on the gnode.
(This count can be >1 if, for example, a file
descriptor is inherited across a fork.)
GNO I-number within the device.
MODE Mode bits. (See for information about mode bits.)
NLK Number of links to this gnode.
UID User identification (ID) of owner.
SIZ/DEV Number of bytes in an ordinary file or major and
minor device of a special file.
-k Indicates that a system corefile is to be examined. Be sure to
specify the corefile argument.
-p Displays the process table for active processes with these head‐
ings:
LOC The core location of this table entry.
S Run state, encoded as follows:
0 No process
1 Waiting for some event
3 Able to be run
4 Being created
5 Being terminated
6 Stopped under trace
F Miscellaneous state variables, combined with a Bool‐
ean OR operation (hexadecimal):
00000001 Process is resident in memory.
00000002 System process: swapper, pager, idle
(RISC only), trusted path daemon.
00000004 Process is being swapped out.
00000008 Process requested swapout for page table
growth.
00000010 Traced.
00000020 Used in tracing.
00000040 Locked in by a call.
00000080 Waiting for page-in to complete.
00000100 Protected from swapout while transferring
resources to another process.
00000200 Used by a call.
00000400 Exiting.
00000800 Protected from swapout while doing physi‐
cal input and output.
00001000 Process resulted from a call, which is not
yet complete.
00002000 Parent has received resources returned by
a child created with the call.
00004000 Process has no virtual memory because it
is a parent in the context of the call.
00008000 Process is demand-paging data pages from
its text gnode.
00010000 Process has advised of sequential memory
access.
00020000 Process has advised of random memory
access.
00080000 Process has indicated intent to execute
data or stack (RISC only).
00100000 POSIX environment: no SIGCLD generated
when children stop.
00200000 Process is owed a profiling tick.
00400000 Used by a call.
00800000 A login process.
04000000 System V file lock applied.
08000000 Repair of unaligned accesses has been
attempted (RISC only).
10000000 Process has called the system routine.
20000000 The idle process (RISC only).
POIP Number of pages currently being pushed out from this
process.
PRI Scheduling priority. (See for information on priori‐
ties.)
SIGNAL Signals received (signals 1-32 coded in bits 0-31).
UID Real user ID.
SLP Amount of time the process has been blocked.
TIM Time resident in seconds; values greater than 127 are
coded as 127.
CPU Weighted integral of CPU time, for scheduler.
NI Nice level. (See for information about nice levels.)
PGRP Process number of the root of the process group (the
opener of the controlling terminal).
PID The process ID number.
PPID The process ID of the parent process.
ADDR If the process is in memory, identifies the user area
page frame number of the page table entries. If the
process is swapped out, identifies the position in
the swap area measured in multiples of 512 bytes.
RSS Resident set size minus the 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 plus stack) in
multiples of 512 bytes.
WCHAN Wait channel number of a waiting process.
LINK Link pointer in list of processes that can be run.
TEXTP If text is pure, pointer to location of text table
entry.
CLKT Countdown for real interval timer, measured in clock
ticks (10 milliseconds). See for information about
the real interval timer.)
TTYP Address of controlling the terminal.
DMAP Address of data segment dmap structure.
SMAP Address of stack segment dmap structure.
-s Displays the swap space configured, then the following information
about swap space:
· The number of pages reserved, but not necessarily allo‐
cated, by the system for currently executing processes.
· The number of pages used (physically allocated), including
the number used for text images.
· The number of pages free, wasted, or missing. Free pages
are pages that have not been allocated. Missing pages are
usually allocated to argdev. Wasted pages indicate the
amount of space lost because the swap space is fragmented.
· The swap space available, in terms of 32KB buffers and 1KB
buffers. This is the amount of space that is available
for swapping.
-t Displays the table for terminals with the following headings:
RAW Number of characters in the raw input queue
CAN Number of characters in the canonic input queue
OUT Number of characters in the output queue
MODE Terminal mode, as described in
ADDR Physical device address
DEL Number of delimiters (newlines) in the canonic input
queue
COL Calculated column position of the terminal
STATE Miscellaneous state variables, encoded as follows:
T Line is timed out
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
S Output is stopped (ttstop)
I In-use flag is set (shared line semaphore)
D Open nodelay
G Ignore carrier
N Nonblocking input and output
Z Asychronous input and output notification
L Terminal line is in the process of closing
Q Output suspended for flow control
PGRP Process group for which this is the controlling ter‐
minal
DISC Line discipline; blank is old tty OTTYDISC, ntty for
NTTYDISC, or termio for TERMIODISC
-T Displays the number of used and free slots in the system tables.
This option is useful for determining how full the system tables
have become if the system is under a heavy load.
-upid
Displays information about a user process. The next argument is
the process address, as given by The process must be in main mem‐
ory, or the file used can be a core image and the address 0.
-v Displays a listing of all vector processes on the system. This
option is valid only for processors that have the VAX vector hard‐
ware. No vector headings are produced if the -T option is speci‐
fied or there are no vector processes to report.
The following list describes the headings in the display:
LOC The core location of this table entry
PPGRP The process number of the root of the process group
(the opener of the controlling terminal)
PID The process ID number
PPID The process ID of the parent process
VSTAT One of the following vector process statuses:
WAIT New vector process, which is waiting for a
vector processor to be allocated to it.
LOAD Process context is present in both vector
and scalar processors.
SAVED Process vector context is saved in memory.
LIMBO A vector processor has been allocated to the
process, but the vector context of the
process has not yet been loaded.
VERRS Number of vector processor errors incurred by this
process
REFS Number of times this process was refused scheduling into
a vector processor
CHPCXT Number of times the scaler context has been saved and
restored, while the vector context remains resident in
the vector processor
EPXCXT Number of times both the scalar and vector contexts have
been saved and restored
-x Displays the text table with the following headings:
LOC The core location of this table entry
FLAGS Miscellaneous state variables encoded as follows:
T A process called the system call.
W Text has not yet been written on the swap
device.
L Loading is in progress.
K Locked.
w Wanted. (L flag is on.)
F Text structure is on the freelist.
P Resulted from demand-page-from-gnode execution
format. For further information, see
l Locked from being paged or swapped. For fur‐
ther information, see
B All attached processes are being killed due to
server write of an file.
DADDR Address of the text dmap structure in core
CADDR Head of a linked list of loaded processes using this
text segment
SIZE Size of the text segment, measured in multiples of
512 bytes
IPTR Core location of the corresponding gnode
CNT Number of processes using this text segment
CCNT Number of processes in core using this text segment
LCNT Number of process locking this text segment
POIP Number of pages currently being pushed out in this
text segment
CMAP The address of the last CMAP entry freed
Files
User process information
Kernel memory
System namelist
See Alsops(1), chmod(2), execve(2), getitimer(2), getpriority(2), lseek(2),
plock(2), ptrace(2), stat(2), fs(5)pstat(8)
