endrpcent

       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 an entry in the RPC program number data base.

           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 NULL-terminated list of alternate names for  the  RPC
                       program.

           r_number    The RPC program number for this service.

       getrpcent()  reads  the  next entry from the database.  A connection is
       opened to the database if necessary.

       setrpcent() function opens a connection to the database, and  sets  the
       next  entry to the first entry.  If stayopen is non-zero, then the con-
       nection to the database will not be closed between calls to one of  the
       getrpc*() functions.

       The endrpcent() function closes the connection to the database.

       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.

RETURN VALUE
       On  success, getrpcent(), getrpcbyname(), and getrpcbynumber() return a
       pointer to a statically allocated rpcent structure.  A NULL pointer  is
       returned on EOF or error.

SEE ALSO
       getrpcent_r(3), rpc(5), rpcinfo(8), ypserv(8)

COLOPHON
       This  page  is  part of release 3.23 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://www.kernel.org/doc/man-pages/.



                                  2008-08-19                      GETRPCENT(3)