Print this page
    
NEX-9586 remove nodename from the default savecore directory path
Reviewed by: Dan Fields <dan.fields@nexenta.com>
Reviewed by: Yuri Pankov <yuri.pankov@nexenta.com>
Reviewed by: Sanjay Nadkarni <sanjay.nadkarni@nexenta.com>
    
      
        | Split | 
	Close | 
      
      | Expand all | 
      | Collapse all | 
    
    
          --- old/usr/src/man/man1/tnfxtract.1.man.txt
          +++ new/usr/src/man/man1/tnfxtract.1.man.txt
   1    1  TNFXTRACT(1)                     User Commands                    TNFXTRACT(1)
   2    2  
   3    3  
   4    4  
   5    5  NAME
   6    6         tnfxtract - extract kernel probes output into a trace file
   7    7  
   8    8  SYNOPSIS
   9    9         tnfxtract [-d dumpfile -n namelist] tnf_file
  10   10  
  11   11  
  12   12  DESCRIPTION
  13   13         The tnfxtract utility collects kernel trace output from an in-core
  14   14         buffer in the Solaris kernel, or from the memory image of a crashed
  15   15         system, and generates a binary TNF trace file like those produced
  16   16         directly by user programs being traced.
  17   17  
  18   18  
  19   19         Either both or neither of the -d and -n options must be specified.  If
  20   20         neither is specified, trace output is extracted from the running
  21   21         kernel. If both are specified, the -d argument names the file
  22   22         containing the (crashed) system memory image, and the -n argument names
  23   23         the file containing the symbol table for the system memory image.
  24   24  
  25   25  
  26   26         The TNF trace file tnf_file produced is exactly the same size as the
  27   27         in-core buffer; it is essentially a snapshot of that buffer.  It is
  28   28         legal to run tnfxtract while kernel tracing is active, i.e., while the
  29   29         in-core buffer is being written. tnfxtract insures that the output file
  30   30         it generates is low-level consistent, that is, that only whole probes
  31   31         are written out, and that internal data structures in the buffer are
  32   32         not corrupted because the buffer is being concurrently written.
  33   33  
  34   34  
  35   35         The TNF trace file generated is suitable as input to tnfdump(1), which
  36   36         will generate an ASCII file.
  37   37  
  38   38  OPTIONS
  39   39         The following options are supported:
  40   40  
  41   41         -d dumpfile
  42   42                        Uses dumpfile as the system memory image, instead of the
  43   43                        running kernel.  The dumpfile is normally the path name
  44   44                        of a file generated by the savecore utility.
  45   45  
  46   46  
  47   47         -n namelist
  48   48                        Uses namelist as the file containing the symbol table
  49   49                        information for the given dumpfile.
  50   50  
  51   51  
  52   52  OPERANDS
  53   53         The following operand is supported:
  54   54  
  55   55         tnf_file
  56   56                     Output file generated by tnfxtract based on kernel trace
  57   57                     output from an in-core buffer in the Solaris kernel.
  58   58  
  59   59  
  60   60  EXAMPLES
  61   61         Example 1 Extracting probes from a running kernel
  62   62  
  63   63  
  64   64         Extract probes from the running kernel into ktrace.out:
  65   65  
  66   66  
  
    | 
      ↓ open down ↓ | 
    66 lines elided | 
    
      ↑ open up ↑ | 
  
  67   67           example% tnfxtract ktrace.out
  68   68  
  69   69  
  70   70  
  71   71         Example 2 Extracting probes from a kernel crash dump
  72   72  
  73   73  
  74   74         Extract probes from a kernel crash dump into ktrace.out:
  75   75  
  76   76  
  77      -         example% tnfxtract -d /var/crash/`uname -n`/vmcore.0 \
  78      -            -n /var/crash/`uname -n`/unix.0 ktrace.out
       77 +         example% tnfxtract -d /var/crash/data/UUID/core.0 \
       78 +            -n /var/crash/data/UUID/unix.0 ktrace.out
  79   79  
  80   80  
  81   81  
  82   82  EXIT STATUS
  83   83         The following exit values are returned:
  84   84  
  85   85         0
  86   86               Successful completion.
  87   87  
  88   88  
  89   89         >0
  90   90               An error occurred.
  91   91  
  92   92  
  93   93  SEE ALSO
  94   94         prex(1), tnfdump(1), savecore(1M), tnf_kernel_probes(4), attributes(5)
  95   95  
  96   96  
  97   97  
  98      -                                August 19, 2003                   TNFXTRACT(1)
       98 +                               February 13, 2017                  TNFXTRACT(1)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX