/usr/share/wireshark/idl2wrs.html is in libwireshark-data 1.6.7-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 | <?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>idl2wrs - The Wireshark Network Analyzer 1.6.7</title>
<link rel="stylesheet" href="../docbook/ws.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body>
<!-- INDEX BEGIN -->
<div name="index">
<p><a name="__index__"></a></p>
<!--
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#options">OPTIONS</a></li>
<li><a href="#environment">ENVIRONMENT</a></li>
<li><a href="#see_also">SEE ALSO</a></li>
<li><a href="#notes">NOTES</a></li>
<li><a href="#todo">TODO</a></li>
<li><a href="#authors">AUTHORS</a></li>
</ul>
-->
</div>
<!-- INDEX END -->
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>idl2wrs - CORBA IDL to Wireshark Plugin Generator</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<p><strong>idl2wrs</strong> filename</p>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p><strong>idl2wrs</strong> is a program that takes a user specified <strong>CORBA IDL</strong>
file and generates <strong>"C"</strong> source code for a <strong>Wireshark</strong> "plugin".</p>
<p>This resulting file can be compiled as a <strong>Wireshark</strong> plugin, and
used to monitor <strong>GIOP/IIOP</strong> traffic that is using this IDL.</p>
<p><strong>idl2wrs</strong> is actually a shell script wrapper for two <strong>Python</strong> programs.</p>
<p>These programs are:</p>
<p><strong>wireshark_be.py</strong> - Contains the main IDL Visitor Class</p>
<p><strong>wireshark_gen.py</strong> - Contains the Source Code Generator Class</p>
<p><strong>idl2wrs</strong> supports heuristic dissection of GIOP/IIOP traffic,
and some experimental code for explicit dissection, based on
Object Key <-> Repository Id mapping.
However, code for heuristic based plugins is
generated by default, and users should consider this the preferred
method unless you have some namespace collisions.</p>
<p>
</p>
<hr />
<h1><a name="options">OPTIONS</a></h1>
<p>Currently there are no options. <strong>idl2wrs</strong> can be invoked as follows.</p>
<p>1. To write the C code to stdout.</p>
<pre>
idl2wrs <your_file.idl></pre>
<pre>
eg: idl2wrs echo.idl</pre>
<p>2. To write to a file, just redirect the output.</p>
<pre>
idl2wrs echo.idl > packet-test.c</pre>
<p>
</p>
<hr />
<h1><a name="environment">ENVIRONMENT</a></h1>
<p><strong>idl2wrs</strong> will look for <strong>wireshark_be.py</strong> and <strong>wireshark_gen.py</strong> in
<strong>$PYTHONPATH/site-packages/</strong> and if not found, will try the current
directory <strong>./</strong></p>
<p>The <strong>-p</strong> option passed to omniidl (inside <strong>idl2wrs</strong>) indicates where
<strong>wireshark_be.py</strong> and <strong>wireshark_gen.py</strong> will be searched. This may
need tweaking if you place these files somewhere else.</p>
<p>If it complains about being unable to find some modules (eg tempfile.py),
you may want to check if PYTHONPATH is set correctly.</p>
<p>eg: PYTHONPATH=/usr/lib/python1.5/</p>
<p>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
<p><code>wireshark(1)</code>, <code>tshark(1)</code></p>
<p>
</p>
<hr />
<h1><a name="notes">NOTES</a></h1>
<p><strong>idl2wrs</strong> (including <strong>wireshark_be.py</strong> and <strong>wireshark_gen.py</strong>) are part of
the <strong>Wireshark</strong> distribution. The latest version of <strong>Wireshark</strong> can
be found at <a href="http://www.wireshark.org">http://www.wireshark.org</a>.</p>
<p><strong>idl2wrs</strong> uses <strong>omniidl</strong>, an IDL parser, and can be found at
<a href="http://omniorb.sourceforge.net/">http://omniorb.sourceforge.net/</a></p>
<p>
</p>
<hr />
<h1><a name="todo">TODO</a></h1>
<p>Some of the more important things to do are:</p>
<ul>
<li><strong><a name="improve_explicit_dissection_code" class="item">Improve Explicit dissection code.</a></strong>
</li>
<li><strong><a name="improve_command_line_options" class="item">Improve command line options.</a></strong>
</li>
<li><strong><a name="improve_decode_algorithm_when_we_have_operation_name_collision" class="item">Improve decode algorithm when we have operation name collision.</a></strong>
</li>
</ul>
<p>
</p>
<hr />
<h1><a name="authors">AUTHORS</a></h1>
<pre>
Original Author
-------- ------
Frank Singleton <frank.singleton[AT]ericsson.com></pre>
<pre>
Contributors
------------</pre>
</body>
</html>
|