4 idl2wrs - CORBA IDL to Wireshark Plugin Generator
12 B<idl2wrs> is a program that takes a user specified B<CORBA IDL>
13 file and generates B<"C"> source code for an B<Wireshark> "plugin".
15 This resulting file can be compiled as an B<Wireshark> plugin, and
16 used to monitor B<GIOP/IIOP> traffic that is using this IDL.
18 B<idl2wrs> is actually a shell script wrapper for two B<Python> programs.
24 B<wireshark_be.py> - Contains the main IDL Visitor Class
26 B<wireshark_gen.py> - Contains the Source Code Generator Class
30 B<idl2wrs> supports heuristic dissection of GIOP/IIOP traffic,
31 and some experimental code for explicit dissection, based on
32 Object Key <-> Repository Id mapping.
33 However, code for heuristic based plugins is
34 generated by default, and users should consider this the preferred
35 method unless you have some namespace collisions.
40 Currently there are no options. B<idl2wrs> can be invoked as follows.
42 1. To write the C code to stdout.
44 idl2wrs <your_file.idl>
49 2. To write to a file, just redirect the output.
51 idl2wrs echo.idl > packet-test.c
58 B<idl2wrs> will look for B<wireshark_be.py> and B<wireshark_gen.py> in
59 B<$PYTHONPATH/site-packages/> and if not found, will try the current
62 The B<-p> option passed to omniidl (inside B<idl2wrs>) indicates where
63 B<wireshark_be.py> and B<wireshark_gen.py> will be searched. This may
64 need tweaking if you place these files somewhere else.
66 If it complains about being unable to find some modules (eg tempfile.py),
67 you may want to check if PYTHONPATH is set correctly.
69 eg: PYTHONPATH=/usr/lib/python1.5/
79 B<idl2wrs> (including B<wireshark_be.py> and B<wireshark_gen.py>) are part of
80 the B<Wireshark> distribution. The latest version of B<Wireshark> can
81 be found at B<http://www.wireshark.org>.
83 B<idl2wrs> uses B<omniidl>, and IDL parser, and can be found at
84 B<http://omniorb.sourceforge.net/>
88 Some of the more important things to do are:
93 Improve Explicit dissection code.
96 Improve command line options.
99 Improve decode algorithm when we have operation name collision.
107 Frank Singleton <frank.singleton[AT]ericsson.com>