LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
man-pages/man3/bindresvport.3

101 lines
3.1 KiB
Groff
Raw Normal View History

Change mtk's email address
2007-09-20 06:52:22 +00:00
.\" Copyright (C) 2007, Michael Kerrisk <mtk.manpages@gmail.com>
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.\" and Copyright (C) 2008, Linux Foundation, written by Michael Kerrisk
.\" <mtk.manpages@gmail.com>
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
Added license statement
2006-05-31 22:49:02 +00:00
.\"
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.\"
.\" 2007-05-31, mtk: Rewrite and substantial additional text.
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.\" 2008-12-03, mtk: Rewrote some pieces and fixed some errors
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.\"
bindresvport.3: SYNOPSIS: s/\*\*/*/ in prototype Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-03 18:37:34 +00:00
.TH BINDRESVPORT 3 2008-12-03 "" "Linux Programmer's Manual"
Import of man-pages 1.70
2004-11-03 13:51:07 +00:00
.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
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.BI "int bindresvport(int " sockfd ", struct sockaddr_in *" sin );
Import of man-pages 1.70
2004-11-03 13:51:07 +00:00
.fi
.SH DESCRIPTION
.LP
Automated unformatting of parentheses using unformat_parens.sh
2005-10-19 07:07:02 +00:00
.BR bindresvport ()
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
is used to bind a socket descriptor to a privileged anonymous IP port,
that is, a port number arbitrarily selected from the range 512 to 1023.
.\" Glibc actually starts searching with a port # in the range 600 to 1023
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
If the
.BR bind (2)
strip trailing white space
2007-06-21 22:55:04 +00:00
performed by
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.BR bindresvport ()
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
is successful, and
.I sin
is not NULL, then
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.I sin\->sin_port
returns the port number actually allocated.
.I sin
can be NULL, in which case
.I sin\->sin_family
is implicitly taken to be
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.BR AF_INET .
strip trailing white space
2007-06-21 22:55:04 +00:00
However, in this case,
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.BR bindresvport ()
has no way to return the port number actually allocated.
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
(This information can later be obtained using
.BR getsockname (2).)
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.SH RETURN VALUE
.BR bindresvport ()
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
returns 0 on success; otherwise \-1 is returned and
Formatting fix
2004-11-10 17:11:31 +00:00
.I errno
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
set to indicate the cause of the error.
.SH ERRORS
.BR bindresvport ()
can fail for any of the same reasons as
spfix
2007-06-01 06:08:41 +00:00
.BR bind (2).
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
In addition, the following errors may occur:
.TP
.BR EACCES
The caller did not have superuser privilege (to be precise: the
.B CAP_NET_BIND_SERVICE
capability is required).
.TP
.B EADDRINUSE
All privileged ports are in use.
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.TP
bindresvport.3: Since glibc 2.8, EPFNOSUPPORT error is now EAFNOSUPPORT Glibc switched to using a POSIX-specified error code for this error case. http://bugs.linuxbase.org/show_bug.cgi?id=2375 Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com> Acked-by: Stew Benedict <stewb@linux-foundation.org>
2008-11-10 17:12:02 +00:00
.BR EAFNOSUPPORT " (" EPFNOSUPPORT " in glibc 2.7 and earlier)"
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.I sin
is not NULL and
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.I sin->sin_family
strip trailing white space
2007-06-21 22:55:04 +00:00
is not
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.BR AF_INET .
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.SH "CONFORMING TO"
Not in POSIX.1-2001.
Present on the BSDs, Solaris, and many other systems.
.SH NOTES
Unlike some
.BR bindresvport ()
implementations,
the glibc implementation ignores any value that the caller supplies in
.IR sin\->sin_port .
Rewrite and substantial additional text.
2007-05-21 11:00:08 +00:00
.SH SEE ALSO
bindresvport.3: Fix errors regarding port used, plus other rewrites Glibc's bindresvport() takes no notice of sin->sin_port: it always returns an arbitrary reserved port in the anonymous range (512-1023). (Reported by Mats Wichmann.) Also: * Add EADDRINUSE and EACCES errors. * Mention use of getsockname(2). * Other minor rewrites and reorderings of the text. * Explicitly note that glib's bindresvport() ignores sin->sin_port. * Change license There's now virtually no text remaining from the 1.70 version of this page. Reported-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Mats Wichmann <mats.d.wichmann@intel.com> Reviewed-by: Petr Baudis <pasky@suse.cz> Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 03:01:42 +00:00
.BR bind (2),
.BR getsockname (2)