bindresvport - Affecter une socket à un port IP privilégié
Bibliothèque C standard (
libc,
-lc)
#include <sys/types.h>
#include <netinet/in.h>
int bindresvport(int sockfd, struct sockaddr_in *sin);
bindresvport() est utilisée pour affecter un socket auquel fait
référence le descripteur de fichier
sockfd à un
port IP privilégié anonyme, c'est-à-dire un numéro
de port arbitrairement sélectionné dans l'intervalle [512,
1023].
Si le
bind(2) réalisé par
bindresvport()
réussi et si
sin est non NULL, alors
sin->sin_port
renvoie le numéro de port alloué.
sin peut être NULL, dans ce cas
sin->sin_family est
simplement considéré comme
AF_INET. Cependant, dans ce
cas,
bindresvport() ne peut renvoyer le port actuellement alloué
(cette information peut être obtenu ultérieurement avec
getsockname(2)).
bindresvport() renvoie
0 en cas de succès. En cas d'erreur,
-1 est renvoyé et
errno est défini pour indiquer
l'erreur.
bindresvport() peut échouer pour les mêmes raisons que
bind(2). De plus, les erreurs suivantes peuvent se produire :
- EACCES
- Le processus appelant n'était pas
privilégié (sur Linux : le processus appelant n'a pas
la capacité CAP_NET_BIND_SERVICE dans l'espace de noms
utilisateur contrôlant son espace de noms réseau).
- EADDRINUSE
- Tous les ports privilégiés sont
utilisés.
-
EAFNOSUPPORT (EPFNOSUPPORT dans la
glibc 2.7 et antérieure)
-
sin est non NULL et sin->sin_family n'est
pas AF_INET.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
| Interface |
Attribut |
Valeur |
|
bindresvport() |
Sécurité des threads |
. glibc >= 2.17 : MT-Safe;
glibc < 2.17 : MT-Unsafe |
Avant glibc 2.17, la fonction
bindresvport() utilisait une variable
statique non protégée par un verrou, et n’était
donc pas sûre dans un contexte multithread.
Absent de POSIX.1. Présent sur les systèmes BSD, Solaris et
beaucoup d'autres.
Contrairement à d'autres implémentations de
bindresvport(),
l'implémentation de la glibc ignore toutes les valeurs que l'appelant
passe à
sin->sin_port.
bind(2),
getsockname(2)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]>,
Cédric Boutillier <
[email protected]>,
Frédéric Hantrais <
[email protected]> et Jean-Pierre
Giraud <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]