getrpcent(3n)getrpcent(3n)Name
getrpcent, getrpcbynumber, getrpcbyname, setrpcent, endrpcent - get rpc
entry
Syntax
#include <netdb.h>
struct rpcent *getrpcent()
struct rpcent *getrpcbynumber(number)
int number;
struct rpcent *getrpcbyname(name)
char *name;
setrpcent(stayopen)
int stayopen;
endrpcent( )
Description
The and subroutines each return pointers to an object with the follow‐
ing structure containing the broken-out fields of a line in the rpc
database:
struct rpcent { /* see getrpcent(3) */
char *r_name;
char **r_aliases; /* alias list */
char r_number; /* rpc program number */
};
struct group *getrpcent(), *getrpcbynumber(), *getrpcbyname();
The members of this structure are:
r_name The name of the rpc.
r_aliases A zero-terminated list of alternate names for the rpc.
r_number The rpc program number for the rpc.
If the stayopen flag on the subroutine is NULL, the database is opened.
Otherwise the has the effect of rewinding the database. The may be
called to close the file when processing is complete.
The subroutine simply reads the next line while and search until a
matching gid or name is found (or until EOF is encountered). The sub‐
routine keeps a pointer in the database, allowing successive calls to
be used to search the entire file.
A call to must be made before a loop using in order to perform initial‐
ization and an must be used after the loop. Both and make calls to and
Restrictions
All information is contained in a static area so it must be copied if
it is to be saved.
If YP is running, does not return the entries in any particular order.
See the Guide to the Yellow Pages Service for setup information.
The database may also be distributed by the BIND/Hesiod naming service.
See the Guide to the BIND/Hesiod Service for more information.
Return Values
A null pointer (0) is returned on EOF or error.
FilesSee Alsorpc(5), svc.conf(5)
Guide to the BIND/Hesiod Service
Guide to the Yellow Pages Service
getrpcent(3n)