GETRPCENT(3N)       RISC/os Reference Manual        GETRPCENT(3N)



NAME
     getrpcent, getrpcbyname, getrpcbynumber - get RPC entry

SYNOPSIS
     For -systype sysv and -systype bsd43:

     #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.




                         Printed 1/15/91                   Page 1

GETRPCENT(3N)       RISC/os Reference Manual        GETRPCENT(3N)



     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
     /etc/yp/domainname/rpc.bynumber

SEE ALSO
     rpc(4).
     rpcinfo(1M) in the System Administrator's Reference Manual.

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

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

ORIGIN
     Sun Microsystems Inc.

NOTE
     When these routines are used in a program which is compiled
     in -systype sysv, they are not resolved by libc.a.  See
     intro(3-SysV) for more information.





























 Page 2                  Printed 1/15/91