samtrace(1M)

NAME
samtrace - Dumps the Sun QFS or Sun SAM-QFS trace buffer
SYNOPSIS
samtrace [ -d corefile -n namelist ] [ -s ] [ -t ] [ -v ] [
-V ] [ -f ]
samtrace -k suffix [ -s ] [ -v ] [ -V ] [ -f ]
samtrace -O file
samtrace -I file [ -f ]
samtrace -c file [ -b bufs ] [ -p secs ] [ -T ticks ]
samtrace -i file [ -f ]
AVAILABILITY
SUNWqfs
SUNWsamfs
DESCRIPTION
samtrace dumps the contents of the trace buffer for the
mounted file system.
OPTIONS
-b bufs
When used with the -c option, this sets the number of
per-CPU trace read buffers allocated by samtrace to
bufs. The value of bufs must be at least 3, and must
be no more than 64. The default is 5.
-c file
Trace entries are continuously copied from the live
kernel into file until the command is killed. Periodi-
cally, file is written with the binary contents of the
kernel trace buffer; the kernel trace buffer's contents
are cleared after each copy is made. The entries in
file are written in time order, oldest first.
-d corefile
The name of the corefile containing an image of the
system memory. If no corefile is specified the default
is to use the /dev/mem or /dev/kmem file from the run-
ning system.
-n namelist
The name of the namelist file corresponding to the
corefile. If none is specified the default is to use
/dev/ksyms from the running system.
-k suffix
Indicates that the corefile and namelist have the names
'vmcore.suffix' and 'unix.suffix', respectively.
-i file
file must be a file created with the -c continuous
trace option. samtrace reads file and writes a read-
able copy of the binary records in file to the standard
output.
-I file
file must be a file created with the -O trace option.
samtrace reads file and writes a sorted, readable copy
of the binary records in file to the standard output.
-O file
The system trace buffers are copied to file. This file
can later be translated for human interpretation with
the -I option.
-p secs
When used with the -c option, sets an alarm signal for
secs seconds after samtrace starts. This allows for
automatic termination of continuous samtrace operation.
-s Dumps the sam-amld command queue. Includes -v output.
-T ticks
When used with the -c option, sets the default interval
between reads of the kernel trace buffer to ticks
scheduler ticks. The contents of the kernel trace
buffers are by default copied to a samtrace buffer
whenever the trace buffer fills half-way, or 100 ticks
(1 second) has passed, whichever occurs first.
-t Suppress trace output. When specified alone, displays
only table address information. Typically used in con-
junction with -v or -V to see verbose information
without traces.
-v Verbose option, excluding inode free and hash chains.
-V Verbose option, including inode free and hash chains.
Includes -v output.
-f Decodes flag bits in the trace output.
NOTE
samtrace is a utility that is used to provide Sun Microsys-
tems analysts with troubleshooting information. It is not
intended for general use at your site.
FILES
/dev/kmem Special file that is an image of the
kernel virtual memory of the computer.
/dev/mem Special file that is an image of the
physical memory of the computer.
/dev/ksyms Character special file of kernel sym-
bols.