getrpcent(3N)                  NFS                  getrpcent(3N)



NAME
     getrpcent, getrpcbyname, getrpcbynumber - get RPC entry

SYNOPSIS
     #include <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 each return a
     pointer to an object with the following structure containing
     the broken-out fields of a line in the rpc program number
     data base, /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:

     r_name     The name of the server for this rpc program.

     r_aliases  A zero terminated list of alternate names for the
                rpc program.

     r_number   The rpc program number for this service.

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

     Setrpcent opens and rewinds the file.  If the stayopen  flag
     is non-zero, the net data base 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



Page 1                                  CX/UX Network File System

getrpcent(3N)                  NFS                  getrpcent(3N)



     program number is found, or until EOF is encountered.

FILES
     /etc/rpc
     /etc/yp/ domainname /rpc.bynumber

SEE ALSO
     rpc(4), rpcinfo(1M)

DIAGNOSTICS
     Null pointer (0) returned on EOF or error.

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








































Page 2                                  CX/UX Network File System