NOM

       socket - Créer un point de communication

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <sys/socket.h>

       int socket(int domain, int type, int protocol);

DESCRIPTION

       socket()  crée  un  point  de  communication  et renvoie un descripteur de fichier qui s'y
       rapporte. Le descripteur de fichier renvoyé par un appel réussi sera celui  au  numéro  le
       plus bas qui n'est pas ouvert actuellement pour le processus.

       Le  paramètre  domain indique le domaine de communication ; cela sélectionne la famille de
       protocole à employer. Elles sont définies dans  le  fichier  <sys/socket.h>.  Les  formats
       actuellement compris par le noyau Linux sont :

       Nom          Objectif                                   Page de manuel
       AF_UNIX      Communication locale                       unix(7)
       AF_LOCAL     Synonyme de AF_UNIX
       AF_INET      Protocoles Internet IPv4                   ip(7)
       AF_AX25      Protocole radio amateur AX.25              ax25(4)
       AF_IPX       IPX - Protocoles Novell
       AF_APPLETALK AppleTalk                                  ddp(7)
       AF_X25       Protocole ITU-T X.25 / ISO-8208            x25(7)
       AF_INET6     Protocoles Internet IPv6                   ipv6(7)
       AF_DECnet    Sockets de protocole DECet
       AF_KEY       Protocole de gestion de clé, développé à
                    l'origine pour être utilisé avec IPsec
       AF_NETLINK   Interface utilisateur noyau                netlink(7)
       AF_PACKET    Interface paquet bas-niveau                packet(7)
       AF_RDS       Protocole  Reliable   Datagram   Sockets   rds(7)
                    (RDS)                                      rds-rdma(7)
       AF_PPPOX     Couche  de  transport PPP générique pour
                    paramétrer  des  tunnels  L2  (L2TP   et
                    PPPoE)
       AF_LLC       Protocole  de  contrôle  de lien logique
                    (IEEE 802.2 LLC)
       AF_IB        Adressage natif InfiniBand
       AF_MPLS      Multiprotocole Label Switching
       AF_CAN       Protocole du bus Controller Area Network
                    automotive
       AF_TIPC      Protocole  TIPC, « sockets de domaine de
                    grappe »
       AF_BLUETOOTH Protocole  du  socket  de   bas   niveau
                    Bluetooth
       AF_ALG       Interface  avec  l'API de chiffrement du
                    noyau
       AF_VSOCK     Protocole VSOCK  (initialement  « VMWare   vsock(7)
                    VSockets »)       de       communication
                    hyperviseur-invité
       AF_KCM       Interface KCM (multiplexeur de connexion
                    au noyau)
       AF_XDP       Interface XDP (express data path)

       Vous  pouvez  trouver plus de détails sur les familles d'adresses ci-dessus, ainsi que des
       informations sur plusieurs autres familles d'adresses, dans address_families(7).

       Le socket a le type indiqué, ce qui indique la sémantique des  communications.  Les  types
       définis actuellement sont :

       SOCK_STREAM     Support  de  dialogue  garantissant  l'intégrité,  fournissant  un flux de
                       données binaires, et intégrant un  mécanisme  pour  les  transmissions  de
                       données hors-bande.

       SOCK_DGRAM      Prise  en  charge  des  datagrammes  (transmissions  sans  connexion,  non
                       garantie, de datagrammes de longueur maximale fixe).

       SOCK_SEQPACKET  Dialogue garantissant l'intégrité, pour le  transport  de  datagrammes  de
                       longueur  fixe. Le lecteur doit lire le paquet de données complet à chaque
                       appel système récupérant l'entrée.

       SOCK_RAW        Accès direct aux données réseau.

       SOCK_RDM        Transmission  fiable  de  datagrammes,  sans  garantie   de   l'ordre   de
                       délivrance.

       SOCK_PACKET     Obsolète,  à  ne  pas  utiliser  dans  les  programmes  actuels. Consultez
                       packet(7).

       Certains types de sockets peuvent ne pas être  implémentés  par  toutes  les  familles  de
       protocoles.

       Depuis Linux 2.6.27, le paramètre type a un autre objectif : en plus d'indiquer le type de
       socket, il peut inclure les valeurs suivantes en les combinant par  un  OU  binaire,  pour
       modifier le comportement de socket() :

       SOCK_NONBLOCK   Placer  l'attribut  d'état  de  fichier  O_NONBLOCK  sur la description du
                       fichier ouvert référencée par le nouveau descripteur de fichier (consulter
                       open(2)).  Utiliser  cet  attribut  économise des appels supplémentaires à
                       fcntl(2) pour obtenir le même résultat.

       SOCK_CLOEXEC    Placer  l'attribut   « close-on-exec »   (FD_CLOEXEC)   sur   le   nouveau
                       descripteur  de  fichier. Consultez la description de l'attribut O_CLOEXEC
                       dans open(2) pour savoir pourquoi cela peut être utile.

       Le protocole à utiliser sur le socket est indiqué par l'argument protocol. Normalement, il
       n'y  a  qu'un  seul  protocole  par  type  de  socket  pour une famille donnée, auquel cas
       l'argument protocol peut être  nul.  Néanmoins,  rien  ne  s'oppose  à  ce  que  plusieurs
       protocoles  existent, auquel cas il est nécessaire de le spécifier. Le numéro de protocole
       dépend  du  domaine  de  communication  du  socket ;  consultez  protocols(5).   Consultez
       getprotoent(3) pour savoir comment associer un nom de protocole à un numéro.

       Des  sockets de type SOCK_STREAM sont des flux d'octets full-duplex. Ils ne préservent pas
       les limites d'enregistrements. Un socket SOCK_STREAM doit être dans un état connecté avant
       que  des  données  puissent  y être lues ou écrites. Une connexion sur un autre socket est
       établie par l'appel système connect(2). Une fois connecté, les données y  sont  transmises
       par  read(2)  et write(2) ou par des variantes de send(2) et recv(2). Quand une session se
       termine, on referme le socket avec close(2).  Les  données  hors-bande  sont  envoyées  ou
       reçues comme il est décrit dans send(2) et recv(2).

       Les  protocoles  de  communication  qui  implémentent les sockets SOCK_STREAM garantissent
       qu'aucune donnée n'est perdue ou  dupliquée.  Si  un  bloc  de  données,  pour  lequel  le
       correspondant  a  suffisamment  de  place dans son tampon, n'est pas transmis correctement
       dans un délai raisonnable, la connexion est considérée  comme  inutilisable.  Si  l'option
       SO_KEEPALIVE  est  activée  sur le socket, le protocole vérifie, d'une manière qui lui est
       spécifique, si le correspondant est toujours  actif.  Un  signal  SIGPIPE  est  envoyé  au
       processus  tentant  d'écrire  sur un socket inutilisable, forçant les programmes ne gérant
       pas ce signal à se terminer. Les sockets de type SOCK_SEQPACKET emploient les mêmes appels
       système que ceux de types SOCK_STREAM, à la différence que la fonction read(2) ne renverra
       que le nombre d'octets requis,  et  toute  autre  donnée  restante  dans  le  paquet  sera
       éliminée. De plus, les frontières des messages seront préservées.

       Les  sockets  de  type  SOCK_DGRAM  ou  SOCK_RAW  permettent  l'envoi  de  datagrammes aux
       correspondants indiqués dans l'appel système sendto(2). Les datagrammes sont  généralement
       lus par la fonction recvfrom(2), qui fournit également l'adresse du correspondant.

       Les  sockets  SOCK_PACKET  sont  obsolètes.  Ils  servent  à  recevoir  les  paquets bruts
       directement depuis le gestionnaire de périphérique. Utilisez plutôt packet(7).

       Un appel à fcntl(2) avec l'argument F_SETOWN permet de préciser un processus ou un  groupe
       de processus qui recevront un signal SIGURG lors de l'arrivée de données hors-bande, ou le
       signal SIGPIPE lorsqu'une connexion sur un  socket  SOCK_STREAM  se  termine  inopinément.
       Cette  fonction  permet  également  de  définir  le  processus  ou groupe de processus qui
       recevront une notification asynchrone  des  événements  d'entrées-sorties  par  le  signal
       SIGIO.  L'utilisation  de  F_SETOWN  est  équivalent  à  un appel ioctl(2) avec l'argument
       FIOSETOWN ou SIOCSPGRP.

       Lorsque le réseau indique une condition d'erreur au module du protocole (par exemple  avec
       un  message  ICMP  pour  IP),  un  drapeau  signale  une  erreur en attente sur le socket.
       L'opération suivante sur ce socket renverra ce code d'erreur. Pour certains protocoles, il
       est  possible  d'activer  une  file  d'attente d'erreurs par socket. Pour plus de détails,
       consultez IP_RECVERR dans ip(7).

       Les opérations sur les sockets sont contrôlées par  des  options  du  niveau  socket.  Ces
       options  sont  définies  dans <sys/socket.h>. Les fonctions setsockopt(2) et getsockopt(2)
       sont utilisées respectivement pour définir ou lire les options.

