Comment Ca Marche l'informatique ?
Accueil
Forum
Aide
bordure
Page d'accueil
Ajouter aux favoris
Signalez une erreur
Ecrire à Jean-Francois Pillou
Introduction
La communication
Les fonctions
Version 2.0.3
Les fonctions de l'API Socket Page précédente Retour à la page d'accueil

Les fonctions des sockets en détail

La fonction socket()

La création d'un socket se fait grâce à la fonction socket():

int socket(famille,type,protocole)
  • famille représente la famille de protocole utilisé (AF_INET pour TCP/IP utilisant une adresse Internet sur 4 octets: l'adresse IP ainsi qu'un numéro de port afin de pouvoir avoir plusieurs sockets sur une même machine, AF_UNIX pour les communications UNIX en local sur une même machine)
  • type indique le type de service (orienté connexion ou non). Dans le cas d'un service orienté connexion (c'est généralement le cas), l'argument type doit prendre la valeur SOCK_STREAM (communication par flot de données). Dans le cas contraire (protocole UDP) le paramètre type doit alors valoir SOCK_DGRAM (utilisation de datagramme, blocs de données)
  • protocole permet de spécifier un protocole permettant de fournir le service désiré. Dans le cas de la suite TCP/IP il n'est pas utile, on le mettra ainsi toujours à 0
La fonction socket() renvoie un entier qui correspond à un descripteur du socket nouvellement créé et qui sera passé en paramètre aux fonctions suivantes. En cas d'erreur, la fonction socket() retourne -1.

Voici un exemple d'utilisation de la fonction socket() :

descripteur = socket(PF_INET,SOCK_STREAM,0);

La fonction bind()

Après création du socket, il s'agit de le lier à un point de communication défini par une adresse et un port, c'est le rôle de la fonction bind():

bind(int descripteur,sockaddr localaddr,int addrlen)
  • descripteur représente le descripteur du socket nouvellement créé
  • localaddr est une structure qui spécifie l'adresse locale à travers laquelle le programme doit communiquer
    Le format de l'adresse est fortement dépendant du protocole utilisé :
    • l'interface socket définit une structure standard (sockaddr définie dans <sys/socket.h>) permettant de représenter une adresse:
      struct sockaddr {
      /* longueur effective de l'adresse */
      u_char sa_len;
      
      /* famille de protocole (generalement AF_INET) */
      u_char sa_family;
      
      /* l'adresse complete */
      char sa_data[14];
      
      }
      • sa_len est un octet (u_char) permettant de définir la longueur utile de l'adresse (la partie réellement utilisée de sa_data)
      • sa_family représente la famille de protocole (AF_INET pour TCP/IP)
      • sa_data est une chaîne de de 14 caractères (au maximum) contenant l'adresse
    • La structure utilisé avec TCP/IP est une adresse AF_INET (Généralement les structures d'adresses sont redéfinies pour chaque famille d'adresse). Les adresses AF_INET utilisent une structure sockaddr_in définie dans <netinet/in.h> :
      struct sockaddr_in {
      /* famille de protocole (AF_INET) */
      short sin_family;
      
      /* numero de port */
      u_short sin_port;
      
      /* adresse internet */
      struct in_addr sin_addr;
      
      char sin_zero[8];	/* initialise a zero */
      
      }
      • sin_family représente le type de famille
      • sin_port représente le port à contacter
      • sin_addr adresse de l'hôte
      • sin_zero[8] contient uniquement des zéros (étant donné que l'adresse IP et le port occupent 6 octets, les 8 octets restants doivent être à zéro
  • addrlen indique la taille du champ localaddr. On utilise généralement sizeof(localaddr).
Voici un exemple d'utilisation de la fonction bind() :
sockaddr_in localaddr ; 

localaddr.sin_family = AF_INET; /* Protocole internet */

/* Toutes les adresses IP de la station */
localaddr.sin_addr.s_addr = htonl(INADDR_ANY);

/* port d'écoute par défaut au dessus des ports réservés */
localaddr.sin_port = htons(port);
if (bind(          listen_socket,
                   (struct sockaddr*)&localaddr,
                   sizeof(localaddr) )  == SOCKET_ERROR) {

          // Traitement de l'erreur;

}

Le numéro fictif INADDR_ANY signifie que la socket peut-être associée à n'importe quelle adresse IP de la machine locale (s'il en existe plusieurs). Pour spécifier une adresse IP spécifique à utiliser, il est possible d'utiliser la fonction inet_addr()

inet_addr("127.0.0.1");

/* utilisation de l'adresse de boucle locale */

La socket peut être reliée à un port libre quelconque en utilisant le numéro 0

La fonction listen()

La fonction listen() permet de mettre une socket en attente de connexion.

La fonction listen() ne s'utilise qu'en mode connecté (donc avec le protocole TCP)

