Provided by: orbit2_2.14.19-0.3_amd64
NAME
orbit-idl-2 - IDL compiler for ORBit2
SYNOPSIS
orbit-idl-2 [ options ] file...
DESCRIPTION
orbit-idl-2 converts object interface descriptions written in CORBA IDL (Interface Definition Language) into C code that you can compile and link into your programs.
OPTIONS
orbit-idl-2 accepts the following options: -d ARG --debug=ARG Set the debug level. Supported levels are 0 to 4, default is 2. --idlwarnlevel=INT Set the warning level for compiler warnings. Supported levels are 0 to 4, default is 2. --showcpperrors Show errors from cpp(1). --small Optimize for size instead of speed. --oldstyle Use the old style IDL compiler (not generally recommended). --skeleton-impl Generate a skeleton-impl file. --nostubs Do not create the stubs file. --noskels Do not create the skels file. --nocommon Do not create the common file. --noheaders Do not create the headers file. --noidata Don't generate Interface type data. -i --imodule Generate only an imodule file (no skels, stubs, etc.). --add-imodule Generate an imodule file (as well as other files generated by default or by other options). --onlytop Inhibit file includes. --pidl Treat source as pseudo-IDL. -D ARG --define=ARG Define name for preprocessor. -I PATH --include=PATH Add search path for include files. --deps=FILENAME Generate dependency information, suitable for inclusion in a Makefile. -l ARG --lang=ARG Specify the output language. The default is C. Support for languages other than C requires the installation of a backend for that language. --backenddir=DIR Specify the directory where a language backend is stored (not necessary if backend is stored in the default directory). --usage Print a very brief usage summary. -? --help Print a slightly more detailed usage summary. -v --version Print version number and serial.
COMPILING
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.
SEE ALSO
orbit2-config(1), cpp(1), indent(1), /usr/share/doc/liborbit2-dev, http://orbit- resource.sourceforge.net, http://www.omg.org.
AUTHOR
Copyright © 2001, 2002 Dick Porter <dick@acm.org> and Elliot Lee <sopwith@redhat.com> This manual was originally written for orbit-idl by Chris Waters <xtifr@debian.org> for Debian GNU/Linux.