radadrgen - code generator
radadrgen [-h] [-d DIRECTORY] [-k] -l {c,java,python} -s
{client,server} [-v]
adr
radadrgen(1) User Commands radadrgen(1)
NAME
radadrgen - code generator
SYNOPSIS
radadrgen [-h] [-d DIRECTORY] [-k] -l {c,java,python} -s
{client,server} [-v]
adr
DESCRIPTION
The radadrgen command is the ADR IDL processing tool. It may be used to
generate language bindings for RAD client or server implementations.
All invocations validate the given document against the ADR schema.
OPTIONS
The following options are supported:
-h, --help
Shows the help message and exits.
-d DIRECTORY, --directory DIRECTORY
Specifies an output directory. If none is specified, the current
directory is used.
-k, --keep
Does not overwrite the existing output. If this flag is not speci-
fied, radadrgen will over-write the existing output files.
-l {c,java,python}, --language {c,java,python}
Specifies the language for which bindings should be generated. The
list of supported languages (for both client and server side) is
present in the help message.
Note -
Not all language/side options are supported. Attempting to invoke
an unsupported combination will result in an error message.
-s {client,server}, --side {client,server}
Specifies whether bindings should be generated for server side
(skeleton) implementation or client side (stub).
Note -
Not all language/side options are supported. Attempting to invoke
an unsupported combination will result in an error message.
-v, --verbose
Reports written filenames.
OPERANDS
The following operand must be specified on the command line:
adr
The path to the API specification for which type and interface def-
initions must be generated.
EXAMPLES
Example 1 Generating C Server Bindings
The following command generates server side implementation for an adr
file, myapi.adr, into the directory server/c:
$ radadrgen -s server -l c -d server/c myapi.adr
On success, the output directory contains the myapi_impl.c file, a
header file, and a mapfile.
Example 2 Generating Python Client Bindings
The following command generates Python client side bindings for an adr
file, myapi.adr, into the directory client/python:
$ radadrgen -s client -l python -d client/python myapi.adr
On success, the output directory structure includes the Python client
module myapi.py under com/oracle/solaris/rad/.
Example 3 Generating Java Client Bindings
The following command generates Java client side bindings for an adr
file, myapi.adr, into the directory client/java:
$ radadrgen -s client -l java -d client/java myapi.adr
On success, the output directory structure includes a set of .java
files for the interfaces defined in the API under com/ora-
cle/solaris/rad/myapi.
FILES
/usr/share/lib/xml/rng/radadr.rng.1
The core ADR RelaxNG schema definition.
/usr/share/lib/xml/rng/radadr-doc.rng.1
The ADR RelaxNG schema definition for documentation elements.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+-----------------------------+--------------------------------+
| | |
| | |
|ATTRIBUTE TYPE |ATTRIBUTE VALUE |
+-----------------------------+--------------------------------+
|Availability |system/management/rad/radadrgen |
+-----------------------------+--------------------------------+
|Interface Stability |Private |
+-----------------------------+--------------------------------+
SEE ALSO
attributes(7), rad(8)
Oracle Solaris 11.4 02 Mar 2017 radadrgen(1)