VALEUR RENVOYÉE

       socket() renvoie un descripteur référençant le socket créé en  cas  de  réussite.  En  cas
       d'échec -1 est renvoyé et errno est positionné pour indiquer l'erreur.

ERREURS

       EACCES La création d'un socket avec le type et le protocole indiqués n'est pas autorisée.

       EAFNOSUPPORT
              L'implémentation ne supporte pas la famille d'adresses indiquée.

       EINVAL Protocole inconnu, ou famille de protocole inexistante.

       EINVAL Attributs incorrects dans type.

       EMFILE La limite du nombre de descripteurs de fichiers par processus a été atteinte.

       ENFILE La  limite  du  nombre  total  de  fichiers  ouverts  pour  le système entier a été
              atteinte.

       ENOBUFS ou ENOMEM
              Pas suffisamment d'espace pour allouer les tampons nécessaires. Le socket  ne  peut
              être créé tant que suffisamment de ressources ne sont pas libérées.

       EPROTONOSUPPORT
              Le type de protocole, ou le protocole lui-même n'est pas disponible dans ce domaine
              de communication.

       D'autres erreurs peuvent être dues aux modules de protocoles sous-jacents.

STANDARDS

       POSIX.1-2001, POSIX.1-2008, 4.4BSD.

       Les attributs SOCK_NONBLOCK et SOCK_CLOEXEC sont spécifiques à Linux.

       La fonction socket() est apparue dans BSD 4.2. Elle est généralement portable de/vers  les
       systèmes  non-BSD  supportant  des  clones  des  sockets  BSD  (y compris les variantes de
       System V).

NOTES

       Les constantes explicites utilisées sous BSD 4.x pour  les  familles  de  protocoles  sont
       PF_UNIX,  PF_INET,  etc. alors que AF_UNIX, AF_INET, etc. sont utilisées pour les familles
       d'adresses. Toutefois, même la page de manuel de BSD indiquait « La famille de  protocoles
       est  généralement  la  même  que  la  famille  d'adresses »,  et  les standards ultérieurs
       utilisent AF_* partout.

EXEMPLES

       Un exemple d'utilisation de socket() se trouve dans la page de manuel de getaddrinfo(3).

VOIR AUSSI

       accept(2),  bind(2),  close(2),  connect(2),  fcntl(2),  getpeername(2),   getsockname(2),
       getsockopt(2),  ioctl(2),  listen(2),  read(2),  recv(2), select(2), send(2), shutdown(2),
       socketpair(2), write(2), getprotoent(3), address_families(7),  ip(7),  socket(7),  tcp(7),
       udp(7), unix(7)

       « An  Introductory  4.3BSD  Interprocess  Communication  Tutorial »  et « BSB Interprocess
       Communication Tutorial », réimprimés dans UNIX Programmer's Supplementary Documents Volume
       1.

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⟩.