pstat(8)

NAME

pstat, swapinfo - display system data structures

SYNOPSIS

pstat [-Tfhknst] [-M core [-N system]]
swapinfo [-hk] [-M core [-N system]]

DESCRIPTION

The pstat utility displays open file entry, swap space uti

lization, terminal state, and vnode data structures.

If invoked as swapinfo the -s option is implied, and only

the -k option
is legal.

If the -M option is not specified, information is obtained

from the currently running kernel via the sysctl(3) interface. Other

wise, information is read from the specified core file, using the name

list from the
specified kernel image (or from the default image).

The following options are available:

-n Print devices out by major/minor instead of name.

-h ``Human-readable'' output. Use unit suffixes when

printing swap

partition sizes: Byte, Kilobyte, Megabyte, Gigabyte,

Terabyte and
Petabyte.

-k Print sizes in kilobytes, regardless of the setting

of the

BLOCKSIZE environment variable.

-T Print the number of used and free slots in several

system tables.

This is useful for checking to see how large system

tables have
become if the system is under heavy load.

-f Print the open file table with these 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 thus:

R open for reading
W open for writing
A open for appending
I signal pgrp when data ready

CNT Number of processes that know this open

file.

MSG Number of messages outstanding for this

file.

DATA The location of the vnode table entry or

socket structure

for this file.

OFFSET The file offset (see lseek(2)).

-s Print information about swap space usage on all the

swap areas

compiled into the kernel. The first column is the

device name of
the partition. The next column is the total space

available in
the partition. The Used column indicates the total

blocks used
so far; the Available column indicates how much

space is remaining on each partition. The Capacity reports the

percentage of
space used.

If more than one partition is configured into the

system, totals
for all of the statistics will be reported in the

final line of
the report.

-t Print table for terminals with these headings:

LINE Device name.

RAW Number of characters in raw input queue.

CAN Number of characters in canonicalized input

queue.

OUT Number of characters in output queue.

IHIWT High water mark for input.

ILOWT Low water mark for input.

OHWT High water mark for output.

LWT Low water mark for output.

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
F outq has been flushed during DMA
C carrier is on
c connection open
B busy doing output
A process is waiting for space in out

put queue
a process is waiting for output to

complete
X open for exclusive use
S output stopped (ixon flow control)
m output stopped (carrier flow con

trol)
o output stopped (CTS flow control)
d output stopped (DSR flow control)
K input stopped
Y send SIGIO for input events
D state for lowercase `´ work
E within a `.../' for PRTRUB
L next character is literal
P retyping suspended input (PENDIN)
N counting tab width, ignore FLUSHO
l block mode input routine in use
s i/o being snooped
Z connection lost

SESS Kernel address of the session structure.

PGID Process group for which this is the control

ling terminal.

DISC Line discipline; `term' for TTYDISC or `nt

ty' for NTTY

DISC or `slip' for SLIPDISC or `ppp' for PP

PDISC.

-M Extract values associated with the name list from

the specified

core.

-N If -M is also specified, extract the name list from

the specified

system instead of the default, which is the kernel

image the system has booted from.

SEE ALSO

ps(1), systat(1), stat(2), fs(5), iostat(8), vmstat(8)

K. Thompson, UNIX Implementation.

HISTORY

The pstat utility appeared in 4.0BSD.

BUGS

Does not understand NFS swap servers.

BSD March 21, 2005

BSD