tnfxtract(1)




NAME

     tnfxtract - extract kernel probes output into a trace file


SYNOPSIS

     tnfxtract [ -d dumpfile -n namelist] tnf_file


DESCRIPTION

     The tnfxtract utility collects kernel trace output  from  an
     in-core  buffer  in  the  Solaris kernel, or from the memory
     image of a crashed system, and generates a binary TNF  trace
     file  like  those  produced  directly by user programs being
     traced.

     Either both or neither of the -d  and  -n  options  must  be
     specified.    If  neither  is  specified,  trace  output  is
     extracted from the running kernel.  If both  are  specified,
     the -d argument names the file containing the (crashed) sys-
     tem memory image, and the -n argument names  the  file  con-
     taining the symbol table for the system memory image.

     The TNF trace file tnf_file produced  is  exactly  the  same
     size  as the in-core buffer; it is essentially a snapshot of
     that buffer.  It is legal  to  run  tnfxtract  while  kernel
     tracing  is  active, i.e., while the in-core buffer is being
     written. tnfxtract insures that the output file it generates
     is  low-level  consistent,  i.e., that only whole probes are
     written out, and that internal data structures in the buffer
     are  not  corrupted because the buffer is being concurrently
     written.

     The TNF  trace  file  generated  is  suitable  as  input  to
     tnfdump(1), which will generate an ASCII file.


OPTIONS

     The following options are supported:

     -d dumpfile
           Use  dumpfile as the system memory image,  instead  of
           the  running kernel. The dumpfile is normally the path
           name of a file generated by the savecore utility.

     -n namelist
           Use namelist as the file containing the  symbol  table
           information for the given dumpfile.


OPERANDS

     The following operand is supported:

     tnf_file
           output file generated by  tnfxtract  based  on  kernel
           trace  output  from  an  in-core buffer in the Solaris
           kernel.


EXAMPLES

     Example 1: Extracting probes from a running kernel

     Extract probes from the running kernel into ktrace.out:

     example% tnfxtract ktrace.out

     Example 2: Extracting probes from a kernel crash dump

     Extract probes from a kernel crash dump into ktrace.out:

     example% tnfxtract -d /var/crash/`uname -n`/vmcore.0 \
        -n /var/crash/`uname -n`/unix.0 ktrace.out


EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     >0    An error occurred.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWtnfc (32-bit)           |
    |_____________________________|_____________________________|
    |                             | SUNWtnfcx (64-bit)          |
    |_____________________________|_____________________________|


SEE ALSO

     prex(1),  tnfdump(1),  savecore(1M),   tnf_kernel_probes(4),
     attributes(5)


Man(1) output converted with man2html