orbit-idl-2(1) User Commands orbit-idl-2(1)NAMEorbit-idl-2 - ORBit IDL compiler
SYNOPSISorbit-idl-2 [--define=string ] [--include=string] [--libIDL-version]
[--lang=string] [--debug=int] [--idlwarnlevel=int] [--imodule]
[--showcpperrors] [--nostubs] [--noskels] [--nocommon] [--noheaders]
[--noidata] [--add-imodule] [--skeleton-impl] [--backenddir=dir] [--c-
output-formatter=program] [--onlytop] [--pidl] [--nodefskels]
[--deps=filename] [--headerguardprefix=string] [--usage] [--version]
[--help] idlfile
DESCRIPTIONorbit-idl-2 is the ORBit Interface Definition Language (IDL) compiler.
It takes as input an IDL file, and produces as output a set of source
code files which you can use to develop an application that implements
and/or uses the CORBA interface defined in the IDL file.
OPTIONS
The following options are supported:
--add-imodule Output an interface type data file.
--backenddir=dir Override the IDL backend library direc‐
tory.
--c-output-formatter=program Specify the program with which to for‐
mat output (normally, indent).
-d, --debug=int Set the debug level. Valid values are
in the range 0 to 4 inclusive.
-D--define=string Define value in preprocessor. This
option is passed directly to cpp(1).
--deps=filename Generate dependency information suit‐
able for inclusion in a Makefile.
--headerguardprefix=string Prefix for #ifdef header guards. Some‐
times useful to avoid conflicts.
-?, --help Show help information on standard out‐
put, and exit.
--idlwarnlevel=int Set the IDL warning level. Valid values
are in the range 0 to 4 inclusive. The
default value is 2.
-i, --imodule Output only an interface type data
file.
-I, --include=string Add search path for include files. This
option is passed directly to cpp(1).
-l, --lang=string Display the language (the default is
C).
--libIDL-version Show version of libIDL used. See
libIDL-2(3).
--nocommon Do not output a common file.
--nodefskels Do not output definitions for skeletals
in header.
--noheaders Do not output a header file.
--noidata Do not generate interface type data.
--noskels Do not output a skeletals file.
--nostubs Do not output a stubs file.
--onlytop Inhibit inclusion of IDL files.
--pidl Treat the input as Pseudo IDL.
--showcpperrors Show C preprocessor errors.
--skeleton-impl Output a skeletal object implementa‐
tion.
--usage Display brief usage information.
-v, --version Display the compiler version and
serial.
OPERANDS
The following operands are supported:
filename The name of the input IDL file to be
processed by the compiler.
EXAMPLES
Example 1: Compiling an IDL file
example% orbit-idl-2 example.idl
The following files are output:
example.h example-stubs.c example-skels.c example-common.c
Example 2: Compiling an IDL file for use as a client of the interface
only
example% orbit-idl-2--noskels example.idl
The following files are output:
example.h example-stubs.c example-common.c
Example 3: Compiling an IDL file for use as a servant of the interface
only
example% orbit-idl-2--nostubs example.idl
The following files are output:
example.h example-skels.c example-common.c
Example 4: Compiling an IDL file that includes IDL files located in a
non-standard directory
example% orbit-idl-2-I /example-idl-location example.idl
In this example, example.idl includes example-included.idl, which is
located in /example-idl-location/example-included.idl.
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
>0 Application exited with failure
FILES
The following files are used by this application:
/usr/bin/orbit-idl-2 Executable for the ORBit IDL compiler
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWgnome-component-devel │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOcpp(1), libIDL-2(3), libORBit-2(3), attributes(5)NOTES
The output source code is specific to ORBit and should not be used with
any other Object Request Broker (ORB), with any other version of ORBit,
or on a platform other than the one on which the IDL compiler was
itself compiled.
Written by Mark McLoughlin, Sun Microsystems Inc., 2003, 2006.
SunOS 5.11 11 Jan 2003 orbit-idl-2(1)