summaryrefslogtreecommitdiffstats
path: root/lib/libc/rpc/getrpcent.3
diff options
context:
space:
mode:
authoralfred <alfred@FreeBSD.org>2001-03-19 12:50:13 +0000
committeralfred <alfred@FreeBSD.org>2001-03-19 12:50:13 +0000
commitf67e4a8fc7fc95c74bd6c09d3453200de47faea5 (patch)
tree98b613188d263fdcef5f2d020e5e8c374db1f5b6 /lib/libc/rpc/getrpcent.3
parent6f24d923a7fa9d1679753d77cc982ec72c22a197 (diff)
downloadFreeBSD-src-f67e4a8fc7fc95c74bd6c09d3453200de47faea5.zip
FreeBSD-src-f67e4a8fc7fc95c74bd6c09d3453200de47faea5.tar.gz
Bring in a hybrid of SunSoft's transport-independent RPC (TI-RPC) and
associated changes that had to happen to make this possible as well as bugs fixed along the way. Bring in required TLI library routines to support this. Since we don't support TLI we've essentially copied what NetBSD has done, adding a thin layer to emulate direct the TLI calls into BSD socket calls. This is mostly from Sun's tirpc release that was made in 1994, however some fixes were backported from the 1999 release (supposedly only made available after this porting effort was underway). The submitter has agreed to continue on and bring us up to the 1999 release. Several key features are introduced with this update: Client calls are thread safe. (1999 code has server side thread safe) Updated, a more modern interface. Many userland updates were done to bring the code up to par with the recent RPC API. There is an update to the pthreads library, a function pthread_main_np() was added to emulate a function of Sun's threads library. While we're at it, bring in NetBSD's lockd, it's been far too long of a wait. New rpcbind(8) replaces portmap(8) (supporting communication over an authenticated Unix-domain socket, and by default only allowing set and unset requests over that channel). It's much more secure than the old portmapper. Umount(8), mountd(8), mount_nfs(8), nfsd(8) have also been upgraded to support TI-RPC and to support IPV6. Umount(8) is also fixed to unmount pathnames longer than 80 chars, which are currently truncated by the Kernel statfs structure. Submitted by: Martin Blapp <mb@imp.ch> Manpage review: ru Secure RPC implemented by: wpaul
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