diff options
author | mpp <mpp@FreeBSD.org> | 1996-12-21 22:56:48 +0000 |
---|---|---|
committer | mpp <mpp@FreeBSD.org> | 1996-12-21 22:56:48 +0000 |
commit | bef6a10c829afa66b19ea2482f320fa622453873 (patch) | |
tree | ce051cd2b9397412228bb74aa965002942012a8f | |
parent | ad3a46d18ba9b4fae98b615a912d155f1008d49e (diff) | |
download | FreeBSD-src-bef6a10c829afa66b19ea2482f320fa622453873.zip FreeBSD-src-bef6a10c829afa66b19ea2482f320fa622453873.tar.gz |
Convert to mdoc format.
-rw-r--r-- | lib/libc/rpc/bindresvport.3 | 36 | ||||
-rw-r--r-- | lib/libc/rpc/getrpcent.3 | 145 | ||||
-rw-r--r-- | lib/libc/rpc/getrpcport.3 | 38 | ||||
-rw-r--r-- | lib/libc/rpc/rpc.5 | 81 |
4 files changed, 122 insertions, 178 deletions
diff --git a/lib/libc/rpc/bindresvport.3 b/lib/libc/rpc/bindresvport.3 index 5d16487..8b9f3bf 100644 --- a/lib/libc/rpc/bindresvport.3 +++ b/lib/libc/rpc/bindresvport.3 @@ -1,27 +1,25 @@ .\" @(#)bindresvport.3n 2.2 88/08/02 4.0 RPCSRC; from 1.7 88/03/14 SMI -.TH BINDRESVPORT 3 "22 november 1987" -.SH NAME -bindresvport \- bind a socket to a privileged IP port -.SH SYNOPSIS -.nf -.B #include <sys/types.h> -.B #include <netinet/in.h> -.LP -.B int bindresvport(sd, sin) -.B int sd; -.B struct sockaddr_in \(**sin; -.fi -.SH DESCRIPTION -.LP -.B bindresvport(\|) +.Dd "22 november 1987" +.Dt BINDRESVPORT 3 +.Os +.Sh NAME +.Nm bindresvport +.Ndbind a socket to a privileged IP port +.Sh SYNOPSIS +.Fd #include <sys/types.h> +.Fd #include <netinet/in.h> +.Ft int +.Fn bindresvport "int sd "struct sockaddr_in **sin" +.Sh DESCRIPTION +.Nm Bindresvport is used to bind a socket descriptor to a privileged -.SM IP +.Em IP port, that is, a port number in the range 0-1023. The routine returns 0 if it is successful, -otherwise \-1 is returned and -.B errno +otherwise -1 is returned and +.Va errno set to reflect the cause of the error. -.LP +.Pp Only root can bind to a privileged port; this call will fail for any other users. diff --git a/lib/libc/rpc/getrpcent.3 b/lib/libc/rpc/getrpcent.3 index 2bac189..8f784ba 100644 --- a/lib/libc/rpc/getrpcent.3 +++ b/lib/libc/rpc/getrpcent.3 @@ -1,108 +1,93 @@ .\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI -.TH GETRPCENT 3 "14 December 1987" -.SH NAME -getrpcent, getrpcbyname, getrpcbynumber \- get RPC entry -.SH SYNOPSIS -.nf -.ft B -#include <netdb.h> -.LP -.ft B -struct rpcent *getrpcent(\|) -.LP -.ft B -struct rpcent *getrpcbyname(name) -char *name; -.LP -.ft B -struct rpcent *getrpcbynumber(number) -int number; -.LP -.ft B -setrpcent (stayopen) -int stayopen -.LP -.ft B -endrpcent (\|) -.fi -.SH DESCRIPTION -.LP -.BR getrpcent(\|) , -.BR getrpcbyname(\|) , +.Dd "December 14, 1987" +.Dt GETRPCENT 3 +.Sh NAME +.Os +.Nm getrpcent , +.Nm getrpcbyname , +.Nm getrpcbynumber +.Nd get RPC entry +.Sh SYNOPSIS +.Fd #include <netdb.h> +.Ft struct rpcent * +.Fn getrpcent +.Ft struct rpcent * +.Fn getrpcbyname "char *name" +.Ft struct rpcent * +.Fn getrpcbynumber "int number" +.Ft void +.Fn setrpcent "int stayopen" +.Ft void +.Fn endrpcent +.Sh DESCRIPTION +The +.Fn getrpcent , +.Fn getrpcbyname , and -.B getrpcbynumber(\|) -each return a pointer to an object with the +.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, -.BR /etc/rpc . -.RS -.LP -.nf -.ft B +.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 */ }; -.ft R -.fi -.RE -.LP +.Ed +.Pp The members of this structure are: -.RS -.PD 0 -.TP 20 -.B r_name +.Bl -tag -width r_aliasesxxx +.It Fa r_name The name of the server for this rpc program. -.TP 20 -.B r_aliases +.It Fa r_aliases A zero terminated list of alternate names for the rpc program. -.TP 20 -.B r_number +.It Fa r_number The rpc program number for this service. -.PD -.RE -.LP -.B getrpcent(\|) -reads the next line of the file, opening the file if necessary. -.LP -.B getrpcent(\|) -opens and rewinds the file. If the -.I stayopen +.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 -.B getrpcent(\|) +.Fn getrpcent (either directly, or indirectly through one of -the other \*(lqgetrpc\*(rq calls). -.LP -.B endrpcent +the other +.Fn getrpcent +function family. +.Pp +.Fn endrpcent closes the file. -.LP -.B getrpcbyname(\|) +.Pp +.Fn getrpcbyname and -.B getrpcbynumber(\|) +.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 -.PD 0 -.TP 20 -.B /etc/rpc -.PD -.SH "SEE ALSO" -.BR rpc (5), -.BR rpcinfo (8), -.BR ypserv (8) -.SH DIAGNOSTICS -.LP +.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 -.SM NULL +.Dv NULL pointer is returned on -.SM EOF +.Dv EOF or error. -.SH BUGS -.LP +.Sh BUGS All information is contained in a static area so it must be copied if it is diff --git a/lib/libc/rpc/getrpcport.3 b/lib/libc/rpc/getrpcport.3 index 01e7502..f9c3cb4 100644 --- a/lib/libc/rpc/getrpcport.3 +++ b/lib/libc/rpc/getrpcport.3 @@ -1,31 +1,29 @@ .\" @(#)getrpcport.3r 2.2 88/08/02 4.0 RPCSRC; from 1.12 88/02/26 SMI -.TH GETRPCPORT 3 "6 October 1987" -.SH NAME -getrpcport \- get RPC port number -.SH SYNOPSIS -.ft B -.nf -int getrpcport(host, prognum, versnum, proto) - char *host; - int prognum, versnum, proto; -.fi -.SH DESCRIPTION -.IX getrpcport "" "\fLgetrpcport\fR \(em get RPC port number" -.B getrpcport(\|) +.Dd "October 6, 1987" +.Dt GETRPCPORT 3 +.Os +.Sh NAME +.Nm getrpcport +.Nd get RPC port number +.Sh SYNOPSIS +.Ft int +.Fn getrpcport "char *host" "int prognum" "int versnum" "int proto" +.Sh DESCRIPTION +.Fn getrpcport returns the port number for version -.I versnum +.Fa versnum of the RPC program -.I prognum +.Fa prognum running on -.I host +.Fa host and using protocol -.IR proto . +.Fa proto . It returns 0 if it cannot contact the portmapper, or if -.I prognum +.Fa prognum is not registered. If -.I prognum +.Fa prognum is registered but not with version -.IR versnum , +.Fa versnum , it will still return a port number (for some version of the program) indicating that the program is indeed registered. The version mismatch will be detected upon the first call to the service. diff --git a/lib/libc/rpc/rpc.5 b/lib/libc/rpc/rpc.5 index 794197b..d7b9d58 100644 --- a/lib/libc/rpc/rpc.5 +++ b/lib/libc/rpc/rpc.5 @@ -1,71 +1,34 @@ .\" @(#)rpc.5 2.2 88/08/03 4.0 RPCSRC; from 1.4 87/11/27 SMI; -.TH RPC 5 "26 September 1985" -.SH NAME -rpc \- rpc program number data base -.SH SYNOPSIS -.B /etc/rpc -.SH DESCRIPTION +.Dd "September 26, 1985" +.Dt RPC 5 +.Sh NAME +.Nm rpc +.Nd rpc program number data base +.Sh SYNOPSIS +/etc/rpc +.Sh DESCRIPTION The -.I rpc +.Pa /etc/rpc file contains user readable names that can be used in place of rpc program numbers. Each line has the following information: -.HP 10 +.Pp +.Bl -bullet -compact +.It name of server for the rpc program -.br -.ns -.HP 10 +.It rpc program number -.br -.ns -.HP 10 +.It aliases -.LP +.El +.Pp Items are separated by any number of blanks and/or tab characters. A ``#'' indicates the beginning of a comment; characters up to the end of the line are not interpreted by routines which search the file. -.LP -Here is an example of the \fI/etc/rpc\fP file from the Sun RPC Source -distribution. -.nf -.ta 1.5i +0.5i +1.0i +1.0i -# -# rpc 88/08/01 4.0 RPCSRC; from 1.12 88/02/07 SMI -# -portmapper 100000 portmap sunrpc -rstatd 100001 rstat rstat_svc rup perfmeter -rusersd 100002 rusers -nfs 100003 nfsprog -ypserv 100004 ypprog -mountd 100005 mount showmount -ypbind 100007 -walld 100008 rwall shutdown -yppasswdd 100009 yppasswd -etherstatd 100010 etherstat -rquotad 100011 rquotaprog quota rquota -sprayd 100012 spray -3270_mapper 100013 -rje_mapper 100014 -selection_svc 100015 selnsvc -database_svc 100016 -rexd 100017 rex -alis 100018 -sched 100019 -llockmgr 100020 -nlockmgr 100021 -x25.inr 100022 -statmon 100023 -status 100024 -bootparam 100026 -ypupdated 100028 ypupdate -keyserv 100029 keyserver -tfsd 100037 -nsed 100038 -nsemntd 100039 -.fi -.DT -.SH FILES -/etc/rpc -.SH "SEE ALSO" -getrpcent(3) +.Sh FILES +.Bl -tag -compact -width /etc/rpc +.Pa /etc/rpc +.El +.Sh "SEE ALSO" +.Xr getrpcent 3 |