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.
-sDumps 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.
-tSuppress trace output. When specified alone, displays only table address information. Typically used in conjunction with -v or -V to see verbose information without traces.
-vVerbose option, excluding inode free and hash chains.
-VVerbose option, including inode free and hash chains. Includes -v output.
-fDecodes 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∕kmemSpecial file that is an image of the kernel virtual memory of the computer.
∕dev∕memSpecial file that is an image of the physical memory of the computer.
∕dev∕ksymsCharacter special file of kernel symbols.