Man Connect en français
CONNECT(2)                Manuel du programmeur Linux               CONNECT(2)



 

NOM


       connect - Debuter une connexion sur une socket.

 

SYNOPSIS


       #include 
       #include 

       int connect(int sockfd, struct sockaddr *serv_addr, socklen_t addrlen);

 

DESCRIPTION






       L'appel systeme connect() connecte la socket referencee par le descrip-
       teur de fichier sockfd a l'adresse specifiee par serv_addr.  L'argument
       addrlen specifie la taille de serv_addr.  Le format de  l'adresse  dans
       serv_addr est determine par l'espace adresse de la socket sockfd ; voir
       socket(2) pour plus de details.  Si la socket est du  type  SOCK_DGRAM,
       alors  serv_adr est l'adresse a laquelle les datagrammes seront envoyes
       par defaut, et la seule adresse depuis laquelle ils seront recus. Si la
       socket  est du type SOCK_STREAM ou SOCK_SEQPACKET, cette fonction tente
       de se connecter a la socket qui  est  liee  a  l'adresse  indiquee  par
       serv_addr.

       En  general,  les sockets des protocoles orientes connexion ne reussis-
       sent un appel connect() qu'une seule fois,  alors  qu'une  socket  d'un
       protocole  sans  connexion  peut  appeler connect() plusieurs fois pour
       changer son affectation. Une socket sans connexion peut interrompre son
       affectation  en  se connectant sur une adresse avec le membre sa_family
       de la structure sockaddr a la valeur AF_UNSPEC.

 

VALEUR RENVOYEE


       connect() renvoie 0 s'il reussit, ou -1 s'il echoue, auquel  cas  errno
       contient le code d'erreur.

 

ERREURS


       Voici  une liste d'erreurs generales concernant les sockets, il peut en
       exister d'autres specifiques au domaine employe.

       EACCES Pour les sockets de domaine Unix qui sont specifiees par un  nom
              de chemin : la permission en ecriture est refusee sur le fichier
              socket, ou la permission de parcours est refusee pour  l'un  des
              repertoires  composant  le  chemin.   (Voir  aussi  path_resolu-
              tion(2).)

       EACCES, EPERM
              L'utilisateur a tente de connecter une  adresse  broadcast  sans
              avoir  active l'attribut broadcast, ou la demande de connexion a
              echoue a cause des regles d'un firewall local.

 

       EADDRINUSE


              L'adresse est deja utilisee.

 

       EAFNOSUPPORT


              L'adresse transmise n'appartient pas a la famille indiquee  dans
              son champ sa_family.

       EAGAIN Pas  de  port  local  disponible, ou pas assez de place dans les
              tables  de   routage.   Pour   PF_INET   voir   l'appel   sysctl
              net.ipv4.ip_local_port_range dans ip(7) pour savoir comment aug-
              menter le nombre de ports locaux.

 

       EALREADY


              La socket est non bloquante et une tentative de connexion prece-
              dente ne s'est pas encore terminee.

       EBADF  Mauvais descripteur.

 

       ECONNREFUSED


              La connexion est refusee par le serveur.

       EFAULT La structure d'adresse pointe en dehors de l'espace d'adressage.

 

       EINPROGRESS


              La socket est non bloquante, et la connexion ne  peut  pas  etre
              etablie   immediatement.   Il   est  alors  possible  d'utiliser
              select(2) ou poll(2) pour attendre que la socket soit disponible
              en  ecriture.  Une  fois  que  select()  confirme la possibilite
              d'ecrire, utilisez getsockopt(2) pour lire l'option SO_ERROR  du
              niveau  SOL_SOCKET et determiner si connect() s'est termine avec
              succes (SO_ERROR vaut zero) ou en echec (SO_ERROR contient  l'un
              des codes d'erreurs listes ici, indiquant le probleme).

       EINTR  L'appel  systeme a ete interrompu par un signal qui a ete inter-
              cepte.

 

       EISCONN


              La socket est deja connectee.

 

       ENETUNREACH


              Le reseau est inaccessible.

 

       ENOTSOCK


              Le descripteur ne correspond pas a une socket.

 

       ETIMEDOUT


              Depassement du delai maximum pendant la  connexion.  Le  serveur
              peut  etre  trop  charge  pour  accepter une nouvelle connexion.
              Remarquez que pour les sockets IP, le delai peut etre tres  long
              si les syncookies sont actives sur le serveur.

 

CONFORMITE


       SVr4,  BSD  4.4  (La fonction connect() est apparue en premier dans BSD
       4.2).

 

NOTE


       Le troisieme argument de connect() est en fait un int
        et c'est ce qu'utilisent BSD 4.*, libc4 et libc5).  Une certaine  con-
       fusion  POSIX  resulte du "socklen_t" actuel. Les propositions de stan-
       dard n'ont pas encore ete  adoptees,  mais  glibc2  les  suit  deja  et
       utilise socklen_t.  Pour plus de details voir accept(2).

 

BOGUES


       La  deconnexion  d'une  socket en appelant connect() avec un adresse de
       type AF_UNSPEC n'est pas encore implementee.

 

VOIR AUSSI


       accept(2),  bind(2),  getsockname(2),  listen(2),   path_resolution(2),
       socket(2)

 

TRADUCTION


       Ce   document   est  une  traduction  realisee  par  Christophe  Blaess
        le  10 octobre 1996  et  revisee  le
       14 aot 2006.

       L'equipe  de  traduction a fait le maximum pour realiser une adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est  toujours  consultable  via  la  commande :  LANG=C man 2 connect .
       N'hesitez pas a signaler a l'auteur ou au  traducteur,  selon  le  cas,
       toute erreur dans cette page de manuel.



Linux 2.6.7                      23 juin 2004                       CONNECT(2)