diff options
Diffstat (limited to 'cpukit/librpc/src/rpc/getrpcent.3')
-rw-r--r-- | cpukit/librpc/src/rpc/getrpcent.3 | 98 |
1 files changed, 0 insertions, 98 deletions
diff --git a/cpukit/librpc/src/rpc/getrpcent.3 b/cpukit/librpc/src/rpc/getrpcent.3 deleted file mode 100644 index 1e92e9d03d..0000000000 --- a/cpukit/librpc/src/rpc/getrpcent.3 +++ /dev/null @@ -1,98 +0,0 @@ -.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI -.\" $FreeBSD: src/lib/libc/rpc/getrpcent.3,v 1.11 1999/08/28 00:00:39 peter Exp $ -.\" -.Dd December 14, 1987 -.Dt GETRPCENT 3 -.Os -.Sh NAME -.Nm getrpcent , -.Nm getrpcbyname , -.Nm getrpcbynumber , -.Nm endrpcent , -.Nm setrpcent -.Nd get RPC entry -.Sh SYNOPSIS -.Fd #include <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 -.Sh 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, -.Pa /etc/rpc . -.Bd -literal - -struct rpcent { - char *r_name; /* name of server for this rpc program */ - char **r_aliases; /* alias list */ - long r_number; /* rpc program number */ -}; -.Ed -.Pp -The members of this structure are: -.Bl -tag -width r_aliasesxxx -.It Fa r_name -The name of the server for this rpc program. -.It Fa r_aliases -A zero terminated list of alternate names for the rpc program. -.It Fa r_number -The rpc program number for this service. -.El -.Pp -The -.Fn getrpcent -function reads the next line of the file, opening the file if necessary. -The -.Nm getrpcent -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 -.Fn getrpcent -function family. -.Pp -.Fn endrpcent -closes the file. -.Pp -.Fn getrpcbyname -and -.Fn getrpcbynumber -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. -.Sh FILES -.Bl -tag -width /etc/rpc -compact -.It Pa /etc/rpc -.El -.Sh "SEE ALSO" -.Xr rpc 5 , -.Xr rpcinfo 8 , -.Xr ypserv 8 -.Sh DIAGNOSTICS -A -.Dv NULL -pointer is returned on -.Dv EOF -or error. -.Sh BUGS -All information -is contained in a static area -so it must be copied if it is -to be saved. |