Provided by: manpages-pt-dev_20040726-4_all bug

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

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

FILES

       /etc/rpc

SEE ALSO

       rpc(5), rpcinfo(8C), 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.

                               14 December 1987                   GETRPCENT(3)