JavaScript is required to for searching.
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
search filter icon
search icon

Document Information

Preface

1.  User Commands (Man Pages Section 1)

2.  Maintenance Commands (Man Pages Section 1M)

archive_audit(1M)

archive_mark(1M)

archiver(1M)

archiver.sh(1M)

arcopy(1M)

arfind(1M)

auditslot(1M)

backto(1M)

build_cat(1M)

chmed(1M)

cleandrive(1M)

clri(1M)

damage(1M)

dev_down.sh(1M)

dmpshm(1M)

dump_cat(1M)

dump_log(1M)

exarchive(1M)

export(1M)

fsmadm(1M)

fsmdb(1M)

fsmgmtd(1M)

fsmgr(1M)

fsmgr_setup(1M)

fsmupd(1M)

generic(1M)

gnutar(1M)

HAStoragePlus_samfs(1M)

import(1M)

itemize(1M)

load(1M)

load_notify.sh(1M)

log_rotate.sh(1M)

mccfg(1M)

mount_samfs(1M)

move(1M)

nrecycler.sh(1M)

odlabel(1M)

qfsdump(1M)

qfsrestore(1M)

rearch(1M)

recover.sh(1M)

recycler(1M)

recycler.sh(1M)

releaser(1M)

reserve(1M)

restore.sh(1M)

robots(1M)

rpc.sam(1M)

sam-amld(1M)

sam-archiverd(1M)

sam-arcopy(1M)

sam-arfind(1M)

sam-catserverd(1M)

sam-clfsd(1M)

sam-clientd(1M)

sam-dbupd(1M)

sam-fsalogd(1M)

sam-fsd(1M)

sam-ftpd(1M)

sam-genericd(1M)

sam-grau_helper(1M)

sam-ibm3494d(1M)

sam-nrecycler(1M)

sam-recycler(1M)

sam-releaser(1M)

sam-rftd(1M)

sam-robotsd(1M)

sam-rpcd(1M)

sam-scannerd(1M)

sam-serverd(1M)

sam-sharefsd(1M)

sam-shrink(1M)

sam-sony_helper(1M)

sam-sonyd(1M)

sam-stagealld(1M)

sam-stagerd(1M)

sam-stagerd_copy(1M)

sam-stk_helper(1M)

sam-stkd(1M)

samadm(1M)

sambcheck(1M)

samchaid(1M)

samcmd(1M)

samcrondump(1M)

samcronfix(1M)

samd(1M)

samdb(1M)

samexplorer(1M)

samexport(1M)

samfsck(1M)

samfsconfig(1M)

samfsdump(1M)

samfsinfo(1M)

samfsrestore(1M)

samfstyp(1M)

samgetmap(1M)

samgetvol(1M)

samgrowfs(1M)

samimport(1M)

samload(1M)

sammkfs(1M)

samncheck(1M)

samquota(1M)

samquotastat(1M)

samset(1M)

samsharefs(1M)

samsnoop(1M)

samstorade(1M)

samtrace(1M)

samu(1M)

samunhold(1M)

save_core.sh(1M)

scanner(1M)

scsi_trace_decode(1M)

sefreport(1M)

sendtrap(1M)

set_admin(1M)

set_state(1M)

showqueue(1M)

stageall(1M)

stageback.sh(1M)

star(1M)

tapealert(1M)

tarback.sh(1M)

tplabel(1M)

tpverify(1M)

trace_rotate(1M)

umount_samfs(1M)

unarchive(1M)

undamage(1M)

unload(1M)

unrearch(1M)

unreserve(1M)

3.  Library Functions (Man Pages Section 3)

4.  Library Functions (Man Pages Section 3X)

5.  File Formats (Man Pages Section 4)

6.  Standards, Environment, and Macros (Man Pages Section 5)

7.  Device and Network Interfaces (Man Pages Section 7)

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.