Skip Headers
Oracle Hierarchical Storage Manager and QFS Software Command Reference
Section 1m: Maintenance Commands
Release 6.1.1
E70305-03

NAME

samtrace - Dumps the StorageTek QFS or StorageTek Oracle HSM 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. 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 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 running 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 readable 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 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.

NOTE

samtrace is a utility that is used to provide Oracle 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 symbols.