int listen(int socket,int backlog)
  • socket représente la socket précédemment ouverte
  • backlog représente le nombre maximal de connexions pouvant être mises en attente
La fonction listen() retourne la valeur SOCKET_ERROR en cas de problème, sinon elle retourne 0.

Voici un exemple d'utilisation de la fonction listen() :

if (listen(socket,10) == SOCKET_ERROR) { 

// traitement de l'erreur

}

La fonction accept()

La fonction accept() permet la connexion en acceptant un appel :

int accept(int socket,struct sockaddr * addr,int * addrlen)
  • socket représente la socket précédemment ouverte (la socket locale)
  • addr représente un tampon destiné à stocker l'adresse de l'appelant
  • addrlen représente la taille de l'adresse de l'appelant
La fonction accept() retourne un identificateur du socket de réponse. Si une erreur intervient la fonction accept() retourne la valeur INVALID_SOCKET.

Voici un exemple d'utilisation de la fonction accept() :

Sockaddr_in Appelant; 

/* structure destinee a recueillir les renseignements sur l'appelant

Appelantlen = sizeof(from);

accept(socket_locale,(struct sockaddr*)&Appelant, &Appelantlen);

La fonction connect()

La fonction connect() permet d'établir une connexion avec un serveur :

int connect(int socket,struct sockaddr * addr,int * addrlen)
  • socket représente la socket précédemment ouverte (la socket à utiliser)
  • addr représente l'adresse de l'hôte à contacter. Pour établir une connexion, le client ne nécessite pas de faire un bind()
  • addrlen représente la taille de l'adresse de l'hôte à contacter
La fonction connect() retourne 0 si la connexion s'est bien déroulée, sinon -1.

Voici un exemple d'utilisation de la fonction connect(), qui connecte le socket "s" du client sur le port port de l'hôte portant le nom serveur :

toinfo = gethostbyname(serveur); 

toaddr = (u_long *)toinfo.h_addr_list[0];

/* Protocole internet */
to.sin_family = AF_INET;

/* Toutes les adresses IP de la station */
to.sin_addr.s_addr = toaddr;

/* port d'écoute par défaut au dessus des ports réservés */
to.sin_port = htonl(port);

if (connect(socket,(struct sockaddr*)to,sizeof(to)) == -1) { 

// Traitement de l'erreur; 

}

La fonction recv()

La fonction recv() permet de lire dans un socket en mode connecté (TCP)

int recv(int socket,char * buffer,int len,int flags)
  • socket représente la socket précédemment ouverte
  • buffer représente un tampon qui recevra les octets en provenance du client
  • len indique le nombre d'octets à lire
  • flags correspond au type de lecture à adopter :
    • le flag MSG_PEEK indiquera que les données lues ne sont pas retirées de la queue de réception
    • le flag MSG_OOB indiquera que les données urgentes (Out Of Board) doivent être lues
    • le flag 0 indique une lecture normale
La fonction recv() renvoie le nombre d'octets lus. De plus cette fonction bloque le processus jusqu'à ce qu'elle reçoive des données

Voici un exemple d'utilisation de la fonction recv() :

retour = recv(socket,Buffer,sizeof(Buffer),0 ); 

if (retour == SOCKET_ERROR) { 

// traitement de l'erreur

}

La fonction send()

La fonction send() permet d'écrire dans un socket (envoyer des données) en mode connecté (TCP)

int send(int socket,char * buffer,int len,int flags)
  • socket représente la socket précédemment ouverte
  • buffer représente un tampon contenant les octets à envoyer au client
  • len indique le nombre d'octets à envoyer
  • flags correspond au type d'envoi à adopter :
    • le flag MSG_DONTROUTE indiquera que les données ne routeront pas
    • le flag MSG_OOB indiquera que les données urgentes (Out Of Board) doivent être envoyées
    • le flag 0 indique un envoi normal
La fonction send() renvoie le nombre d'octets effecivement envoyés.

Voici un exemple d'utilisation de la fonction send() :

retour = send(socket,Buffer,sizeof(Buffer),0 ); 

if (retour == SOCKET_ERROR) { 

// traitement de l'erreur

}

Les fonctions close() et shutdown()

La fonction close() permet la fermeture d'un socket en permettant au système d'envoyer les données restantes (pour TCP) :

int close(int socket)
La fonction shutdown() permet la fermeture d'un socket dans un des deux sens (pour une connexion full-duplex) :
int shutdown(int socket,int how)
  • Si how est égal à 0, la socket est fermée en réception
  • Si how est égal à 1, la socket est fermée en émission
  • Si how est égal à 2, la socket est fermée dans les deux sens
close() comme shutdown() retournent -1 en cas d'erreur, 0 si la fermeture se déroule bien.


Ce document issu de CommentCaMarche.net est soumis à la licence GNU FDL. Vous pouvez copier, modifier des copies de cette page tant que cette note apparaît clairement.