samtrace - Dumps the StorageTek QFS or StorageTek Oracle HSM 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
]
SUNWqfs
SUNWsamfs
samtrace
dumps the contents of the trace buffer for the
mounted file system.
-b
bufsWhen 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
fileTrace entries are continuously copied from the live kernel into file until the command is killed. Periodically, 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
corefileThe 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 running system.
-n
namelistThe 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
suffixIndicates that the corefile and namelist have the names \'vmcore.suffix\' and \'unix.suffix\', respectively.
-i
filefile must be a file created with the -c
continuous
trace option.
samtrace
reads file and writes a readable copy of
the binary records in file to the standard output.
-I
filefile 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
fileThe system trace buffers are copied to file.
This file can later be translated for human interpretation
with the -I
option.
-p
secsWhen 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
ticksWhen 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 conjunction 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.
samtrace
is a utility that is used to provide Oracle
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 symbols.