|
Server : Apache/2.2.2 (Fedora) System : Linux App1.pathumtani.go.th 2.6.20-1.2320.fc5smp #1 SMP Tue Jun 12 19:40:16 EDT 2007 i686 User : apache ( 48) PHP Version : 5.2.9 Disable Function : NONE Directory : /usr/share/wireshark/ |
Upload File : |
<?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 0.99.5</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body style="background-color: white">
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<!--
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsys">SYNOPSYS</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>
-->
<!-- 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="synopsys">SYNOPSYS</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 an <strong>Wireshark</strong> ``plugin''.</p>
<p>This resulting file can be compiled as an <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>wireshark(1), <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="item_improve_explicit_dissection_code_2e">Improve Explicit dissection code.</a></strong>
<li><strong><a name="item_improve_command_line_options_2e">Improve command line options.</a></strong>
<li><strong><a name="item_improve_decode_algorithm_when_we_have_operation_na">Improve decode algorithm when we have operation name collision.</a></strong>
</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>