GETRPCENT(3) Library Functions Manual GETRPCENT(3)

# [NAME](#NAME)

`getrpcent`, `getrpcbyname`, `getrpcbynumber`, `endrpcent`, `setrpcent` — get RPC entry

# [SYNOPSIS](#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](#DESCRIPTION)

The [`getrpcent`](#getrpcent)(), `getrpcbyname`(), and `getrpcbynumber`() functions 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.

The [`getrpcent`](#getrpcent~2)() function reads the next line of the file, opening the file if necessary.

The [`setrpcent`](#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`](#endrpcent)() function closes the file.

The [`getrpcbyname`](#getrpcbyname)() and [`getrpcbynumber`](#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.

# [FILES](#FILES)

/etc/rpc

 

# [AVAILABILITY](#AVAILABILITY)

These functions are part of libtirpc.

# [SEE ALSO](#SEE_ALSO)

[rpc(5)](/man/os/libtirpc/rpc.5), [rpcinfo(8)](/man/os/libtirpc/rpcinfo.8)

# [DIAGNOSTICS](#DIAGNOSTICS)

A `NULL` pointer is returned on `EOF` or error.

# [BUGS](#BUGS)

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

December 14, 1987 Linux 4.19.0-gvisor

---

Document: getrpcent(3t) from libtirpc 1.3.8-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/project/libtirpc/libtirpc/1.3.8/libtirpc-1.3.8.tar.bz2