samtrace - Dumps the Sun QFS or Sun SAM-QFS trace buffer
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 ]
samtrace dumps the contents of the trace buffer for the
mounted file system.
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.
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.
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-
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.
Indicates that the corefile and namelist have the names
'vmcore.suffix' and 'unix.suffix', respectively.
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
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.
The system trace buffers are copied to file. This file
can later be translated for human interpretation with
the -I option.
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.
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
-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.
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.
/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-