[Enterprise Extensions only]

The idlc command (IDL compiler)

The Interface Definition Language Compiler (idlc) command creates usage and implementation bindings for interfaces described in IDL files. You use this command to compile one or more files containing CORBA 3.5-compliant IDL statements, and (optionally) to emit generated language bindings appropriate to each named input file.

The syntax for the idlc command is:

idlc [options] filename...

where options are as described in Options for the idlc command, and filename is one (or more, by use of a wildcard character) of your IDL files.

The filenamecan be specified with or without a file name extension. If no file name extension is supplied, it is assumed to be ".idl". The wildcard character or asterisk (*) is permitted to appear one time in the non-path portion of the filename. For example, the following are acceptable ways to refer to xyz.idl in directory E:\idl\src:

Any of the idlc command options can also be specified in the environment by adding the option to the string named IDLC_OPTIONS environment variable. Options specified in the IDLC_OPTIONS variable are treated as if they were keyed on the command line before any of the actual command line options. For example, if:

IDLC_OPTIONS="-mcpponly -mdllname=mydll"

and the command line is:

idlc -ehh idlfile

the result is the same as if the IDLC_OPTIONS variable was not set and the command line was:

idlc -mcpponly -mdllname=mydll -ehh idlfile

Emitters (see -e emit-list in Options for the idlc command) can also be specified in an emit-list held in the IDLC_EMIT environment variable. When you run the idlc command, it looks for emitters specified by the -e or -s options, and also looks in any IDLC_EMIT environment variable. If it cannot find an emit-list in either source, then only the syntax of the named files is checked, and any errors are reported. When a compilation error (but not a warning) is detected for a particular input file, the emit phase for that file is skipped.

When all specified input files are compiled, the idlc command returns a value of zero if no errors were detected; otherwise, a non-zero value is returned.