+
|
- ciao_container_type=file |
+ ciao_container_type=file |
- Type of container we are going to use, Session by default. | .
+ Type of container we are going to use, Session by default. |
-
- | -E |
+
+ ‑E |
Invoke only the preprocessor |
|
-
- | -Wp,option_list |
+
+ ‑Wp,option_list |
Pass options to the preprocessor. |
|
- | --syntax-only |
+ ‑‑syntax‑only |
Parse input files, but exit without generating any files. |
|
-
- | --dump -d |
+
+ ‑‑dump -d |
Causes output of a dump of the AST and exits before any files would be
created. |
@@ -592,57 +665,57 @@
- | --dump-builtins |
+ ‑‑dump‑builtins |
Implies --dump, but also dumps IDL defined by the compiler. |
|
- | --just-dump-builtins |
+ ‑‑just‑dump‑builtins |
Dumps IDL defined by the compiler but ignores any files passed and
exits. |
|
-
- | -Dmacro_definition |
+
+ ‑Dmacro_definition |
It is passed to the preprocessor |
|
-
- | -Umacro_name |
+
+ ‑Umacro_name |
It is passed to the preprocessor |
|
-
- | -Iinclude_path |
+
+ ‑Iinclude_path |
It is passed to the preprocessor |
|
-
- | -Aassertion |
+
+ ‑Aassertion |
It is passed to the preprocessor |
|
-
- | -Yp,path |
+
+ ‑Yp,path |
Specifies the path for the C preprocessor |
|
-
- | -H perfect_hash |
+
+ ‑H perfect_hash |
To specify the IDL compiler to generate skeleton code that uses perfect
hashed operation demuxing strategy, which is the default strategy. Perfect
@@ -652,24 +725,24 @@
| |
-
- | -H dynamic_hash |
+
+ ‑H dynamic_hash |
To specify the IDL compiler to generate skeleton code that uses dynamic
hashed operation demuxing strategy. |
|
-
- | -H binary_search |
+
+ ‑H binary_search |
To specify the IDL compiler to generate skeleton code that uses binary
search based operation demuxing strategy. |
|
-
- | -H linear_search |
+
+ ‑H linear_search |
To specify the IDL compiler to generate skeleton code that uses linear
search based operation demuxing strategy. Note that this option is for testing purposes only and should not be used for production code since it's inefficient. |
@@ -677,8 +750,8 @@
-
- | -in |
+
+ ‑in |
To generate #include statements with <>'s for the standard
include files (e.g. tao/corba.h) indicating them as non-changing
files |
@@ -686,29 +759,29 @@
-
- | -ic |
+
+ ‑ic |
To generate #include statements with ""s for changing
standard include files (e.g. tao/corba.h). |
|
-
- | -g path |
+
+ ‑g path |
To specify the path for the perfect hashing program (GPERF). Default
is $ACE_ROOT/bin/ace_gperf. |
|
-
- | -iC path |
+
+ ‑iC path |
Generate #included stubs in *A.h prefixed with this path. |
Default is local filename only (no prefix). |
-
- | -o path |
+
+ ‑o path |
To specify the output directory to IDL compiler as to where all the
IDL-compiler-generated files are to be put. By default, all the files are
@@ -718,86 +791,86 @@
itself already exists, no action is taken. |
-
- | -oS path |
+
+ ‑oS path |
Same as -o option but applies only to generated *S.* files |
Default is value of -o option or current directory |
-
- | -oA path |
+
+ ‑oA path |
Same as -o option but applies only to generated *A.* files |
Default is value of -o option or current directory |
-
- | -oE path |
+
+ ‑oE path |
Same as -o option but applies only to generated *_exec.* files |
Default is value of -o option or current directory |
-
- | -oN path |
+
+ ‑oN path |
Do not overwrite *_exec.* files |
When -Gex option is used, executor implementation files shouldn't be overwritten
if they are already in the output directory. |
-
- | -hc |
+
+ ‑hc |
Client's header file name ending. Default is "C.h". |
|
-
- | -hs |
+
+ ‑hs |
Server's header file name ending. Default is "S.h". |
|
-
- | -hT |
+
+ ‑hT |
Server's template header file name ending. Default is "S_T.h". |
|
-
- | -cs |
+
+ ‑cs |
Client stub's file name ending. Default is "C.cpp". |
|
-
- | -ci |
+
+ ‑ci |
Client inline file name ending. Default is "C.inl". |
|
-
- | -ss |
+
+ ‑ss |
Server skeleton file name ending. Default is "S.cpp". |
|
-
- | -sT |
+
+ ‑sT |
Server template skeleton file name ending. Default is "S_T.cpp". |
|
-
- | -t |
+
+ ‑t |
Temporary directory to be used by the IDL compiler.
|
@@ -808,8 +881,8 @@
-
- | -Cw |
+
+ ‑Cw |
Output a warning if two identifiers in the same scope differ in
spelling only by case (default is output of error message). |
@@ -819,8 +892,8 @@
were not as stringent.
-
- | -Ce |
+
+ ‑Ce |
Output an error if two identifiers in the same scope differ in
spelling only by case (default). |
@@ -828,111 +901,111 @@
|
-
- | -ae |
+
+ ‑ae |
Output an error if an anonymous type is seen. Anonymous types are
deprecated by the OMG spec (default is no output). |
This behavior can be selected globally by defining IDL_ANON_ERROR in
config.h. It may then be overridden locally by
- -aw or -as |
+ ‑aw or ‑as
-
- | -aw |
+
+ ‑aw |
Output a warning if an anonymous type is seen. Anonymous types are
deprecated by the OMG spec (default is no output). |
This behavior can be selected globally by defining IDL_ANON_WARNING in
config.h. It may then be overridden locally by
- -ae or -as |
+ ‑ae or ‑as
-
- | -as |
+
+ ‑as |
Silence any diagnostic output for anonymous types (default). |
This behavior can be selected globally by defining IDL_ANON_SILENT in
config.h. It may then be overridden locally by
- -aw or -ae |
+ ‑aw or ‑ae
-
- | -GC |
+
+ ‑GC |
Generate AMI stubs ("sendc_" methods, reply handler stubs, etc) |
|
-
- | -GH |
+
+ ‑GH |
Generate AMH stubs, skeletons, exception holders, etc. |
|
-
- | -GM |
+
+ ‑GM |
Generate AMI4CCM code |
*A.idl file (containing callback interface, "sendc_" methods
and CCM connector) plus addition to CCM servant and executor |
-
- | -Gp |
+
+ ‑Gp |
Generated collocated stubs that use Thru_POA collocation strategy (default) |
|
-
- | -Gd |
+
+ ‑Gd |
Generated collocated stubs that use Direct collocation strategy |
|
-
- | -Gce |
+
+ ‑Gce |
Generated code for CORBA/e. This reduces the size of the generated code |
|
-
- | -Gmc |
+
+ ‑Gmc |
Generated code for Minimum CORBA. This reduces the size of the generated code |
|
-
- | -Gcl |
+
+ ‑Gcl |
Generated code for LwCCM. This reduces the size of the generated code |
|
-
- | -Gsp |
+
+ ‑Gsp |
Generate client smart proxies |
|
-
- | -Gt |
+
+ ‑Gt |
Generate optimized TypeCodes |
|
-
- | -GX |
+
+ ‑GX |
Generate empty A.h file |
Used by TAO developers for generating an empty A.h file when the
@@ -940,8 +1013,8 @@
|
-
- | -Guc |
+
+ ‑Guc |
Generate uninlined constant if defined in a module |
Inlined (assigned a value in the C++ header file) by default, but this causes a
@@ -950,16 +1023,16 @@
or a valuetype never are - neither case is affected by this option. |
-
- | -Gsd |
+
+ ‑Gsd |
Generate static description operations |
Generate static description operations to retrieve the repository id
or interface name as string. Can be useful for template programming |
-
- | -Gse |
+
+ ‑Gse |
Generate explicit export of sequence's template base class |
Occasionally needed as a workaround for a bug in Visual Studio
@@ -968,71 +1041,71 @@
|
- | -GI |
+ ‑GI |
Generate boiler-plate files that contain empty servant implementations |
|
- | -GIh arg |
+ ‑GIh arg |
Servant implementation header file name ending |
|
- | -GIs arg |
+ ‑GIs arg |
Servant implementation skeleton file name ending |
|
- | -GIb arg |
+ ‑GIb arg |
Prefix to the implementation class names |
|
- | -GIe arg |
+ ‑GIe arg |
Suffix to the implementation class names |
|
- | -GIc |
+ ‑GIc |
Generate copy constructors in the servant implementation template files |
|
- | -GIa |
+ ‑GIa |
Generate assignment operators in the servant implementation template files |
|
- | -GId |
+ ‑GId |
Generate IDL compiler source file/line# debug info in implementation files |
|
-
- | -GT |
+
+ ‑GT |
Enable generation of the TIE classes, and the *S_T.* files that
contain them. |
|
-
- | -GA |
+
+ ‑GA |
Generate type codes and Any operators in *A.h and *A.cpp |
Decouples client and server decisions to compile and link
@@ -1041,21 +1114,21 @@
an empty *A.h file is generated. |
-
- | -Gos |
+
+ ‑Gos |
Generate std::ostream insertion operators for IDL declarations |
ORB IDL declarations (including the basic type sequences) don't
have these operators generated by default, to avoid the increased
footprint. To turn on this generation for ORB IDL files, set
- gen_ostream=1 in your default.features MPC file.
+ gen_ostream=1 in your default.features MPC file.
If this option is used on application IDL that references any of
the predefined basic sequence IDL types, TAO must be compiled
- with the gen_ostream feature turned on. |
+ with the gen_ostream feature turned on.
-
- | -Gata |
+
+ ‑Gata |
Generate the AnyTypeCode_Adapter version of the Any insert policy |
When generating arg traits instantiations, this option forces
@@ -1068,14 +1141,16 @@
application IDL processing or not. |
-
- | -Gsv |
+
+ ‑Gsv |
Generate CIAO servant code for component and home IDL declarations |
+
+ |
-
- | -Gex |
+
+ ‑Gex |
Generate CIAO executor implementation code for component and home IDL declarations |
@@ -1083,119 +1158,121 @@
to be filled in by the developer. |
-
- | -Gexr |
+
+ ‑Gexr |
Generate CIAO executor implementation code for component and home IDL declarations, including
an implementation of the ACE_Reactor |
- When applying -Gexr, the TAO IDL compiler will generate an extra method which
+ | When applying ‑Gexr, the TAO IDL compiler will generate an extra method which
retrieves the ACE_Reactor from the ORB. One should use this option when an ACE_reactor.
In code, use 'this->reactor ()' to get the ACE_Reactor. A CORBA::INTERNAL
exception is thrown when the ACE_Reactor cannot be retrieved.
The goal of this method is to prevent memory leaks. |
-
- | -Gcn |
+
+ ‑Gcn |
Generate CIAO connector implementation code for connector IDL declarations |
Generate a complete implementation for each connector. Specialized at present
for DDS connectors. |
-
- | -Gts |
+
+ ‑Gts |
Generate DDS type support IDL in a separate IDL file |
Not used with OpenDDS, since OpenDDS's IDL processor does this already. |
-
- | -Glem |
+
+ ‑Glem |
Generate CIAO executor IDL for component and home IDL declarations |
+
+ |
-
- | -Gsw |
+
+ ‑Gsw |
Generate CIAO servant code to support component swapping |
Modify the generated servant code and container file includes
to support on-the-fly swapping of components. |
-
- | -Gxhst |
+
+ ‑Gxhst |
Generate the stub export header file |
- This is the file specified in -Wb,stub_export_include=include_path |
+ This is the file specified in ‑Wb,stub_export_include=include_path |
-
- | -Gxhsk |
+
+ ‑Gxhsk |
Generate the skeleton export header file |
- This is the file specified in -Wb,skel_export_include=include_path |
+ This is the file specified in ‑Wb,skel_export_include=include_path |
-
- | -Gxhsv |
+
+ ‑Gxhsv |
Generate the CIAO servant export header file |
- This is the file specified in -Wb,svnt_export_include=include_path |
+ This is the file specified in ‑Wb,svnt_export_include=include_path |
-
- | -Gxhex |
+
+ ‑Gxhex |
Generate the executor export header file |
- This is the file specified in -Wb,exec_export_include=include_path |
+ This is the file specified in ‑Wb,exec_export_include=include_path |
-
- | -Gxhcn |
+
+ ‑Gxhcn |
Generate the connector export header file |
- This is the file specified in -Wb,conn_export_include=include_path |
+ This is the file specified in ‑Wb,conn_export_include=include_path |
-
- | -Sa |
+
+ ‑Sa |
Suppress generation of the Any operators |
|
-
- | -Sal |
+
+ ‑Sal |
Suppress generation of the Any operators for local interfaces only |
|
-
- | -Sat |
+
+ ‑Sat |
Suppress generation of arg traits instantiations |
|
-
- | -Sp |
+
+ ‑Sp |
Suppress generation of collocated stubs that use Thru_POA collocation strategy |
|
-
- | -Sd |
+
+ ‑Sd |
Suppress generation of collocated stubs that use Direct collocation strategy (default) |
|
-
- | -St |
+
+ ‑St |
Suppress generation of typecodes |
@@ -1203,8 +1280,8 @@
associated typecode.
-
- | -Sm |
+
+ ‑Sm |
Suppress C++ code generation from CCM 'implied' IDL. |
This code generation is achieved by default using a 'preprocessing' visitor
@@ -1215,88 +1292,88 @@
so this command line option will suppress it. |
-
- | -SS |
+
+ ‑SS |
Suppress generation of the skeleton implementation and inline file. |
This option doesn't check whether something is generated in the files. It
just suppresses them without looking at any possible contents; |
-
- | -Sci |
+
+ ‑Sci |
Suppress generation of the client inline file. |
This option doesn't check whether something is generated in the file. It
just suppresses it without looking at any possible contents; |
-
- | -Scc |
+
+ ‑Scc |
Suppress generation of the client stub file. |
This option doesn't check whether something is generated in the file. It
just suppresses it without looking at any possible contents; |
-
- | -Sch |
+
+ ‑Sch |
Suppress generation of the client header file. |
This option doesn't check whether something is generated in the file. It
just suppresses it without looking at any possible contents; |
-
- | -Ssi |
+
+ ‑Ssi |
Suppress generation of the servant inline file. |
This option doesn't check whether something is generated in the file. It
just suppresses it without looking at any possible contents; |
-
- | -SS |
+
+ ‑SS |
Suppress generation of the servant skeleton file. |
This option doesn't check whether something is generated in the file. It
just suppresses it without looking at any possible contents; |
-
- | -Ssh |
+
+ ‑Ssh |
Suppress generation of the servant header file. |
This option doesn't check whether something is generated in the file. It
just suppresses it without looking at any possible contents; |
-
- | -Ssvntc |
+
+ ‑Ssvntc |
Suppress generation of the servant implementation file (_svnt.cpp). |
This option doesn't check whether something is generated in the files. It
just suppresses them without looking at any possible contents; |
-
- | -Ssvntt |
+
+ ‑Ssvntt |
Suppress generation of the servant templated files (_svnt_T.{h,cpp}). |
This option doesn't check whether something is generated in the files. It
just suppresses them without looking at any possible contents; |
-
- | -Sorb |
+
+ ‑Sorb |
Suppress generation of the ORB.h include. |
This option is useful when regenerating pidl files in the core
TAO libs to prevent cyclic includes; |
-
- | -Se |
+
+ ‑Se |
Disable custom header file name endings for files
that are found in TAO specific include directories
@@ -1307,8 +1384,8 @@
use TAO specific files with their original endings; |
-
- | -Sg |
+
+ ‑Sg |
Disable generation of unique preprocessor guards for generated
header files. The guards will still be generated, but without
@@ -1320,8 +1397,8 @@
the desired function of the preprocessor in such a system. |
-
- | -Sfr |
+
+ ‑Sfr |
Disable CIAO servant code generation to register valuetype
factories for events. |
@@ -1332,31 +1409,69 @@
valuetype factory class will be abstract and must be overridden
by the user, and registered in hand-written code.
-
- | -TS value |
+
+ ‑TS value |
Set tab size for generated files |
Default is 2 spaces |
- | --unknown-annotations ARG |
+ ‑‑unknown‑annotations ARG |
Controls the reaction when encountering undefined annotations. The valid
- arguments to this option are "warn-once" (Default), "warn-all", "error",
- and "ignore".
+ arguments to this option are warn-once (Default),
+ warn-all, error, and ignore.
|
- The difference between "warn-once" and "warn-all" is that with
- "warn-once" using annotations the same local name will not be warned
- about more than once, while "warn-all" will warn with every usage.
+ The difference between warn-once and warn-all
+ is that with warn-once using annotations the same local name
+ will not be warned about more than once, while warn-all will
+ warn with every usage.
+ |
+
+
+
+ ‑‑preprocessor‑input KIND |
+
+
+ Set the C preprocessor file input method. KIND must be
+ guess (default), direct‑with‑e,
+ direct‑without‑e, direct‑gcc,
+ or copy.
+
+ direct-without-e passes the IDL file path to the
+ preprocessor directly. Most, if not all, standalone C preprocessors like
+ GNU and Clang cpp or mcpp can use this.
+
+ direct-with-e is the same as
+ direct-without-e except ‑E is also
+ passed. CL, the Visual Studio C++ compiler can use this.
+
+ direct‑gcc is same as
+ direct‑with‑e, but it's for g++ and
+ clang++ which also require ‑x c++ to be
+ passed.
+
+ copy makes a copy of the IDL file to a temporary location
+ and passes that to the preprocessor.
+
+ guess picks one of the previous based on the name of the
+ preprocessor.
+ |
+
+
+ Although copy should work with all compilers, it only
+ approximates relative includes using ‑I., which fails under
+ certain conditions. Therefore the direct kinds are preferred by
+ guess.
|