# getrpcent

## NAME



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


## LIBRARY



           Standard C library (_libc_ , _-lc_)
    


## SYNOPSIS



           **#include <netdb.h>**
    
           **struct rpcent *getrpcent(void);**
    
           **struct rpcent *getrpcbyname(const char ***_name_**);**
           **struct rpcent *getrpcbynumber(int** _number_**);**
    
           **void setrpcent(int** _stayopen_**);**
           **void endrpcent(void);**
    


## DESCRIPTION



           The **getrpcent**(), **getrpcbyname**(), and **getrpcbynumber**() functions
           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.
    
           The **getrpcent**() function reads the next entry from the database.
           A connection is opened to the database if necessary.
    
           The **setrpcent**() function opens a connection to the database, and
           sets the next entry to the first entry.  If _stayopen_ is nonzero,
           then the connection to the database will not be closed between
           calls to one of the **getrpc***() functions.
    
           The **endrpcent**() function closes the connection to the database.
    
           The **getrpcbyname**() and **getrpcbynumber**() functions 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.
    


## RETURN VALUE



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


## FILES



           _/etc/rpc_
                  RPC program number database.
    


## ATTRIBUTES



           For an explanation of the terms used in this section, see
           attributes(7).
           ┌───────────────────────────────┬───────────────┬────────────────┐
           │ **Interface** │ **Attribute** │ **Value** │
           ├───────────────────────────────┼───────────────┼────────────────┤
           │ **getrpcent**(), **getrpcbyname**(),  │ Thread safety │ MT-Unsafe      │
           │ **getrpcbynumber**()              │               │                │
           ├───────────────────────────────┼───────────────┼────────────────┤
           │ **setrpcent**(), **endrpcent**()      │ Thread safety │ MT-Safe locale │
           └───────────────────────────────┴───────────────┴────────────────┘
    


## STANDARDS



           BSD.
    


## BUGS



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


* * *