tnfxtract(1)

1tnfxtract(1)                     User Commands                    tnfxtract(1)
2
3
4

NAME

6       tnfxtract - extract kernel probes output into a trace file
7

SYNOPSIS

9       tnfxtract [-d dumpfile -n namelist] tnf_file
10
11

DESCRIPTION

13       The tnfxtract utility collects kernel trace output from an in-core buf‐
14       fer in the Solaris kernel, or from the memory image of a  crashed  sys‐
15       tem, and generates a binary TNF trace file like those produced directly
16       by user programs being traced.
17
18
19       Either both or neither of the -d and -n options must be  specified.  If
20       neither  is  specified, trace output is extracted from the running ker‐
21       nel. If both are specified, the -d argument names the  file  containing
22       the  (crashed)  system memory image, and the -n argument names the file
23       containing the symbol table for the system memory image.
24
25
26       The TNF trace file tnf_file produced is exactly the same  size  as  the
27       in-core  buffer;  it  is  essentially a snapshot of that buffer.  It is
28       legal to run tnfxtract while kernel tracing is active, i.e., while  the
29       in-core buffer is being written. tnfxtract insures that the output file
30       it generates is low-level consistent, that is, that only  whole  probes
31       are  written  out,  and that internal data structures in the buffer are
32       not corrupted because the buffer is being concurrently written.
33
34
35       The TNF trace file generated is suitable as input to tnfdump(1),  which
36       will generate an ASCII file.
37

OPTIONS

39       The following options are supported:
40
41       -d dumpfile    Uses dumpfile as the system memory image, instead of the
42                      running kernel. The dumpfile is normally the  path  name
43                      of a file generated by the savecore utility.
44
45
46       -n namelist    Uses  namelist  as  the file containing the symbol table
47                      information for the given dumpfile.
48
49

OPERANDS

51       The following operand is supported:
52
53       tnf_file    Output file generated by tnfxtract based  on  kernel  trace
54                   output from an in-core buffer in the Solaris kernel.
55
56

EXAMPLES

58       Example 1 Extracting probes from a running kernel
59
60
61       Extract probes from the running kernel into ktrace.out:
62
63
64         example% tnfxtract ktrace.out
65
66
67
68       Example 2 Extracting probes from a kernel crash dump
69
70
71       Extract probes from a kernel crash dump into ktrace.out:
72
73
74         example% tnfxtract -d /var/crash/`uname -n`/vmcore.0 \
75            -n /var/crash/`uname -n`/unix.0 ktrace.out
76
77
78

EXIT STATUS

80       The following exit values are returned:
81
82       0     Successful completion.
83
84
85       >0    An error occurred.
86
87

ATTRIBUTES

89       See attributes(5) for descriptions of the following attributes:
90
91
92
93
94       ┌─────────────────────────────┬─────────────────────────────┐
95       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
96       ├─────────────────────────────┼─────────────────────────────┤
97       │Availability                 │SUNWtnfc                     │
98       └─────────────────────────────┴─────────────────────────────┘
99