GETRPCENT
Section: Network Functions (3N)
Updated: 6 October 1987
Index
Return to Main Contents
NAME
getrpcent, getrpcbyname, getrpcbynumber - get RPC entry
SYNOPSIS
#include <netdb.h>
struct rpcent *getrpcent()
struct rpcent *getrpcbyname(name)
char *name;
struct rpcent *getrpcbynumber(number)
int number;
setrpcent (stayopen)
int stayopen
endrpcent ()
DESCRIPTION
getrpcent,
getrpcbyname,
and
getrpcbynumber
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.
-
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.
getrpcent
reads the next line of the file, opening the file if necessary.
setrpcent
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).
endrpcent
closes the file.
getrpcbyname
and
getrpcbynumber
sequentially search from the beginning
of the file until a matching rpc program name or
program number is found, or until
EOF
is encountered.
FILES
- /etc/rpc -
-
if NetInfo is not running.
SEE ALSO
rpc(5),
rpcinfo(8),
netinfo(5)
DIAGNOSTICS
Null pointer
(0)
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.
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- FILES
-
- SEE ALSO
-
- DIAGNOSTICS
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 00:57:39 GMT, September 26, 2024