GETRPCENT

Section: C Library Functions (3)
Page Index

BSD mandoc

NAME

getrpcent getrpcbyname getrpcbynumber endrpcent setrpcent - get RPC entry

SYNOPSIS

In rpc/rpc.h Ft struct rpcent * Fn getrpcent void Ft struct rpcent * Fn getrpcbyname char *name Ft struct rpcent * Fn getrpcbynumber int number Ft void Fn setrpcent int stayopen Ft void Fn endrpcent void

DESCRIPTION

The Fn getrpcent , Fn getrpcbyname , and Fn 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 Fn getrpcent function reads the next line of the file, opening the file if necessary.

The Fn setrpcent function opens and rewinds the file. If the Fa stayopen flag is non-zero, the net data base will not be closed after each call to Fn getrpcent (either directly, or indirectly through one of the other ``getrpc'' calls).

The Fn endrpcent function closes the file.

The Fn getrpcbyname and Fn 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.

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.