NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #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    [Toc]    [Back]

     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 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:

           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 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 end-of-file is encountered.

FILES    [Toc]    [Back]

     /etc/rpc

DIAGNOSTICS    [Toc]    [Back]

     A NULL pointer is returned on EOF or error.

SEE ALSO    [Toc]    [Back]

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

BUGS    [Toc]    [Back]

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

OpenBSD      3.6                        December     14,     1987