summaryrefslogtreecommitdiffstats
path: root/lib/libc/rpc/getrpcent.3
diff options
context:
space:
mode:
Diffstat (limited to 'lib/libc/rpc/getrpcent.3')
-rw-r--r--lib/libc/rpc/getrpcent.332
1 files changed, 16 insertions, 16 deletions
diff --git a/lib/libc/rpc/getrpcent.3 b/lib/libc/rpc/getrpcent.3
index 208e5d0..6a02ca1 100644
--- a/lib/libc/rpc/getrpcent.3
+++ b/lib/libc/rpc/getrpcent.3
@@ -1,4 +1,5 @@
.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
+.\" $NetBSD: getrpcent.3,v 1.6 1998/02/05 18:49:06 perry Exp $
.\" $FreeBSD$
.\"
.Dd December 14, 1987
@@ -11,6 +12,8 @@
.Nm endrpcent ,
.Nm setrpcent
.Nd get RPC entry
+.Sh LIBRARY
+.Lb libc
.Sh SYNOPSIS
.Fd #include <rpc/rpc.h>
.Ft struct rpcent *
@@ -24,19 +27,17 @@
.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
+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 .
+.Pa /etc/rpc :
.Bd -literal
-
-struct rpcent {
+struct rpcent {
char *r_name; /* name of server for this rpc program */
char **r_aliases; /* alias list */
long r_number; /* rpc program number */
@@ -44,29 +45,28 @@ struct rpcent {
.Ed
.Pp
The members of this structure are:
-.Bl -tag -width r_aliasesxxx
-.It Fa r_name
+.Bl -tag -width r_aliases -offset indent
+.It Va r_name
The name of the server for this rpc program.
-.It Fa r_aliases
+.It Va r_aliases
A zero terminated list of alternate names for the rpc program.
-.It Fa r_number
+.It Va 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
+reads the next line of the file, opening the file if necessary.
+.Pp
.Fn setrpcent
-function opens and rewinds the file. If the
+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.
+.Dq getrpc
+calls).
.Pp
.Fn endrpcent
closes the file.
@@ -81,7 +81,7 @@ program number is found, or until end-of-file is encountered.
.Bl -tag -width /etc/rpc -compact
.It Pa /etc/rpc
.El
-.Sh "SEE ALSO"
+.Sh SEE ALSO
.Xr rpc 5 ,
.Xr rpcinfo 8 ,
.Xr ypserv 8
OpenPOWER on IntegriCloud