refdes_renum: warn of possible number clash with non-conforming values
[geda-gaf/whiteaudio.git] / docs / wiki / geda-gtkwave_vcd2lxt2_mp.html
blob12a1e8e37b850cf247bffd5884154257d8b0fa17
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html>
4 <head>
5 <title></title>
6 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
7 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
8 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 </head>
12 <body>
15 <h1 class="sectionedit236"><a name="converts_vcd_files_to_lxt2_files_vcd2lxt2" id="converts_vcd_files_to_lxt2_files_vcd2lxt2">Converts VCD files to LXT2 files (vcd2lxt2)</a></h1>
16 <div class="level1">
17 <pre class="code">VCD2LXT2(1) Filetype Conversion VCD2LXT2(1)
21 NAME
22 vcd2lxt2 - Converts VCD files to LXT2 files
24 SYNTAX
25 vcd2lxt2 [option]... [VCDFILE] [LXTFILE]
27 DESCRIPTION
28 Converts VCD files to LXT2 files.
30 OPTIONS
31 -v,--vcdname &lt;filename&gt;
32 Specify VCD input filename.
34 -l,--lxtname &lt;filename&gt;
35 Specify LXT2 output filename.
37 -d,--depth &lt;value&gt;
38 Specify 0..9 gzip compression depth, default is 4.
40 -m,--maxgranule &lt;value&gt;
41 Specify number of granules per section, default is 8. One gran-
42 ule is equal to 32 timsteps.
44 -b,--break &lt;value&gt;
45 Specify break size (default = 0 = off). When the break size is
46 exceeded, the LXT2 dumper will dump all state information at the
47 next convenient granule plus dictionary boundary.
49 -p,--partialmode &lt;mode&gt;
50 Specify partial zip mode 0 = monolithic, 1 = separation. Using
51 a value of 1 expands LXT2 filesize but provides fast access for
52 very large traces. Note that the default mode is neither mono-
53 lithic nor separation: partial zip is disabled.
55 -c,--checkpoint &lt;mode&gt;
56 Specify checkpoint mode. 0 is on which is default, and 1 is
57 off. This is disabled when the break size is active.
59 -h,--help
60 Show help screen.
64 EXAMPLES
66 Note that you should specify dumpfile.vcd directly or use &quot;-&quot; for
67 stdin.
69 vcd2lxt dumpfile.vcd dumpfile.lxt --depth 9 --break 1073741824
70 This sets the compression level to 9 and sets the break size to
71 1GB.
73 vcd2lxt dumpfile.vcd dumpfile.lxt --depth 9 --maxgranule 256
74 Allows more granules per section which allows for greater com-
75 pression.
77 LIMITATIONS
78 vcd2lxt2 does not store glitches as these are coalesced together into
79 one value change during the writing of the LXT2 file.
82 AUTHORS
83 Anthony Bybell &lt;bybell@nc.rr.com&gt;
85 SEE ALSO
86 lxt2vcd(1) vcd2lxt2(1) gtkwave(1)
90 Anthony Bybell 1.3.42 VCD2LXT2(1)</pre>
92 </div>
93 </body>
94 </html>