diff options
author | Joel Sherrill <joel.sherrill@OARcorp.com> | 2002-06-25 14:52:37 +0000 |
---|---|---|
committer | Joel Sherrill <joel.sherrill@OARcorp.com> | 2002-06-25 14:52:37 +0000 |
commit | 411e387c27b183eb53c9563a8decfb02af73dfd0 (patch) | |
tree | 8787b53c4df78702fa6a77cc722ee830ada6a3f7 /c/src/librpc/src/rpc/bindresvport.3 | |
parent | 2002-06-19 Ralf Corsepius <corsepiu@faw.uni-ulm.de> (diff) | |
download | rtems-411e387c27b183eb53c9563a8decfb02af73dfd0.tar.bz2 |
2002-06-25 Joel Sherrill <joel@OARcorp.com>
* Per PR233, moved librpc to exec. Ralf will patch after move.
The patches associated with this PR are out of date.
./include/rpc/.cvsignore, ./include/rpc/Makefile.am,
./include/rpc/auth.h, ./include/rpc/auth_des.h,
./include/rpc/auth_unix.h, ./include/rpc/clnt.h,
./include/rpc/des.h, ./include/rpc/des_crypt.h,
./include/rpc/pmap_clnt.h, ./include/rpc/pmap_prot.h,
./include/rpc/pmap_rmt.h, ./include/rpc/rpc.h,
./include/rpc/rpc_com.h, ./include/rpc/rpc_msg.h,
./include/rpc/svc.h, ./include/rpc/svc_auth.h,
./include/rpc/types.h, ./include/rpc/xdr.h,
./include/.cvsignore, ./include/Makefile.am,
./include/rpcsvc/.cvsignore, ./include/rpcsvc/Makefile.am,
./include/rpcsvc/bootparam_prot.x, ./include/rpcsvc/crypt.x,
./include/rpcsvc/key_prot.x, ./include/rpcsvc/klm_prot.x,
./include/rpcsvc/mount.x, ./include/rpcsvc/nfs_prot.x,
./include/rpcsvc/nis.x, ./include/rpcsvc/nis_cache.x,
./include/rpcsvc/nis_callback.x, ./include/rpcsvc/nis_db.h,
./include/rpcsvc/nis_object.x, ./include/rpcsvc/nis_tags.h,
./include/rpcsvc/nislib.h, ./include/rpcsvc/nlm_prot.x,
./include/rpcsvc/pmap_prot.x, ./include/rpcsvc/rex.x,
./include/rpcsvc/rnusers.x, ./include/rpcsvc/rquota.x,
./include/rpcsvc/rstat.x, ./include/rpcsvc/rwall.x,
./include/rpcsvc/sm_inter.x, ./include/rpcsvc/spray.x,
./include/rpcsvc/yp.x, ./include/rpcsvc/yp_prot.h,
./include/rpcsvc/ypclnt.h, ./include/rpcsvc/yppasswd.x,
./include/rpcsvc/ypupdate_prot.x, ./include/rpcsvc/ypxfrd.x,
./.cvsignore, ./Makefile.am, ./README_RTEMS,
./configure.ac, ./src/rpc/PSD.doc/.cvsignore,
./src/rpc/PSD.doc/Makefile.am, ./src/rpc/PSD.doc/nfs.rfc.ms,
./src/rpc/PSD.doc/rpc.prog.ms, ./src/rpc/PSD.doc/rpc.rfc.ms,
./src/rpc/PSD.doc/rpcgen.ms, ./src/rpc/PSD.doc/xdr.nts.ms,
./src/rpc/PSD.doc/xdr.rfc.ms, ./src/rpc/.cvsignore,
./src/rpc/DISCLAIMER, ./src/rpc/Makefile.am,
./src/rpc/README, ./src/rpc/auth_des.c,
./src/rpc/auth_none.c, ./src/rpc/auth_time.c,
./src/rpc/auth_unix.c, ./src/rpc/authdes_prot.c,
./src/rpc/authunix_prot.c, ./src/rpc/bindresvport.3,
./src/rpc/bindresvport.c, ./src/rpc/clnt_generic.c,
./src/rpc/clnt_perror.c, ./src/rpc/clnt_raw.c,
./src/rpc/clnt_simple.c, ./src/rpc/clnt_tcp.c,
./src/rpc/clnt_udp.c, ./src/rpc/clnt_unix.c,
./src/rpc/crypt_client.c, ./src/rpc/des_crypt.3,
./src/rpc/des_crypt.c, ./src/rpc/des_soft.c,
./src/rpc/get_myaddress.c, ./src/rpc/getpublickey.c,
./src/rpc/getrpcent.3, ./src/rpc/getrpcent.c,
./src/rpc/getrpcport.3, ./src/rpc/getrpcport.c,
./src/rpc/key_call.c, ./src/rpc/key_prot_xdr.c,
./src/rpc/netname.c, ./src/rpc/netnamer.c,
./src/rpc/pmap_clnt.c, ./src/rpc/pmap_getmaps.c,
./src/rpc/pmap_getport.c, ./src/rpc/pmap_prot.c,
./src/rpc/pmap_prot2.c, ./src/rpc/pmap_rmt.c,
./src/rpc/publickey.3, ./src/rpc/publickey.5,
./src/rpc/rpc.3, ./src/rpc/rpc.5, ./src/rpc/rpc_callmsg.c,
./src/rpc/rpc_commondata.c, ./src/rpc/rpc_dtablesize.c,
./src/rpc/rpc_prot.c, ./src/rpc/rpc_secure.3,
./src/rpc/rpcdname.c, ./src/rpc/rstat.1,
./src/rpc/rstat_svc.8, ./src/rpc/rtems_portmapper.c,
./src/rpc/rtems_rpc.c, ./src/rpc/rtime.3, ./src/rpc/rtime.c,
./src/rpc/svc.c, ./src/rpc/svc_auth.c,
./src/rpc/svc_auth_des.c, ./src/rpc/svc_auth_unix.c,
./src/rpc/svc_raw.c, ./src/rpc/svc_run.c,
./src/rpc/svc_simple.c, ./src/rpc/svc_tcp.c,
./src/rpc/svc_udp.c, ./src/rpc/svc_unix.c,
./src/xdr/.cvsignore, ./src/xdr/Makefile.am, ./src/xdr/xdr.3,
./src/xdr/xdr.c, ./src/xdr/xdr_array.c,
./src/xdr/xdr_float.c, ./src/xdr/xdr_mem.c,
./src/xdr/xdr_rec.c, ./src/xdr/xdr_reference.c,
./src/xdr/xdr_sizeof.c, ./src/xdr/xdr_stdio.c,
./src/.cvsignore, ./src/Makefile.am: Moved to exec.
Diffstat (limited to 'c/src/librpc/src/rpc/bindresvport.3')
-rw-r--r-- | c/src/librpc/src/rpc/bindresvport.3 | 106 |
1 files changed, 0 insertions, 106 deletions
diff --git a/c/src/librpc/src/rpc/bindresvport.3 b/c/src/librpc/src/rpc/bindresvport.3 deleted file mode 100644 index 02a079decc..0000000000 --- a/c/src/librpc/src/rpc/bindresvport.3 +++ /dev/null @@ -1,106 +0,0 @@ -.\" @(#)bindresvport.3n 2.2 88/08/02 4.0 RPCSRC; from 1.7 88/03/14 SMI -.\" $FreeBSD: src/lib/libc/rpc/bindresvport.3,v 1.10 2000/01/27 02:55:01 bde Exp $ -.\" -.Dd January 27, 2000 -.Dt BINDRESVPORT 3 -.Os -.Sh NAME -.Nm bindresvport , -.Nm bindresvport_sa -.Ndbind a socket to a privileged IP port -.Sh SYNOPSIS -.Fd #include <rpc/rpc.h> -.Ft int -.Fn bindresvport "int sd" "struct sockaddr_in *sin" -.Ft int -.Fn bindresvport_sa "int sd" "struct sockaddr *sa" -.Sh DESCRIPTION -.Fn bindresvport -and -.Fn bindresvport_sa -are used to bind a socket descriptor to a privileged -.Tn IP -port, that is, a -port number in the range 0-1023. -.Pp -Only root can bind to a privileged port; this call will fail for any -other users. -.Pp -When -.Va sin -is not null, -.Va sin->sin_family -must be initialized to the address family of the socket, passed by -.Va sd . -If the value of sin->sin_port is non-zero -.Fn bindresvport -will attempt to use that specific port. If it fails, it chooses another -privileged port automatically. -.Pp -It is legal to pass null pointer to -.Va sin . -In this case, the caller cannot get the port number -.Fn bindresvport -has picked. -.Pp -Function prototype of -.Fn bindresvport -is biased to -.Dv AF_INET -socket. -.Fn bindresvport_sa -acts exactly the same, with more neutral function prototype. -Note that both functions behave exactly the same, and -both support -.Dv AF_INET6 -sockets as well as -.Dv AF_INET -sockets. -.Sh RETURN VALUES -.Fn bindresvport -and -.Fn bindresvport_sa -return 0 if they are successful, otherwise \-1 is returned and -.Va errno -set to reflect the cause of the error. -.Sh ERRORS -The -.Fn bindresvport -and -.Fn bindresvport_sa -functions fail if: -.Bl -tag -width Er -.It Bq Er EBADF -.Fa sd -is not a valid descriptor. -.It Bq Er ENOTSOCK -.Fa sd -is not a socket. -.It Bq Er EADDRNOTAVAIL -The specified address is not available from the local machine. -.It Bq Er EADDRINUSE -The specified address is already in use. -.It Bq Er EINVAL -The socket is already bound to an address, -or the socket family and the family of specified address mismatch. -.It Bq Er EACCES -The requested address is protected, and the current user -has inadequate permission to access it. -.It Bq Er EFAULT -The -.Fa name -parameter is not in a valid part of the user -address space. -.It Bq Er ENOBUFS -Insufficient resources were available in the system -to perform the operation. -.It Bq Er EPFNOSUPPORT -The protocol family has not been configured into the -system, no implementation for it exists, -or address family did not match between arguments. -.El -.Sh "SEE ALSO" -.Xr bind 2 , -.Xr socket 2 , -.Xr rresvport 3 , -.Xr rresvport_af 3 |