getrpcent(NS)                  6 January 1993                  getrpcent(NS)


 Name

    getrpcent, getrpcbyname, getrpcbynumber - get RPC entry

 Syntax


    #include <rpc/netdb.h>

    struct rpcent *getrpcent()

    struct rpcent *getrpcbyname(name)
    char *name;

    struct rpcent *getrpcbynumber(number)
    int number;

    setrpcent(stayopen)
    int stayopen

    endrpcent()


 Description

    getrpcent, getrpcbyname, and getrpcbynumber all return pointers to an
    object with the following structure, which contains the broken-out fields
    of a line in the RPC program number database, /etc/rpc.

       struct  rpcent {
               char    *r_name;        /* name of server for this rpc program */
               char    **r_aliases;    /* alias list */
               long    r_number;       /* rpc program number */
       };

    The members of this structure are:

    rname    the name of the server for this RPC program

    raliases a null-terminated list of alternate names for the RPC program

    rnumber  the RPC program number for this service

    getrpcent reads the next line of the file, opening the file if necessary.

    getrpcent opens and rewinds the file.  If the stayopen flag is non-zero,
    the database will not be closed after each call to getrpcent (either
    directly, or indirectly through one of the other getrpc calls).

    endrpcent closes the file.

    getrpcbyname and getrpcbynumber sequentially search from the beginning of
    the file until a matching RPC program name or program number is found, or
    until EOF is encountered.

 Files

    /etc/rpc

 See also

    rpc(NF) and rpcinfo(NADM).

 Diagnostics

    each function returns a NULL pointer if it encounters EOF or error

 Bugs

    All information is contained in a static area; therefore it must be
    copied if it is to be saved.