1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
5 >The text dump module
</TITLE
8 CONTENT=
"Modular DocBook HTML Stylesheet Version 1.79"><LINK
10 TITLE=
"Linux Trace Toolkit Viewer User Guide"
11 HREF=
"index.html"><LINK
13 TITLE=
"Using LTTV text modules"
14 HREF=
"c159.html"><LINK
16 TITLE=
"Using LTTV text modules"
17 HREF=
"c159.html"></HEAD
28 SUMMARY=
"Header navigation table"
37 >Linux Trace Toolkit Viewer User Guide
</TH
53 >Chapter
4. Using LTTV text modules
</TD
70 >4.2. The text dump module
</A
73 > The goal of this module is to convert the binary data of the traces into
74 a formatted text file.
77 > The text dump module is a good example of a usage of the batch analysis module
78 backend. In fact, the text dump module depends on it. You don't need to
79 explicitly load the batchAnalysis module though, as lttv offers a rich module
80 backend that deals with the dependencies, loading the module automatically if
84 > The text dump module is invoked just like the batchAnalysis module. It adds more
85 options that can be specified in argument. You may specify the -o switch for the
86 output file name of the text dump. You can enable the output of the field names
87 (the identifier of the fields) with the -l switch. The -s switch, for process
88 states, is very useful to indicate the state in which the process is when the
92 > If you use the --help option on the textDump module, you will see all the detail
93 about the switches that can be used to show per cpu statistics and per process
94 statistics. You will notice that you can use both the switches for the
95 batchAnalysis module and those for textDump. You will also notice that the
96 options --process_state (from textDump) and --stats (from batchAnalysis) has the
97 same short name
"-s". If you choose to invoke this option using the short name,
98 it will use the option of the last module loaded just before the -s switch.
101 > For exemple, if you load the textDump module with -m textDump, it will first
102 load the batchAnalysis module, and then load itself. As it is the last module
103 loaded, the -s switch used after it will signify --process_stats. On the other
104 hand, if you choose to specify explicitly the loading of both modules like this
114 >lttv -L path/to/lib/plugins -m batchAnalysis -s\
115 -m textDump -s -t trace
</KBD
119 > The first
"-s" will invoke batchAnalysis --stats and the second
"-s" will invoke
120 textDump --process_state. The list of options generated by --help follows the
121 order of registration of the options by the modules, therefore the invocation
122 order of the modules.
130 SUMMARY=
"Footer navigation table"
165 >Using LTTV text modules
</TD