oracular (2) bind.2.gz

Provided by: manpages-fr-dev_4.23.1-1_all bug

NOM

       bind - Fournir un nom à un socket

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/socket.h>

       int bind(int sockfd, const struct sockaddr *addr,
                socklen_t addrlen);

DESCRIPTION

       Quand  un  socket  est  créé  avec l'appel système socket(2), elle existe dans l'espace des noms (famille
       d'adresses) mais n'a pas d'adresse assignée. bind()  affecte  l'adresse  indiquée  dans  addr  au  socket
       référencé  par  le  descripteur  de fichier sockfd. addrlen indique la taille, en octets, de la structure
       d'adresse pointée par addr. Traditionnellement cette opération est appelée « affectation d'un  nom  à  un
       socket ».

       Il  est  normalement  nécessaire d'affecter une adresse locale avec bind() avant qu'un socket SOCK_STREAM
       puisse recevoir des connexions (consultez accept(2)).

       Les règles d'affectation de nom varient suivant les familles d'adresses. Consultez les pages de manuel de
       la  section  7  pour  de  plus amples informations. Pour AF_INET consultez ip(7), pour AF_INET6 consultez
       ipv6(7), pour AF_UNIX consultez unix(7), pour AF_APPLETALK consultez  ddp(7),  pour  AF_PACKET  consultez
       packet(7), pour AF_X25 consultez x25(7) et pour AF_NETLINK consultez netlink(7).

       La  structure  réellement  passée dans le paramètre addr dépend du domaine de communication. La structure
       sockaddr est définie comme :

           struct sockaddr {
               sa_family_t sa_family;
               char        sa_data[14];
           }

       Le seul objet de cette structure  est  de  transtyper  le  pointeur  passé  dans  addr  pour  éviter  les
       avertissements du compilateur. Voir EXEMPLES ci-dessous.

VALEUR RENVOYÉE

       En  cas  de  succès, zéro est renvoyé. En cas d'erreur, -1 est renvoyé et errno est définie pour préciser
       l'erreur.

ERREURS

       EACCES L'adresse est protégée et l'utilisateur n'est pas le superutilisateur.

       EADDRINUSE
              L'adresse est déjà utilisée.

       EADDRINUSE
              (Socket Internet) le numéro de port a reçu la valeur zéro dans la structure d'adresse  de  socket,
              mais  lors  d'une  tentative  d'attachement à un port éphémère, aucun port n'était disponible dans
              l'intervalle    des     ports     éphémères.     Consultez     les     explications     concernant
              /proc/sys/net/ipv4/ip_local_port_range dans ip(7).

       EBADF  sockfd n'est pas un descripteur de fichier valable.

       EINVAL Le socket est déjà connecté.

       EINVAL addrlen est faux ou addr n'est pas une adresse valide pour le domaine de ce socket.

       ENOTSOCK
              Le descripteur de fichier sockfd ne fait pas référence à un socket.

       Les erreurs suivantes sont spécifiques aux sockets du domaine UNIX (AF_UNIX) :

       EACCES L'accès à un élément du chemin est interdit. (Voir aussi path_resolution(7).)

       EADDRNOTAVAIL
              Une interface inexistante est demandée, ou bien l'adresse demandée n'est pas locale.

       EFAULT addr pointe en dehors de l'espace d'adresse accessible.

       ELOOP  addr contient des références circulaires (à travers un lien symbolique).

       ENAMETOOLONG
              addr est trop long.

       ENOENT Un composant du préfixe du répertoire du chemin de le socket n'existe pas.

       ENOMEM La mémoire disponible du noyau n'était pas suffisante.

       ENOTDIR
              Un élément du chemin d'accès n'est pas un répertoire.

       EROFS  L'inœud du socket se trouverait dans un système de fichiers en lecture seule.

STANDARDS

       POSIX.1-2008.

HISTORIQUE

       POSIX.1-2001, SVr4, 4.4BSD (bind() est apparu dans 4.2BSD).

BOGUES

       Les options de proxy transparent ne sont pas décrites.

EXEMPLES

       Un exemple d'utilisation de bind() avec des sockets Internet se trouve dans getaddrinfo(3).

       L'exemple  suivant  montre  comment affecter un nom à un socket du domaine UNIX (AF_UNIX) et accepter les
       connexions :

       #include <stdio.h>
       #include <stdlib.h>
       #include <string.h>
       #include <sys/socket.h>
       #include <sys/un.h>
       #include <unistd.h>

       #define MY_SOCK_PATH "/un_chemin"
       #define LISTEN_BACKLOG 50

       #define handle_error(msg) \
           do { perror(msg); exit(EXIT_FAILURE); } while (0)

       int
       main(void)
       {
           int                 sfd, cfd;
           socklen_t           peer_addr_size;
           struct sockaddr_un  my_addr, peer_addr;

           sfd = socket(AF_UNIX, SOCK_STREAM, 0);
           if (sfd == -1)
               handle_error("socket");

           memset(&my_addr, 0, sizeof(my_addr));
           my_addr.sun_family = AF_UNIX;
           strncpy(my_addr.sun_path, MY_SOCK_PATH,
                   sizeof(my_addr.sun_path) - 1);

           if (bind(sfd, (struct sockaddr *) &my_addr,
                    sizeof(my_addr)) == -1)
               handle_error("bind");

           if (listen(sfd, LISTEN_BACKLOG) == -1)
               handle_error("listen");

           /* Nous pouvons maintenant accepter les connexions
              entrantes une à la fois grâce à accept(2). */

           peer_addr_size = sizeof(peer_addr);
           cfd = accept(sfd, (struct sockaddr *) &peer_addr,
                        &peer_addr_size);
           if (cfd == -1)
               handle_error("accept");

           /* Code gérant les connexions entrantes... */

           if (close(sfd) == -1)
               handle_error("close");

           if (unlink(MY_SOCK_PATH) == -1)
               handle_error("unlink");
       }

VOIR AUSSI

       accept(2),  connect(2),  getsockname(2),  listen(2),  socket(2),  getaddrinfo(3),  getifaddrs(3),  ip(7),
       ipv6(7), path_resolution(7), socket(7), unix(7)

TRADUCTION

       La   traduction   française   de   cette   page   de   manuel   a   été   créée   par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>,  François  Micaux,  Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,      Thomas      Huriaux      <thomas.huriaux@gmail.com>,     Nicolas     François
       <nicolas.francois@centraliens.net>,    Florentin    Duneau    <fduneau@gmail.com>,     Simon     Paillard
       <simon.paillard@resel.enst-bretagne.fr>,     Denis    Barbier    <barbier@debian.org>,    David    Prévot
       <david@tilapin.org>,    Cédric    Boutillier     <cedric.boutillier@gmail.com>,     Frédéric     Hantrais
       <fhantrais@gmail.com> et Jean-Philippe MENGUAL <jpmengual@debian.org>

       Cette  traduction  est  une  documentation libre ; veuillez vous reporter à la GNU General Public License
       version 3  ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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 à
       ⟨debian-l10n-french@lists.debian.org⟩.