---
name: "getrpcent"
section: "3t"
platform: "linux"
package: "libtirpc"
version: "1.3.8-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/getrpcent/3t"
---

# getrpcent(3t)

get RPC entry

## 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 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**() 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 encountered.

## FILES

- */etc/rpc*

  ## AVAILABILITY

These functions are part of libtirpc.

## SEE ALSO

[rpc(5)](/rpc/5.md), [rpcinfo(8)](/rpcinfo/8.md)

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