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 pro­
       gram 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 indi­
       rectly 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 pro­
       gram name or program number is found, or until end-of-file
       is encountered.

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


Man(1) output converted with man2html