1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
.\" Process this file with
.\" groff -man -Tascii tao_idl.1
.\"
.TH tao_idl 1 "DECEMBER 1998" "CORBA Tools" "User Manuals"
.SH NAME
tao_idl \- Compile IDL sources for use with the ACE ORB (TAO)
.SH SYNOPSIS
.B tao_idl
.B [
.I OPTION
.B ... ]
filename
.SH DESCRIPTION
.B tao_idl
is a program that is used to compile
.I IDL
source code. The IDL compiler generates 6 files from each .idl file, the file
names are obtained by taking the IDL basename and appending C.h, C.i, C.cpp,
S.h, S.i and S.cpp; the client stubs are declared in the C.h file, the
skeletons in the S.h file. Please see the Options list on how to get different
suffixes for these files.
Both clients and servers should link against the object files for the stubs
and skeletons, this is needed to transparently support collocated objects.
The server skeleton can make use of different lookup strategies to match the
incoming operation with the correct operation at the servant. Dynamic Hashing
and Perfect Hashing are the two different operation lookup strategies that are
currently supported in tao_idl. By default, tao_idl tries to use Perfect
Hashing strategy. If supported and available, gperf generates the lookup
methods for this strategy.
.SH OPTIONS
.TP
.B \-V
the compiler printouts its version and exits
.TP
.BI "\-Wb," "option_list"
pass options to the backend
.Sp
.IP
.BI "export_macro=" "macro_name"
The compiler will emit macro_name right after each class or extern keyword,
this is needed for Windows/NT that requires special directives to export
symbols from DLLs, usually the definition is just a space on unix platforms.
.Sp
.IP
.BI "export_include=" "include_path"
The compiler will generate code to include include_path at the top of the
client header, this is usually a good place to define the export macro.
.TP
.B \-E
only invoke the preprocessor
.TP
.BI "-Wp," "option_list"
pass options to the preprocessor
.TP
.BI "\-D" "macro_definition"
passed to the preprocessor
.TP
.BI "\-U" "macro_name"
passed to the preprocessor
.TP
.BI "\-I" "include_path"
passed to the preprocessor
.TP
.BI "\-A" "assertion"
passed to the preprocessor
.TP
.B \-Y
passed to the preprocessor
.TP
.B "\-H perfect_hash"
To specify the IDL compiler to generate skelton code that uses perfect hashed
operation lookup strategy, which is the default strategy. Perfect hashing uses
gperf program, to generate lookup methods.
.TP
.B "\-H dynamic_hash"
To specify the IDL compiler to generate skelton code that uses dynamic hashed
operation lookup strategy.
.TP
.B "\-H binary_search"
To specify the IDL compiler to generate skelton code that uses binary search
based operation lookup strategy.
.TP
.B "\-H linear_search"
To specify the IDL compiler to generate skelton code that uses linear search
based operation lookup strategy.
.TP
.B \-g
To specify the path for the perfect hasing program (GPERF). Default is
$ACE_ROOT/bin/gperf or whatever the ACE_GPERF macro was defined to be during
compilation of TAO.
based operation lookup strategy.
.TP
.B \-o
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
put in the current directory from where
.B tao_idl
is called.
.TP
.B \-hc
Client's header file name ending. Default is "C.h".
.TP
.B \-hs
Server's header file name ending. Default is "S.h".
.TP
.B \-hT
Server's template header file name ending. Default is "S_T.h".
.TP
.B \-cs
Client stub's file name ending. Default is "C.cpp".
.TP
.B \-ci
Client inline file name ending. Default is "C.i".
.TP
.B \-ss
Server skeleton file name ending. Default is "S.cpp".
.TP
.B \-sT
Server template skeleton file name ending. Default is "S_T.cpp".
.TP
.B \-si
Server inline skeleton file name ending. Default is "S_i.cpp".
.TP
.B \-st
Server's template inline file name ending. Default is "S_T.i".
.TP
.B \-Gc
Generate stubs and skeletons using compiled marshaling.
.TP
.B \-Gi
Generate stubs and skeletons using interpretive marshaling (default for now).
.TP
.B \-Ge
Generate code that uses C++ exceptions (unimplemented as yet).
.TP
.B \-Gt
Generate optimized TypeCodes (unimplemented as yet).
.TP
.B \-Sa
Suppress generation of the
.I Any
operators
.TP
.B \-St
Suppress generation of the
.I TypeCodes
.SH BUGS
(blank for now)
.SH AUTHORS
.IP
Carlos O'Ryan <coryan@cs.wustl.edu>
.IP
Ossama Othman <ossama@debian.org>
performed man page conversion from original HTML source
.SH "SEE ALSO"
.BR gperf (1)
|
