# phpman > man > GETRPCENT(3)

[GETRPCENT(3)](https://www.chedong.com/phpMan.php/man/GETRPCENT/3/markdown)             BSD Library Functions Manual             [GETRPCENT(3)](https://www.chedong.com/phpMan.php/man/GETRPCENT/3/markdown)

## NAME
     **getrpcent**, **getrpcbyname**, **getrpcbynumber**, **endrpcent**, **setrpcent** — get RPC entry

## SYNOPSIS
### #include <rpc/rpc.h>

     _struct_ _rpcent_ _*_
     **getrpcent**(_void_);

     _struct_ _rpcent_ _*_
     **getrpcbyname**(_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 ob‐
     ject 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.

     The **getrpcent**() function reads the next line of the file, opening the file if necessary.

     The **setrpcent**() function 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).

     The **endrpcent**() function closes the file.

     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 en‐
     countered.

## FILES
     /etc/rpc

## AVAILABILITY
     These functions are part of libtirpc.

## SEE ALSO
     [rpc(5)](https://www.chedong.com/phpMan.php/man/rpc/5/markdown), [rpcinfo(8)](https://www.chedong.com/phpMan.php/man/rpcinfo/8/markdown)

## 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