Provided by: manpages-fr-dev_3.65d1p1-1_all bug

NOM

       socket - Créer un point de communication

SYNOPSIS

       #include <sys/types.h> /* Consultez NOTES */
       #include <sys/socket.h>

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

DESCRIPTION

       socket() crée un point de communication, et renvoie un descripteur.

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

       Nom                 Utilisation                       Page
       AF_UNIX, AF_LOCAL   Communication locale              unix(7)
       AF_INET             Protocoles Internet IPv4          ip(7)
       AF_INET6            Protocoles Internet IPv6          ipv6(7)
       AF_IPX              IPX - Protocoles Novell
       AF_NETLINK          Interface utilisateur noyau       netlink(7)
       AF_X25              Protocole ITU-T X.25 / ISO-8208   x25(7)
       AF_AX25             Protocole AX.25 radio amateur
       AF_ATMPVC           Accès direct ATM PVCs
       AF_APPLETALK        Appletalk                         ddp(7)
       AF_PACKET           Interface paquet bas-niveau       packet(7)

       La  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      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 le nouveau  descripteur
                       de   fichier   ouvert.   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 la 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  de  la  socket ;  consultez  protocols(5).  Consultez
       getprotoent(3) pour savoir comment associer un nom de protocole à un numéro.

       Une  socket  de  type  SOCK_STREAM  est  un flux d'octets full-duplex, similaire aux tubes
       (pipes). Elle ne préserve pas les limites d'enregistrements. Une socket  SOCK_STREAM  doit
       être  dans  un  état  connecté  avant  que  des données puisse y être lues ou écrites. Une
       connexion sur une autre socket est  établie  par  l'appel  système  connect(2).  Une  fois
       connectée,  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 la socket avec close(2).  Les
       données hors-bande sont envoyées ou reçues en utilisant 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 la 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 une 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  celles  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.  Elles  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 une 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 la socket.
       L'opération suivante sur cette 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 la socket créée en cas  de  réussite.  En  cas
       d'échec -1 est renvoyé, et errno contient le code d'erreur.

ERREURS

       EACCES La création d'une 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 table des fichiers est pleine.

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

       ENOBUFS ou ENOMEM
              Pas  suffisamment  d'espace pour allouer les tampons nécessaires. La socket ne peut
              être créée 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.

CONFORMITÉ

       BSD 4.4, POSIX.1-2001.

       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

       POSIX.1-2001  ne  requiert  pas  l'inclusion  de  <sys/types.h>,  et cet en‐tête n'est pas
       nécessaire sous Linux. Cependant, il  doit  être  inclus  sous  certaines  implémentations
       historiques (BSD), et les applications portables devraient probablement l'utiliser.

       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.

EXEMPLE

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

VOIR AUSSI

       accept(2),  bind(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), 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.

COLOPHON

       Cette  page  fait partie de la publication 3.65 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».