xsw
NAME
xsw - X System Watcher
SYNTAX
xsw [options]
DESCRIPTION
xsw is a client/server based system resource monitoring
tool. xsw , the client, is to be used in conjunction with
xswsrv , the server.
When xsw is invoked, a Main Control Panel (MCP) is
displayed. A menu bar is position on top with three pull
down menus:
File
-Connect to a new server.
-Disconnet a server.
-Exit xsw
Options
-Change fonts on a per server basis.
-Change button actions.
Help
-General Display Information
-Options
Directly below the menu bar on the left side, is a box that
contains a list of server(s) which xsw is currently
connected to. The active server will be highlighted. The MCP
will reflect the state of the active server. All connected
servers will be updated according to their Target interval
time (See Below). Only one server can be viewed on the MCP
at a time. Directly below the menu bar and to the right of
the server list is a message box used for displaying
messages regaurding the active server. Directly below the
message box are:
Target : What sampling interval is wanted for the active
server. Arrow buttons change the interval.
Actual : The actual sampling interval obtained for the
active server.
Users : The number of users for the active server.
Below the Target, Actual, and Users boxes, are toggle
buttons used for displaying system resources. The resources
available for viewing are:
CPU: Displays cpu usage at actual interval, average
cpu usage at actual interval * 5 , and average
cpu usage at actual interval * 10. The cpu
usage is broken down into: user time, sytem
time, and break time.
WAIT: Displays cpu wait usage at actual interval,
average cpu wait at actual interval * 5 , and
average cpu wait at actual interval * 10. The
cpu wait usage is broken down into: I/O time,
page I/O time, and swap I/O time.
Cache : Displays disk cache read/write hit/misses.
Other : Displays several tunable kernel structures:
NFILES The maximum number of open
files system-wide. Each entry
represents an open file.
NINODES The many inode table entries
to allocate. Each table entry
represents an in-core inode
that is an active file.
NPROC The many process tabel entries
to allocate. Each table entry
represents an active process.
The number of entries depends
on the number of terminal
lines available and the number
of prcesses spawned by each
user.
NREGION How many region table entries
are used.
CBLOCKS How many cfree table entries
are used.
CALLOUTS How many call-out table
entries are used.
NMOUNTS How many mount table entries
are used.
PS Cpu: Displays cpu usage on a per process basis. The
processes displayed can be those CURrently
running and/or have run, or ALL process on the
system. If CUR is choosen, then time can be
shown as a percentage (%) of the interval or in
Ticks for that interval. If ALL process is
choosen, then time can be shown as a percentage
(%) since boot or in Minutes:seconds. The
following is displayed for PS Cpu:
S The state of the process at
time of sampling. The follwing
states are shown:
s The process is currently
sleeping, waiting for an
event.
R The process is currently
running.
USER The user of the process. If
the process is "set uid", then
the "#" character will be
appended to the user name.
PID The Process IDentification of
the process.
CPU The cpu usage for scheduling.
PRI The priority of the process.
NI The nice value used for cpu
usage.
UCPU Tser time of the process.
SCPU System time of the process.
U+S User + system time of the
process.
SIZE Size of the process, according
to the "proc" data structure..
TTY Tty associated with the
process.
CMD The arguments from the
execution of the process.
PS I/O: Displays I/O on a per process basis. The
processes displayed can be those CURrently
running and/or have run, or ALL process on the
system. If CURrent is choosen, then time can be
shown as a percentage (%) of the interval or in
Ticks for that interval. If ALL process is
choosen, then time can be shown as a percentage
(%) since boot or in Minutes:seconds. The
following is displayed for PS I/O:
USER The user of the process. If
the process is "set uid", then
the "#" character will be
appended to the user name.
PID The Process IDentification of
the process.
SWAP The number of bytes to/from
swap for that process.
CHAR The number of characters for
that process.
READ The number of reads for that
process.
WRITE The number of writes for that
process.
TOTAL The number of read + writes
for that process.
CMD The arguments from the
execution of the process.
PS Mem: Displays memory on a per process basis. Memory
is displayed in memory "pages" and can be in
Accending or Deccending order. There are
several different VIEWs of memory:
Core Storage Only: Private & Shared:
USER The user of the process.
PID The Process
IDentification of the
process.
VSIZE The virtual size of the
process. This is the
maximum size that the
process can grow to.
SHRD The number of pages that
are sharable.
PRIV The number of pages that
are private.
WTD The number of pages in a
region that are valid
divided by the number of
process referenceing the
region.
TOTAL The PRIV + WTD.
CMD The arguments from the
execution of the process.
Core Storage Only:
USER The user of the process.
PID The Process
IDentification of the
process.
VSIZE The virtual size of the
process. This is the
maximum size that the
process can grow to.
NONE The number of pages that
are in core only.
SWAP The number of pages that
are in core, but with a
copy on swap.
FILE The number of pages that
are in core, but with a
copy on file.
LSTFILE The number of pages that
are in core, but with a
copy on file.
TOTAL Is NONE + SWAP + FILE +
LSTFILE.
CMD The arguments from the
execution of the process.
All Storage :
USER The user of the process.
PID The Process
IDentification of the
process.
VSIZE The virtual size of the
process. This is the
maximum size that the
process can grow to.
NONE The number of pages that
are in core only.
SWAP The number of pages that
on swap.
FILE The number of pages that
on file.
LSTFILE The number of pages that
on file.
ZERO The number of pages that
are zero filled.
FILL The number of pages that
are fill.
IOMAP The number of pages that
are io mapped.
WINDOW The number of pages that
are window.
CMD The arguments from the
execution of the process.
Secondary Storage All:
USER The user of the process.
PID The Process
IDentification of the
process.
VSIZE The virtual size of the
process. This is the
maximum size that the
process can grow to.
SWAP The number of pages that
are on swap only.
FILE The number of pages that
on file only.
LSTFILE The number of pages that
on file only.
ZERO The number of pages that
have not been used yet.
FILL The number of pages that
are fill.
IOMAP The number of pages that
are io mapped.
WINDOW The number of pages that
are window.
CMD The arguments from the
execution of the process.
Streams: Displays streams statistics. The following
information:
Config What is currently configured
into the system.
Use The current item usage count.
%Use The percent of Config in use.
Total The total item usage count.
Max The maximum item usage count.
Fail The count of allocations
failures.
is shown for these streams sturcutres:
NSTREAM Stream allocation data.
NQUEUE Queue allocation data.
MBLOCK Message block allocation data.
DBLK TOT Total stream buffers.
DBLK4 4 byte stream buffer.
BLK16 16 byte stream buffer.
BLK64 64 byte stream buffer.
BLK128 128 byte stream buffer.
BLK256 256 byte stream buffer.
BLK512 512 byte stream buffer.
BLK1024 1024 byte stream buffer.
BLK2048 2048 byte stream buffer.
BLK4096 4096 byte stream buffer.
NFS Stats: Displays statistics on both the client and
server side of NFS.
NFS Client:
calls The total number of
calls.
badcalls The number of rejected
NFS calls.
nclget The number of times the
client had to request a
new handle for an NFS
call.
clsleep The number of times a NFS
call was blocked becasue
no client was currently
availble. Please see man
page on nfsclnt if this
number is greater than 0.
null Breakdown of NFS calls by
procedure.
NFS server:
calls The total number of
calls.
badcalls The number of rejected
NFS calls.
null Breakdown of NFS calls by
procedure.
RPC client:
calls The total number of calls
made to all NFS servers.
badcalls The number of RPC calls
that returned an error.
retrans The number of calls that
were retransmitted
because not reponse was
recieved from the NFS
server within the timeout
period.
badxid Indicates that the server
is recieving some
retransmitted requests,
but is taking a long time
to reply to all NFS
requests.
timeout Number of calls that
timed out waiting for a
server response.
wait The number of calls that
had to wait on a busy
client handle to be
refreshed.
peekerrs The number of 'peek' into
call message that failed.
badresps The number of minimal
reply message size
failures.
RPC server:
calls The total number of NFS
RPC calls made to this
server, from all clients.
badcalls The number of RPC calls
that were rejected,
before the request was
passed to the NFS service
routines.
nullrecv The number of times an
nfsd daemon is scheduled
to run but finds that
there is no packet on the
NFS service socket queue.
badlen The RPC request recieved
by the server was too
short.
xdrcall The XDR headers in the
packet are malformed.
Sysinfo: Displays the "sysinfo" data structure. The
following is displayed:
bread The number of block reads
during this interval.
bwrite The number of block writes
during this interval.
lread The number of logical reads
during this interval.
lwrite The number of logical writes
during this interval.
phread The number of physical reads
during this interval.
phwrite The number of physical writes
during this interval.
swapin The number of swap in's during
this interval.
swapout The number of swap out's
during this interval.
bswapin The number of block swap in's
during this interval.
bswapout The number of block swap out's
during this interval.
iget The number of iget's during
this interval.
namei The number of namei's during
this interval.
dirblk The number of dirblk's during
this interval.
readch The number of character's read
during this interval.
writech The number of character's
written during this interval.
rawch The number of
????????????????????????????????????????.
canch The number of
????????????????????????????????????????.
outch The number of
????????????????????????????????????????.
msg The number of
????????????????????????????????????????.
sema The number of
????????????????????????????????????????.
maxmem The amount of memory that is
availble to user processes.
frmem The amount of memory that is
free to user processes.
mem used The percent of memory that is
being used.
nswap The amount of swap space
available.
frswp The amount of free swap space
available.
swp used The percent of swap being
used.
availswp The amount of available swap.
pswitch The number of context switches
during this interval.
syscall The number of system calls
during this interval.
sysread The number of system reads
during this interval.
syswrit The number of system writes
during this interval.
sysfork The number of system forks
during this interval.
sysexec The number of system execs
during this interval.
runque The number of processes ready
to run.
runocc The number of processes
????????????.
swpque The number of processes
????????????.
swpocc The number of processes
????????????.
vfault The number of faults.
demand The number of demands.
pfault The number of page faults.
cw The number of ??????.
steal The number of ??????.
frdpgs The number of ??????.
vfpg The number of ??????.
sfpg The number of ??????.
vspg The number of ??????.
sspg The number of ??????.
pnpfault The number of ??????.
wrtfault The number of ??????.
unmodsw The number of ??????.
unmodfl The number of ??????.
psoutok The number of ??????.
psinfai The number of ??????.
psinok The number of ??????.
rsout The number of ??????.
rsin The number of ??????.
pages from
swap
cache
file
VBT: Displays the "v", "bootinfo", "tune",
"bs_bootstring", & "strgCfg" data structure.
The following is displayed:
Var
v_autoup Age (in seconds) before
bdflush writes delayed-
write buffer.
v_buf Number of I/O buffers
v_clist Number of clists
allocated
v_file Size of file table.
v_hbuf Hash buffers (power of 2)
v_inode Size of incore inode
table
v_maxpmem Maximum physical memory
to use (if 0, then use
all available physical
memory); in pages.
v_maxup Max processes per user
v_mount Size of mount table
v_pbuf Number of physical I/O
buffers.
v_proc Size of proc table
v_region Number of regions
allocated.
v_vhndfrac Fraction of maxmem limits
vhand.
Bootinfo
basemem The base memory
available.
extmem The extended memory
available.
bflags The bootflags in
hexidecimal .
memory available The memory available and
what it is being used
for.
Tune
t_ageintvl Age process every so many
seconds
t_bdflushr The rate at which bdflush
is run in seconds.
t_gpgshi Once we start to steal
pages, don't stop until
freemem > t_getpgshi.
t_gpgslo If freemem < t_getpgslow,
then start to steal pages
from processes.
t_gpgsmsk Mask used by getpages to
determine whether a page
is stealable. The page is
stealable if pte &
t_gpgsmskis == 0.
t_maxfc The maximum number of
pages which will be saved
up and freed at once.
t_maxsc The maximum number of
pages which will be
swapped out in a single
operation.
t_maxumem The maximum size of a
user's virtual address
space in pages.
t_minarmem The minimum available
resident (not swapable)
memory to maintain in
order to avoid deadlock.
In pages.
t_minasmem The minimum available
swapable memory to
maintain in order to
avoid deadlock. In
pages.
Boot String Displays the boot string of
the system.
Boot configuration Displays the device
configuration of the system.
Disk Stats.: Displays activity for block devices. e.g., disk
or tape drive. The activity reported is:
Device # The device.
%Busy Portion of time that the
device was busy servicing a
transfer request during the
interval.
AvQue Average number of requests
outstanding during the
interval.
r+w/s Number of data transfers from
or to the device per second
during the interval.
blks/s Number of bytes transferred in
512-byte units per second
during the interval.
AvWait Average time in milliseconds
that the transfer requests
wait idly on the queue.
AvServ Average time in miliseconds to
be serviced ( which for disks
includes seek, rotational
latency, and data transfer
times).
MEM: Displays the following:
% Memory Used Displays average and current
memory usages as a percent of
total memory.
% Swap Used Displays average and current
swap usages as a percent of
total swap.
% Avail. Swap Used Displays average and current
available swap usages as a
percent of total available
swap.
OPTIONS
Command line options allow the user to set specific colors
and threshold values. xsw can connect to an unlimited
number of servers.
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _
| _ lp-2 | lp-2 | lp-2. Xsw Standard Options Command-line
Option Resource Name Description -display
displayName - Alternate display -help - prints
out all options to stdout. -version - prints out the
version of xsw. -server host:[window,window,...] - T{
connects to host and pops up appropriate resource window.
The follwing resource windows are available:
cpu,wait,cache,other,pscpu,psio,psmem,streams
nfs,sysinfo,vbt,disk,mem T} -geometry
geometry - Geometry. -title title - The title.
-bg color background:color Background color. -fg
color foreground:color Foreground color. -fn
font font:font Default font.
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _
| _ lp-2 | lp-2 | lp-2. Xsw Generic Options Command-line
Option Resource Name Description -labelc
color labelColor:color T{ The color of text labels. T}
-usersc color userColor:color T{ The color of the
user's window. T} -intervalc
color IntervalColor:color T{ The color of target window.
T} -actintervalc color ActiveIntervalColor T{ The color of
actual window. T} -actintervalwc
color ActualIntervalWarningColor:color T{ The color of
actual window when its time is +/-10% of target. T}
-actintervalac
color ActualIntervalAlarmColor:color T{ The color of
actual window when its time is +/-30% of target. T}
-titlebfg color title_barfgColor:color T{ The text
background color for window title bars. T} -titlebbg
color title_barbgColor:color T{ The text foreground
color for window title bars. T} -auxbtnonbgc
color auxButtonOnBackground:color T{ The Auxillary
Buttons' "ON" Background. T} -auxbtnonffgc
color auxButtonOnForeground:color T{ The Auxillary
Buttons' "ON" Foreground. T} -auxbtnoffbgc
color auxButtonOffBackground:color T{ The Auxillary
Buttons' "OFF" Background. T} -auxbtnofffgc
color auxButtonOffForeground:color T{ The Auxillary
Buttons' "OFF" Foreground. T} -numericc
color numericColor:color T{ The Numeric color. T}
-numericwc color numericWarningColor:color T{ The
Numeric Warning color. T} -numericac
color numericAlarmColor:color T{ The Numeric Alarm
color. T} -snumericc color staticNumericColor:color T{
The Static Numeric color T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _
| _ lp-2 | lp-2 | lp-2. Xsw CPU Window Options Command-line
Option Resource Name Description -uc
color userColor:color T{ The User CPU percentage scale
color. T} -kc color kernelColor:color T{ The Kernel CPU
percentage scale color. T} -bc color breakColor:color T{
The Break CPU percentage scale color. T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _
| _ lp-2 | lp-2 | lp-2. Xsw Wait Window Options Command-
line Option Resource Name Description -ic
color ioColor:color T{ The I/O WAIT percentage scale color.
T} -pc color pioColor:color T{ The Page I/O WAIT percentage
scale color. T} -sc color swapColor:color T{ The Swap
I/O WAIT percentage scale color. T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _ |
_ lp-2 | lp-2 | lp-2. Xsw MEM Window Options Command-line
Option Resource Name Description -memusedc
color memUsedColor:color T{ The Memory percent used
scale color. T} -memusedwc
color memUsedWarningColor:color T{ The Memory percent
used warning scale color. T} -memusedac
color memUsedAlarmColor:color T{ The Memory percent used
alarm scale color. T} -muwt
threshhold memUsedWarningThreshhold:threshhold T{ The
Memory Warning percent Threshhold. T} -muat
threshhold memUsedAlarmThreshhold:threshhold T{ The
Memory Alarm percent Threshhold. T} -swapusedc
color swapUsedColor:color T{ The Swap memory percent used
scale color. T} -swapusedwc
color swapUsedWarningColor:color T{ The Swap memory
percent used warning scale color. T} -swapusedac
color swapUsedAlarmColor:color T{ The Swap memory percent
used alarm scale color. T} -suwt
threshhold\fR swapUsedWarningThreshhold:threshhold\fR T{ The
Swap Warning percent Threshhold. T} -suwt
threshhold\fR swapUsedAlarmThreshhold:threshhold\fR T{ The
Swap Alarm percent Threshhold. T} -availswapusedc
color availSwapUsedColor:color T{ The Avail. Swap memory
percent used scale color. T} -availswapusedwc
color availSwapUsedWarningColor:color T{ The Avail.
Swap memory percent used warning scale color. T}
-availswapusedac color availSwapUsedAlarmColor:color T{
The Avail. Swap memory percent used alarm scale color. T}
-asuwt
threshhold availSwapUsedWarningThreshhold:threshhold T{
The Avail. Swap Warning percent Threshhold. T} -asuat
threshhold availSwapUsedAlarmThreshhold:threshhold T{ The
Avail. Swap Alarm percent Threshhold. T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _
| _ lp-2 | lp-2 | lp-2. Xsw Cache Window Options Command-
line Option Resource Name Description -cachereadhitc
color cacheReadHitColor:color T{ The Read Cache Hit
scale color. T} -cachewritehitc
color cacheWriteHitColor:color T{ The Write Cache Hit
scale color. T} -cachereadmissc
color cacheReadMissColor:color T{ The Read Cache Miss
scale color. T} -cachewritemissc
color cacheWriteMissColor:color T{ The Write Cache
Miss scale color. T} -cachereadmisswc
color cacheReadMissWarningColor:color T{ The Read Cache
Miss Warning scale color. T} -cachewritemisswc
color cacheWriteMissWarningColor:color T{ The Write Cache
Miss Warning scale color. T} -cachereadmissac
color cacheReadMissAlarmColor:color T{ The Read Cache Miss
Alarm scale color. T} -cachewritemissac
color cacheWriteMissAlarmColor:color T{ The Write Cache
Miss Alarm scale color. T} -rca
percent readCacheAlarmThreshhold:percent T{ The Read
Cache Hit alarm percentage. T} -wca
percent writeCacheAlarmThreshhold:percent T{ The Write
Cache Hit alarm percentage. T} -rcw
percent readCacheWarningThreshhold:percent T{ The Read
Cache Hit warning percentage. T} -wcw
percent writeCacheWarningThreshhold:percent T{ The
Write Cache Hit warning percentage. T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _
| _ lp-2 | lp-2 | lp-2. Xsw Other Window Options Command-
line Option Resource Name Description -nfilec
color nfileColor:color T{ The NFILE percentage scale
color. T} -ninodec color ninodeColor:color T{ The NINODE
percentage scale color. T} -nprocc
color nprocColor:color T{ The NPROC percentage scale
color. T} -nregionc color nregionColor:color T{ The
NREGION percentage scale color. T} -ncblocksc
color ncblocksColor:color T{ The NCBLOCKS percentage
scale color. T} -nfileac color nfileAlarmColor:color T{
The NFILE Alarm percentage scale color. T} -ninodeac
color ninodeAlarmColor:color T{ The NINODE Alarm
percentage scale color. T} -nprocac
color nprocAlarmColor:color T{ The NPROC Alarm percentage
scale color. T} -nregionac
color nregionAlarmColor:color T{ The NREGION Alarm
percentage scale color. T} -ncblocksac
color ncblocksAlarmColor:color T{ The NCBLOCKS Alarm
percentage scale color. T} -nfileat
threshhold nfileAlarmThreshhold:threshhold T{ The NFILE
Alarm percent Threshhold. T} -ninodeat
threshhold ninodeAlarmThreshhold:threshhold T{ The
NINODE Alarm percent Threshhold. T} -nprocat
threshhold nprocAlarmThreshhold:threshhold T{ The NPROC
Alarm percent Threshhold. T} -nregionat
threshhold nregionAlarmThreshhold:threshhold T{ The
NREGION Alarm percent Threshhold. T} -ncblocksat
threshhold ncblocksAlarmThreshhold:threshhold T{ The
NCBLOCKS Alarm percent Threshhold. T} -nfilewc
color nfileWaringColor:color T{ The NFILE Warning
percentage scale color. T} -ninodewc
color ninodeWarningColor:color T{ The NINODE Warning
percentage scale color. T} -nprocwc
color nprocWarningColor:color T{ The NPROC Warning
percentage scale color. T} -nregionwc
color nregionWarningColor:color T{ The NREGION
Warning percentage scale color. T} -ncblockswc
color ncblocksWarningColor:color T{ The NCBLOCKS
Warning percentage scale color. T} -nfilewt
percent nfileWarningThreshhold:percent T{ The NFILE
Warning percent Threshhold. T} -ninodewt
percent ninodeWarningThreshhold:percent T{ The NINODE
Warning percent Threshhold. T} -nprocwt
percent nprocWarningThreshhold:percent T{ The NPROC
Warning percent Threshhold. T} -ncblockswt
percent ncblocksWarningThreshhold:percent T{ The NCBLOCKS
Warning percent Threshhold. T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _ |
_ lp-2 | lp-2 | lp-2. Xsw PS Mem Window Options Command-
line Option Resource Name Description -psmemc
color psMemColor:color T{ The PS Memory color T}
-psmemgrowc color psMemGrowingColor:color T{ The PS
Memory growing color. T} -psmemshrinkc
color psMemShrinkingColor:color T{ The PS Memory
shrinking color. T} -psmemnewc
color psMemNewColor:color T{ The PS Memory new color. T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _ |
_ lp-2 | lp-2 | lp-2. Xsw PS CPU Window Options Command-
line Option Resource Name Description -pscpuidlec
color psCpuIdleColor:color T{ The PS CPU idle color.
T} -pscpuactivec color psCpuActiveColor:color T{ The PS
CPU active color . T} -pscpunewc
color psCpuNewColor:color T{ The PS CPU new color. T}
-pscpurunc color psCpuRunningColor:color T{ The PS CPU
running color. T}
allbox doublebox; lw(1.25i) sw(2i) sw(2i) _ | _ |
_ lp-2 | lp-2 | lp-2. Xsw PS IO Window Options Command-line
Option Resource Name Description -psioidlec
color psioidlec:color T{ The PS IO idle color. T}
-psioactivec color psioactivec:color T{ The PS IO active
color. T} -psionewc color psionewc:color T{ The PS IO
new color. T}
LIMITATIONS
FILL IN THE BLANK
AUTHOR
doublebox; c. Rick Rasmussen The Santa Cruz Operation
rickra@sco.com
SEE ALSO
X(1X), xswsrv(1X)