orbit-idl-2(1) IDL compiler for ORBit2


orbit-idl-2 [ options ] file...


converts object interface descriptions written in CORBA IDL (Interface Definition Language) into C code that you can compile and link into your programs.


orbit-idl-2 accepts the following options:

-d ARG

Set the debug level. Supported levels are 0 to 4, default is 2.
Set the warning level for compiler warnings. Supported levels are 0 to 4, default is 2.
Show errors from cpp(1).
Optimize for size instead of speed.
Use the old style IDL compiler (not generally recommended).
Generate a skeleton-impl file.
Do not create the stubs file.
Do not create the skels file.
Do not create the common file.
Do not create the headers file.
Don't generate Interface type data.


Generate only an imodule file (no skels, stubs, etc.).
Generate an imodule file (as well as other files generated by default or by other options).
Inhibit file includes.
Treat source as pseudo-IDL.


Define name for preprocessor.


Add search path for include files.
Generate dependency information, suitable for inclusion in a Makefile.

-l ARG

Specify the output language. The default is C. Support for languages other than C requires the installation of a backend for that language.
Specify the directory where a language backend is stored (not necessary if backend is stored in the default directory).
Print a very brief usage summary.


Print a slightly more detailed usage summary.


Print version number and serial.


The IDL file(s) compiled by orbit-idl-2 define the interfaces to network-transparent objects. These files are first passed to cpp(1), the C Preprocessor, then the result is parsed, and the C code is generated.

 By default, orbit-idl-2 generates four files, the stubs, skels, common, and header files. If your input file is named sample.idl, then the output files will be named, respectively, sample-stubs.c, sample-skels.c, sample-common.c, and sample.h. You can optionally also generate a skeleton-impl file (which would be named sample-skelimpl.c in our example), or an imodule file (e.g. sample-imodule.c). These files require manual editing to be useful, and is therefore not generated by default.

The generated C files are formatting ("pretty-printed") using indent(1). You can use another program for this if you prefer, with the --c-output-formatter argument.


Copyright © 2001, 2002 Dick Porter <[email protected]> and Elliot Lee <[email protected]>

This manual was originally written for orbit-idl by Chris Waters <[email protected]> for Debian GNU/Linux.