Downloaded and integrated latest wiki documentation from the geda website.
[geda-gaf/whiteaudio.git] / docs / wiki / geda_gtkwave_mp.html
blob01f8f6b1a8278bedd17cf5d4528b7ea7c57969bc
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
4 lang="en" dir="ltr">
5 <head>
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7 <title>geda:gtkwave_mp</title>
8 <meta name="generator" content="DokuWiki Release rc2007-05-24" />
9 <meta name="robots" content="index,follow" />
10 <meta name="date" content="2007-05-24T22:27:25-0400" />
11 <meta name="keywords" content="geda,gtkwave_mp" />
12 <link rel="search" type="application/opensearchdescription+xml" href="http://geda.seul.org/wiki/lib/exe/opensearch.php" title="geda Wiki" />
13 <link rel="start" href="http://geda.seul.org/wiki/" />
14 <link rel="contents" href="http://geda.seul.org/wiki/geda:gtkwave_mp?do=index" title="Index" />
15 <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="http://geda.seul.org/wiki/feed.php" />
16 <link rel="alternate" type="application/rss+xml" title="Current Namespace" href="http://geda.seul.org/wiki/feed.php?mode=list&ns=geda" />
17 <link rel="alternate" type="text/html" title="Plain HTML" href="http://geda.seul.org/wiki/_export/xhtml/geda:gtkwave_mp" />
18 <link rel="alternate" type="text/plain" title="Wiki Markup" href="http://geda.seul.org/wiki/_export/raw/geda:gtkwave_mp" />
19 <link rel="stylesheet" media="all" type="text/css" href="lib/exe/css" />
20 <link rel="stylesheet" media="screen" type="text/css" href="lib/exe/001css" />
21 <link rel="stylesheet" media="print" type="text/css" href="lib/exe/002css" />
22 </head>
23 <body>
24 <div class="dokuwiki export">
28 <h1><a name="visualization_tool_for_vcd_lxt_and_vzt_files_gtkwave" id="visualization_tool_for_vcd_lxt_and_vzt_files_gtkwave">Visualization tool for VCD, LXT, and VZT files (gtkwave)</a></h1>
29 <div class="level1">
30 <pre class="code">GTKWAVE(1) Simulation Wave Viewer GTKWAVE(1)
34 NAME
35 gtkwave - Visualization tool for VCD, LXT, and VZT files
37 SYNTAX
38 gtkwave [option]... [DUMPFILE] [SAVEFILE] [RCFILE]
41 DESCRIPTION
42 Visualization tool for VCD, LXT, LXT2, and VZT. VCD is an industry
43 standard simulation dump format. LXT, LXT2, and VZT have been designed
44 specifically for use with gtkwave. Native dumpers exist in Icarus Ver-
45 ilog for the LXT formats so conversion with vcd2lxt(1) or vcd2lxt2(1)
46 is not necessary to take direct advantage of LXT with that simulator.
47 AET2 files can also be processed provided that libae2rw is available
48 but this is only of interest to people who use IBM EDA toolsets.
50 OPTIONS
51 -n,--nocli &lt;directory name&gt;
52 Use file requester for dumpfile name
54 -f,--dump &lt;filename&gt;
55 Specify dumpfile name.
57 -r,--rcfile &lt;filename&gt;
58 Specify override .gtkwaverc filename.
60 -i,--indirect &lt;filename&gt;
61 Specify indirect facs file name. The file contains a series of
62 regular expressions used to limit what signals can be browsed.
63 Signal names which match any of the regular expressions will be
64 viewable. Typically, indirect files are used to reduce memory
65 requirements for extremely large models containing millions of
66 facilities or to strip out top-level hierarchy clutter from
67 BugSpray models. This feature is only available with the AET2
68 loader.
70 -l,--logfile &lt;filename&gt;
71 Specify simulation logfile name. Multiple logfiles may be spec-
72 ified by preceeding each with the command flag. By selecting
73 the numbers in the text widget, the marker will immediately zoom
74 to the specific time value.
76 -d,--defaultskip
77 If there is not a .gtkwaverc file in the home directory or cur-
78 rent directory and it is not explicitly specified on the command
79 line, when this option is enabled, do not use an implicit con-
80 figuration file and instead default to the old &quot;whitescreen&quot;
81 behavior.
83 -s,--start &lt;time&gt;
84 Specify start time for LXT2/VZT block skip.
86 -e,--end &lt;time&gt;
87 Specify end time for LXT2/VZT block skip.
89 -c,--cpu &lt;numcpus&gt;
90 Specify number of CPUs available for parallelizable ops (e.g.,
91 block prefetching on VZT reads).
93 -v,--vcd
94 Use stdin as a VCD dumpfile.
96 -V,--version
97 Display version banner then exit.
99 -h,--help
100 Display help then exit.
102 -x,--exit
103 Exit after loading trace (for loader benchmarking).
105 FILES
106 ~/.gtkwaverc
109 EXAMPLES
110 To run this program the standard way type:
111 gtkwave dumpfile.vcd
113 Alternatively you can run it with a save file as:
114 gtkwave dumpfile.vcd dumpfile.sav
116 Command line options are not necessary for representing the dumpfile,
117 savefile, and rcfile names. They are merely provided to allow specify-
118 ing them out of order. Note that on non-glibc systems, the long com-
119 mand line options will not be available and that the short ones will
120 have to be used instead.
122 AUTHORS
123 Anthony Bybell &lt;bybell@nc.rr.com&gt;
125 SEE ALSO
126 lxt2vcd(1) vcd2lxt(1) vcd2lxt2(1) vzt2vcd(1) vcd2vzt(1)
130 Anthony Bybell 1.3.70 GTKWAVE(1)</pre>
132 </div>
133 </div>
134 </body>
135 </html>