samtrace(1M)

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.