HP-UX Reference (11i v2 04/09) - 1 User Commands N-Z (vol 2)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

221

222

223

224

225

226

227

228

229

230

rpcgen(1) rpcgen(1)

-o outfile Specify the name of the output ﬁle. If none is speciﬁed, standard output is used (

-c,

-h,

-l, -m, -n

, -s, -Sc, -Sm, -Ss, and -t modes only).

-s nettype Compile into server-side stubs for all the transports belonging to the class nettype . The

supported classes are

netpath, visible, circuit_n

, circuit_v, datagram_n,

datagram_v, tcp, and udp (see rpc(3N) for the meanings associated with these

classes). This option may be speciﬁed more than once. Note: the transports are chosen

at run time and not at compile time.

-Sc Generate sample client code that uses remote procedure calls.

-Sm Generate a sample Makeﬁle which can be used for compiling the application.

-Ss Generate sample server code that uses remote procedure calls.

-t Compile into RPC dispatch table.

-T Generate the code to support RPC dispatch tables.

The options

-c, -h

, -l, -m, -s, -Sc, -Sm, -Ss

, and -t are used exclusively to generate

a particular type of ﬁle, while the options

-D and -T are global and can be used with the

other options.

-u When the server-side stub is produced, additional code to handle signals is generated.

On reception of a signal, this signal handler code unmaps the server program from the

port mapper before the server terminates. This code is added only if a

main() routine is

produced in the server-side stub. The -u option must not be speciﬁed with the

-c, -h,

-l, -m, -Sc, -Sm, -Ss options. The following signals are trapped:

SIGHUP, SIGINT,

SIGQUIT, and SIGTERM.

-Y pathname Give the name of the directory where rpcgen will start looking for the C preprocessor.

EXAMPLES

The following example:

rpcgen -T prot.x

generates all ﬁve of the ﬁles: prot.h, prot_clnt.c, prot_svc.c, prot_xdr.c and

prot_tbl.i.

The following example sends the C data deﬁnitions (header) to standard output.

rpcgen -h prot.x

To send the test version of the -DTEST, server-side stubs for all the transport belonging to the class

datagram_n to standard output, use:

rpcgen -s datagram_n -DTEST prot.x

To create the server side stubs for the transport indicated by netid tcp, use:

rpcgen -n tcp -o prot_svc.c prot.x

AUTHOR

rpcgen was developed by Sun Microsystems, Inc.