HELPLIB.HLB  —  RPCGEN  Qualifiers

1    /CLIENT_STUBS_FILE

    Optional.
    UNIX equivalent: -l
    Default: Create a client skeleton file.

    Creates the client skeleton file.

    Mutually exclusive with the /DISPATCH_TABLE, /HEADER_FILE,
    /SERVER_STUBS_FILE, /TRANSPORT, and XDR_FILE qualifiers.

2    /DEFINE

       /DEFINE = (name[=value][,....])

    Optional.
    UNIX equivalent: -D
    Default: No definitions.

    Defines one or more symbol names. Equivalent to one or more
    #define directives. Names are defined as they appear in the
    argument to the qualifier. For example, /DEFINE=TEST=1 creates
    the line #define TEST=1 in the output files. If you omit the
    value, RPCGEN defines the name with the value 1.

3    /DISPATCH_TABLE

    Optional.
    UNIX equivalent: -t
    Default: No dispatch file created.

    Creates the server dispatch table file. An RPCGEN dispatch table
    contains:

    o  Pointers to the service routines corresponding to a procedure

    o  A pointer to the input and output arguments

    o  The size of these routines

    A server can use the dispatch table to check authorization and
    then to execute the service routine; a client may use it to deal
    with the details of storage management and XDR data conversion.

    Mutually exclusive with the /CLIENT_STUBS_FILE, /HEADER_FILE,
    /SERVER_STUBS_FILE, /TRANSPORT, and XDR_FILE qualifiers.

4    /ERRLOG

    Optional.
    UNIX equivalent: -L
    Default: Logging to stderr.

    Specifies that servers should log errors to the operator console
    instead of using fprintf with stderr. You must install servers
    with OPER privilege in order to use this feature.

5    /HEADER_FILE

    Optional.
    UNIX equivalent: -h
    Default: Create a header file.

    Creates the C data definitions header file. Use the /TABLE
    qualifier in conjunction with this qualifier to generate a header
    file that supports dispatch tables.

    Mutually exclusive with the /CLIENT_STUBS_FILE, /DISPATCH_TABLE,
    /SERVER_STUBS_FILE, /TRANSPORT, and XDR_FILE qualifiers.

6    /INET_SERVICE

    Optional.
    UNIX equivalent: -I
    Default: No INETd support.

    Compiles support for INETd in the server side stubs. You can
    start servers yourself or you can have INETd start them. Servers
    started by INETd log all error messages to the operator console.

    If there are no pending client requests, the INETd servers exit
    after 120 seconds (default). You can change this default with the
    /TIMEOUT_SECONDS qualifier.

    When RPCGEN creates servers with INETd support, it defines two
    global variables: _rpcpmstart and rpcfdtype. The runtime value
    of _rpcpmstart is 1 or 0 depending on whether INDEd started the
    server program. The value of rpcfdtype should be SOCK_STREAM or
    SOCK_DGRAM depending on the type of the connection.

7    /OUTPUT

       /OUTPUT = file

    Optional.
    UNIX equivalent: -o
    Default: Direct output to one of the standard default files.

    Use this qualifier to direct the output of the /CLIENT_STUBS_
    FILE, /DISPATCH_TABLE, /HEADER_FILE, /SERVER_STUBS_FILE,
    /TRANSPORT, and /XDR_FILE qualifiers.

8    /SERVER_STUBS_FILE

    Optional.
    UNIX equivalent: -m
    Default: Create a server skeleton file.

    Creates a server skeleton file without the main routine. Use this
    qualifier to generate a server skeleton when you wish to create
    your own main routine. This option is useful for programs that
    have callback routines and for programs that have customized
    initialization requirements.

    Mutually exclusive with the /CLIENT_STUBS_FILE, /DISPATCH_TABLE,
    /HEADER_FILE, /TRANSPORT, and XDR_FILE qualifiers.

9    /TABLE

    Optional.
    UNIX equivalent: -T
    Default: No dispatch table code created.

    Creates the code in the header file to support an RPCGEN dispatch
    table. You can use this qualifier only when you are generating
    all files (the default) or when you are using the /HEADER_FILE
    qualifier to generate the header file. This /TABLE qualifier
    includes a definition of the dispatch table structure in the
    header file; it does not modify the server routine to use the
    table.

10    /TRANSPORT

       /TRANSPORT [= (TCP, UDP)]

    Optional.
    UNIX equivalent: -s
    Default: Create a server skeleton that supports both protocols.

    Creates a server skeleton that includes a main routine that uses
    the given transport. The supported transports are UDP and TCP. To
    compile a server that supports multiple transports, specify both.

11    /TIMEOUT_SECONDS

       /TIMEOUT_SECONDS=seconds

    Optional.
    UNIX equivalent: -K
    Default: 120 seconds.

    If INETd starts the server, this option specifies the time (in
    seconds) after which the server should exit if there is no
    further activity. By default, if there are no pending client
    requests, INETd servers exit after 120 seconds. This option is
    useful for customization. If seconds is 0, the server exits after
    serving a request. If seconds is -1, the server never exits after
    being started by INETd.

12    /XDR_FILE

    Optional.
    UNIX equivalent: -c
    Default: Create an XDR file.

    You can customize some of your XDR routines by leaving those data
    types undefined. For every data type that is undefined, RPCGEN
    assumes that there exists a routine with the name xdr_  prepended
    to the name of the undefined type.

    Mutually exclusive with the /CLIENT_STUBS_FILE, /DISPATCH_TABLE,
    /HEADER_FILE, /TRANSPORT, and /SERVER_STUBS_FILE qualifiers.
Close Help