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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
|
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; Linux 2.4.18-c0smp i686) [Netscape]">
</head>
<body>
<center>
<h1>
<b>Babel 0.8.x Command Line</b></h1></center>
<h2>
<b>Name</b></h2>
babel - Babel compiler
<br>
<h2>
<b>Synopsis</b></h2>
babel [-h | --help ]
<br>
| [ -v | --version ]
<br>
| [ [ -c<u>targetlanguage</u> |
--client=<u>targetlanguage</u>
<br>
| -s<u>targetlanguage</u> | --server=<u>targetlanguage</u>
<br>
| -x
| --xml
<br>
| -p
| --parse-check
<br>
| -t<u>targetform</u>
| --text=<u>targetform</u>
<br>
| --generate-sidl-stdlib ]
<br>
[ -o<u>outputdirectory</u> | --output-directory=<u>outputdirectory</u>
]
<br>
[ -e<u>regexpression</u> | --exclude=<u>regexpression</u>
]
<br>
[ -g
| -- generate-subdirs ]
<br>
[ -R<u>urlpath</u>
| --repository-path=<u>urlpath</u> ]
<br>
[ --suppress-timestamp]
<br>
[ --no-default-repository ] <u>sidlfilename1</u> [,
<u>sidlfilename2</u>,
... ] ]
<br>
<h2>
<b>Description</b></h2>
Babel is a language interoperability tool intended for
use by the high-
<br> performance scientific computing community.
Developed by the
<br> <a href="http://www.llnl.gov/CASC/components">Components
project</a> at Lawrence Livermore National Laboratory,
<br> Babel supports the <a href="grammar.html">Scientific
Interface Definition Language (SIDL)</a>
<br> for the language-independent declaration of interfaces
associated with
<br> scientific software packages.
<p> The Babel tool, applied to a SIDL file or the corresponding
XML files,
<br> results in the automatic generation of the associated
skeleton, stub, or
<br> text files. That is, source files for the
client and/or server can be automatically
<br> generated. Alternatively, text files containing
XML or SIDL can automatically
<br> be generated. For server side source code,
the Babel user need only add the
<br> necessary code to the impl source files to complete
the provision of a language-
<br> independent interface to the package described by
the SIDL file. The languages
<br> currently supported by Babel on the server-side
are C, C++, F77, F90, Java,
<br> and Python. On the client-side, Babel supports
C, C++, F77, F90, and Python.
<br> The textual representations that can be generated
from SIDL or XML are
<br> XML and SIDL.
<br>
<h2>
<b>Options</b></h2>
-c<u>targetlanguage</u> | --client=<u>targetlanguage</u>
<br> Generate, in the specified
language, only the client code (i.e., the stubs and ior
<br> headers). The
<u>targetlanguage</u>
can be one of C, C++, F77, Java, and Python.
<p> -e<u>regexpression</u> |
--exclude=<u>regularexpression</u>
<br> Do not generate code or
text corresponding to the symbols matching the regular
<br> expression. This option
requires JRE 1.4 virtual machine or higher.
<p> --generate-sidl-stdlib
<br> Generate skeleton and impl
files for the SIDL base classes. It is used by Babel
<br> developers to regenerate
the SIDL base classes in the runtime directory after
<br> a change has been made to
sidl.sidl.
<p> -h | --help
<br> Default option. Display
the command line options before exiting.
<p> --no-repository-default
<br> Prohibit the use of the
<i>repositoryDefault</i>
in finding repositories to resolve symbols.
<p> -o<u>outputdirectory</u> |
--output-directory=<u>outputdirectory</u>
<br> Identify the output directory
to be used as the root of the distribution. By default,
<br> the output directory is
'.'.
<p> -p | --parse-check
<br> Only parse the specified
SIDL file. That is, do not generate the associated code.
<p> -R<u>urlpath</u> | --repository-path=<u>urlpath</u>
<br> Set the search path for
symbol repositories to the specified, semicolon-separated
<br> list of URLs. The
<u>urlpath</u>
is used to search for repositories to resolve symbols.
<p> -s<u>targetlanguage</u> |
--server=<u>targetlanguage</u>
<br> Generate, in the specified
language, the server code (i.e., the stubs, iors, skeletons,
<br> and impls). The <u>targetlanguage</u>
can be one of C, C++, F77, and Python.
<p> --suppressTimestamp
<br> Suppress timestamps on the
generated files. This feature is useful for avoiding
<br> revisions based solely on
changes to the file generation timestamp embedded
<br> within the generated source
codes.
<p> -t<u>targetform</u> | --text=<u>targetform</u>
<br> Generate text in the specified
target format. The targetform can be one of XML
<br> and SIDL. If XML,
the repository will be updated.
<p> -v | --version
<br> Display the Babel compiler
version before exiting.
<p> -x | --xml
<br> DEPRECATED. Use --text=XML
or -tXML instead. Generate SIDL's XML and
<br> update the repository.
<br>
<p>Note: One and only one of the following options can be specified
on a given command line:
<br> -c, --client, -s, --server, --generate-sidl-stdlib,
-x, --xml, -t, --text, -p, --parse-check,
<br> -h, --help, -v, --version.
<br>
<br>
<h2>
Examples</h2>
The examples included here are taken from the <a href="Babel101.html">Babel
101 tutorial</a> and assume
<br> BABEL_HOME points to the directory into which you
installed the Babel
<br> distribution.
<p> % $BABEL_HOME/babel/bin/babel
-sC++ ../hello.sidl
<br>
This generates the C++ server sources (i.e., <i>-sC++</i>) along
with the associated
<br>
makefile fragment, called <i>babel.make,</i> placing all of the generated
files in the
<br>
current directory. The SIDL file, called <i>hello.sidl</i>, is assumed
to be in the directory
<br>
immediately above the current one.
<p> % $BABEL_HOME/babel/bin/babel
-cc hello.sidl
<br>
This generates the C client bindings (i.e., <i>-cc</i>) and the makefile
fragment, called
<br><i>
babel.make, </i>associated with the C stub for the interface defined in
<i>hello.sidl</i>.
<h2>
<b>See Also</b></h2>
A tutorial on the use of Babel to create a "Hello World!"
program using SIDL can be
<br> found in <a href="Babel101.html">Babel 101</a>.
An example of a more involved <a href="hypre.html">SIDL file</a> illustrating
the interface
<br> for the <i><a href="http://www.llnl.gov/CASC/hypre/">hypre</a></i>
library is also available along with the <a href="grammar.html">SIDL grammar</a>.
Crash courses
<br> are also available on <a href="SIDLArray.html">SIDL
Arrays</a> and <a href="SIDLF77.html">Fortran 77</a>.
<br>
</body>
</html>
|
