getrpcent(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
GETRPCENT(3)              NetBSD Programmer's Manual              GETRPCENT(3)


NAME

     getpwent, getrpcbyname, getrpcbynumber, endrpcent, setrpcent - get RPC
     entry


SYNOPSIS

     #include <netdb.h>

     struct rpcent *
     getrpcent(void);

     struct rpcent *
     getrpcbyname(char *name);

     struct rpcent *
     getrpcbynumber(int number);

     void
     setrpcent(int stayopen);

     void
     endrpcent(void);


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 alternative 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 neces-
     sary.

     setrpcent() opens and rewinds the file.  If the stayopen flag is non-ze-
     ro, 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 begin-
     ning of the file until a matching rpc program name or program number is
     found, or until end-of-file is encountered.


FILES

     /etc/rpc


SEE ALSO

     rpc(5),  rpcinfo(8),  ypserv(8)


DIAGNOSTICS

     A NULL pointer is 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.

4.4BSD                         December 14, 1987                             2