iOS Manual Pages

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

GETRPCENT(3)             BSD Library Functions Manual             GETRPCENT(3)

NAME
     getrpcent, 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 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 neces-sary. necessary.
     sary.

     setrpcent() opens and rewinds the file.  If the stayopen flag is non-zero, nonzero,
     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 begin-ning beginning
     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.

BSD                            December 14, 1987                           BSD