idl2wrs(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | SEE ALSO | NOTES | TODO | AUTHORS

IDL2WRS(1)                                                     IDL2WRS(1)

NAME         top

       idl2wrs - CORBA IDL to Wireshark Plugin Generator

SYNOPSIS         top

       idl2wrs <filename>

DESCRIPTION         top

       idl2wrs is a program that takes a user specified CORBA IDL file
       and generates "C" source code for a Wireshark "plugin".

       This resulting file can be compiled as a Wireshark plugin, and
       used to monitor GIOP/IIOP traffic that is using this IDL.

       idl2wrs is actually a shell script wrapper for two Python
       programs. These programs are:

       •   wireshark_be.py Contains the main IDL Visitor Class

       •   wireshark_gen.py Contains the Source Code Generator Class

       idl2wrs 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.

OPTIONS         top

       Currently there are no options. idl2wrs can be invoked as follows.

        1. To write the C code to stdout.

               idl2wrs  <your_file.idl>

               eg: idl2wrs echo.idl

        2. To write to a file, just redirect the output.

               idl2wrs echo.idl > packet-test.c

ENVIRONMENT         top

       idl2wrs will look for wireshark_be.py and wireshark_gen.py in
       $PYTHONPATH/site-packages/ and if not found, will try the current
       directory ./

       The -p option passed to omniidl (inside idl2wrs) indicates where
       wireshark_be.py and wireshark_gen.py will be searched. This may
       need tweaking if you place these files somewhere else.

       If it complains about being unable to find some modules (eg
       tempfile.py), you may want to check if PYTHONPATH is set
       correctly.

       eg:  PYTHONPATH=/usr/lib/python3/

SEE ALSO         top

       wireshark(1), tshark(1)

NOTES         top

       idl2wrs (including wireshark_be.py and wireshark_gen.py) are part
       of the Wireshark distribution. The latest version of Wireshark can
       be found at https://www.wireshark.org.

       idl2wrs uses omniidl, an IDL parser, and can be found at
       http://omniorb.sourceforge.net/

TODO         top

       Some of the more important things to do are:

       •   Improve Explicit dissection code.

       •   Improve command line options.

       •   Improve decode algorithm when we have operation name
           collision.

AUTHORS         top

       Original Author
       Frank Singleton <frank.singleton[AT]ericsson.com>.SH COLOPHON This
       page is part of the wireshark (Interactively dump and analyze
       network traffic) project. Information about the project can be
       found at ⟨https://www.wireshark.org/⟩. If you have a bug report
       for this manual page, see
       ⟨https://gitlab.com/wireshark/wireshark/-/issues⟩. This page was
       obtained from the project's upstream Git repository
       ⟨https://gitlab.com/wireshark/wireshark.git⟩ on 2025-08-11. (At
       that time, the date of the most recent commit that was found in
       the repository was 2025-08-11.) If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       [email protected]

                                2025-03-07                     IDL2WRS(1)