getrpcent(3n)              DG/UX 4.30               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 *rname;  /* name of server for this rpc program */
                    char **raliases;   /* alias list */
                    long rnumber; /* rpc program number */
               };

          The members of this structure are:
               rname              The name of the server for this rpc
                                   program.
               raliases           A zero 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 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
          program number is found, or until end-of-file is



     Licensed material--property of copyright holder(s)         Page 1

     getrpcent(3n)              DG/UX 4.30               getrpcent(3n)



          encountered.

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

     SEE ALSO
          rpc(5), rpcinfo(8), ypservices(8)

     DIAGNOSTICS
          A NULL pointer is returned on end-of-file or error.

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








































     Licensed material--property of copyright holder(s)         Page 2