1IDL2WRS(1)              The Wireshark Network Analyzer              IDL2WRS(1)
2
3
4

NAME

6       idl2wrs - CORBA IDL to Wireshark Plugin Generator
7

SYNOPSIS

9       idl2wrs filename
10

DESCRIPTION

12       idl2wrs is a program that takes a user specified CORBA IDL file and
13       generates "C" source code for a Wireshark "plugin".
14
15       This resulting file can be compiled as a Wireshark plugin, and used to
16       monitor GIOP/IIOP traffic that is using this IDL.
17
18       idl2wrs is actually a shell script wrapper for two Python programs.
19
20       These programs are:
21
22           wireshark_be.py  - Contains the main IDL Visitor Class
23
24           wireshark_gen.py - Contains the Source Code Generator Class
25
26       idl2wrs supports heuristic dissection of GIOP/IIOP traffic, and some
27       experimental code for explicit dissection, based on Object Key <->
28       Repository Id mapping.  However, code for heuristic based plugins is
29       generated by default, and users should consider this the preferred
30       method unless you have some namespace collisions.
31

OPTIONS

33       Currently there are no options. idl2wrs can be invoked as follows.
34
35       1.  To write the C code to stdout.
36
37           idl2wrs  <your_file.idl>
38
39           eg: idl2wrs echo.idl
40
41       2. To write to a file, just redirect the output.
42
43           idl2wrs echo.idl > packet-test.c
44

ENVIRONMENT

46       idl2wrs will look for wireshark_be.py and wireshark_gen.py in
47       $PYTHONPATH/site-packages/ and if not found, will try the current
48       directory ./
49
50       The -p option passed to omniidl (inside idl2wrs) indicates where
51       wireshark_be.py and wireshark_gen.py will be searched.  This may need
52       tweaking if you place these files somewhere else.
53
54       If it complains about being unable to find some modules (eg
55       tempfile.py), you may want to check if PYTHONPATH is set correctly.
56
57       eg:  PYTHONPATH=/usr/lib/python1.5/
58

SEE ALSO

60       wireshark(1), tshark(1)
61

NOTES

63       idl2wrs (including wireshark_be.py and wireshark_gen.py) are part of
64       the Wireshark distribution.  The latest version of Wireshark can be
65       found at <http://www.wireshark.org>.
66
67       idl2wrs uses omniidl, an IDL parser, and can be found at
68       <http://omniorb.sourceforge.net/>
69

TODO

71       Some of the more important things to do are:
72
73       ·   Improve Explicit dissection code.
74
75       ·   Improve command line options.
76
77       ·   Improve decode algorithm when we have operation name collision.
78

AUTHORS

80         Original Author
81         -------- ------
82         Frank Singleton             <frank.singleton[AT]ericsson.com>
83
84
85         Contributors
86         ------------
87
88
89
901.4.10                            2011-11-01                        IDL2WRS(1)
Impressum