Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
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.