diff options
Diffstat (limited to 'lib/libc/rpc/bindresvport.3')
| -rw-r--r-- | lib/libc/rpc/bindresvport.3 | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/lib/libc/rpc/bindresvport.3 b/lib/libc/rpc/bindresvport.3 new file mode 100644 index 0000000..b21d65e --- /dev/null +++ b/lib/libc/rpc/bindresvport.3 @@ -0,0 +1,30 @@ +.\" @(#)bindresvport.3n 2.2 88/08/02 4.0 RPCSRC; from 1.7 88/03/14 SMI +.Dd November 22, 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 +.Tn 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 +.Va errno +set to reflect the cause of the error. +.Pp +Only root can bind to a privileged port; this call will fail for any +other users. +.Pp +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. |
