unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-5.0)
Page:
Section:
Apropos / Subsearch:
optional field

GETRPCENT(3)               Linux Programmer's Manual              GETRPCENT(3)



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

SYNOPSIS
       #include <&lt;netdb.h>&gt;

       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.

       setrpcent() opens and rewinds the file.  If the stayopen flag  is  non-
       zero,  the  net  data base will not be closed after each call to getrp-
       cent() (either  directly,  or  indirectly  through  one  of  the  other
       "getrpc" calls).

       endrpcent() closes the file.

       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
       A NULL pointer is returned on EOF or error.

FILES
       /etc/rpc

CONFORMING TO
       Not in POSIX.1-2001.  Present on the BSDs, Solaris, and many other sys-
       tems.

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

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

COLOPHON
       This  page  is  part of release 3.05 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/.



                                  2007-12-23                      GETRPCENT(3)