Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] send, sendto, sendmsg - Envoyer un message sur une socket. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/types.h>[/b] [b][/b] [b]#include <sys/socket.h>[/b] [b][i]int send(int s , const void * msg , size_t len ,[/i][/b] [b][i]int flags );[/i][/b] [b][i]int sendto(int s , const void * msg , size_t len ,[/i][/b] [b][i]int flags , const struct sockaddr * to , socklen_t tolen );[/i][/b] [b][i]int sendmsg(int s , const struct msghdr * msg ,[/i][/b] [b][i]int flags );[/i][/b] [size=18] [b]Description[/b] [/size] [b]Send ,[/b] [b]sendto ,[/b] et [b]sendmsg[/b] permettent de transmettre un message à destination d'une autre socket. [b]Send[/b] ne peut être utilisé qu'avec les sockets [i]connectées[/i] alors que [b]sendto[/b] et [b]sendmsg[/b] peuvent être utilisés tout le temps. L'adresse de la cible est donnée par [i]to[/i] avec la longueur [i]tolen.[/i] la longueur du message est indiquée dans [b]len .[/b] Si le message est trop long pour être transmis intégralement au protocole sous-jacent, l'erreur [b]EMSGSIZE[/b] sera déclenchée et rien ne sera émis. Aucune indication d'échec de distribution n'est fournie par [b]send .[/b] Seules les erreurs locales sont détectées, et indiquées par une valeur de retour -1. Si la socket ne dispose pas de la place suffisante pour le message, alors [b]send[/b] va bloquer, à moins que la socket ait été configurée en mode d'entrées/sorties non-bloquantes auquel cas elle renverra [b]EAGAIN .[/b] On peut utiliser l'appel système [b]select (2)[/b] pour vérifier s'il est possible d'émettre des données. Le paramètre [i]flags[/i] peut contenir une ou plusieurs des options suivantes [b]MSG_OOB[/b] [table][row][col]    [/col][col]est utilisée pour émettre des données [i]hors-bande[/i] sur une socket qui l'autorise (par ex : [b]SOCK_STREAM ).[/b] Le protocole sous-jacent doit également autoriser l'émission de données [i]hors-bande.[/i][/col][/row][/table] [b]MSG_DONTROUTE[/b] [table][row][col]    [/col][col]est utilisé pour empêcher la transmission d'un paquet vers une passerelle, n'envoyer de données que vers les hôtes directement connectés au réseau. Ceci n'est normalement employé que par les programmes de diagnostique ou de routage. Cette option n'est définie que pour les familles de protocoles employant le routage, pas les sockets par paquets.[/col][/row][/table] [b]MSG_DONTWAIT[/b] [table][row][col]    [/col][col]active le mode non-bloquant. Une opération qui devrait bloquer renverra [b]EAGAIN[/b] à la place (Cela peut être également paramétré avec l'option [b]O_NONBLOCK[/b] de la fonction [b]F_SETFL[/b] de [b]fcntl(2)).[/b][/col][/row][/table] [b]MSG_NOSIGNAL[/b] [table][row][col]    [/col][col]demande de ne pas envoyer de signal [b]SIGPIPE[/b] d'erreur sur les sockets connectées lorsque le correspondant coupe la connexion. L'erreur [b]EPIPE[/b] est toutefois renvoyée.[/col][/row][/table] [b]MSG_CONFIRM (Depuis Linux 2.3)[/b] [table][row][col]    [/col][col]Indiquer à la couche de liaison qu'une réponse correcte a été reçue du correspondant. Si la couche de liaison n'a pas cette confirmation, elle va ré-interroger régulièrement le voisinage (par exemple avec un ARP unicast). Seulement valide pour les sockets [b]SOCK_DGRAM[/b] et [b]SOCK_RAW[/b] et uniquement implémenté pour IPv4 et IPv6. Voir [b]arp (7)[/b] pour plus de détails.[/col][/row][/table] La définition de la structure [i]msghdr[/i] se trouve ci-dessous. Voir [b]recv (2)[/b] pour une description exacte de ses champs. [table][row][col]    [/col][col] [table][row][col]    [/col][col].nf .ta 4n 17n 33n struct msghdr { void * msg_name; /* optional address / socklen_t msg_namelen; / size of address / struct iovec msg_iov; /* scatter/gather array / size_t msg_iovlen; / # elements in msg_iov / void msg_control; /* ancillary data, see below / socklen_t msg_controllen; / ancillary data buffer len / int msg_flags; / flags on received message / }; .ta .fi[/col][/row][/table][/col][/row][/table] On peut transmettre des informations de service en employant les membres [i]msg_control[/i] et [b]msg_controllen .[/b] La longueur maximale du buffer de service que le noyau peut gérer est limité par socket par la valeur [b]net.core.optmem_max[/b] de sysctl(). Voir [b]socket (7).[/b] [size=18] [b]Valeur renvoyée[/b] [/size] Ces appels systèmes renvoient le nombre de caractères émis, ou -1 s'ils échouent, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] Voici les erreurs standards engendrés par la couche socket. Des erreurs supplémentaires peuvent être déclenchées par les protocoles sous-jacents. Voir leurs pages de manuel respectives. [b]EBADF[/b] [table][row][col]    [/col][col]Descripteur de socket invalide.[/col][/row][/table] [b]ENOTSOCK[/b] [table][row][col]    [/col][col]L'argument [i]s[/i] n'est pas une socket.[/col][/row][/table] [b]EFAULT[/b] [table][row][col]    [/col][col]Un paramètre pointe en dehors de l'espace d'adressage accessible.[/col][/row][/table] [b]EMSGSIZE[/b] [table][row][col]    [/col][col]La socket nécessite une émission intégrale du message mais la taille de celui-ci ne le permet pas.[/col][/row][/table] [b]EAGAIN ou EWOULDBLOCK[/b] [table][row][col]    [/col][col]La socket est non-bloquante et l'opération demandée bloquerait.[/col][/row][/table] [b]ENOBUFS[/b] [table][row][col]    [/col][col]La file d'émission de l'interface réseau est pleine. Ceci indique généralement une panne de l'interface réseau, mais peut également être dû à un engorgement passager. Ceci ne doit pas se produire sous Linux, les paquets sont silencieusement éliminés.[/col][/row][/table] [b]EINTR[/b] [table][row][col]    [/col][col]Un signal a été reçu.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Pas assez de mémoire pour le noyau.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Un argument invalide a été transmis.[/col][/row][/table] [b]EPIPE[/b] [table][row][col]    [/col][col]L'écriture est impossible (correspondant absent). Dans ce cas le processus recevra également un signal [b]SIGPIPE[/b] sauf s'il a activée l'option [b]MSG_NOSIGNAL .[/b][/col][/row][/table] [size=18] [b]Conformité[/b] [/size] BSD 4.4 (cet appel système est apparu dans BSD 4.2), SVr4, Draft POSIX 1003.1g. [b]MSG_CONFIRM[/b] est une extension Linux. [size=18] [b]Note[/b] [/size] Les prototypes fournis plus haut suivent les Spécifications Single Unix, tout comme glibc2. L'argument [i]flags[/i] était un `int' dans BSD 4., mais `unsigned int' dans libc4 et libc5. L'argument [i]len[/i] était un `int' dans BSD 4.* et libc4, mais un `size_t' dans libc5; L'argument [i]tolen[/i] était un `int' dans BSD 4.*, libc4 et libc5. Voir aussi les notes accompagnant la page [b]accept (2).[/b] [size=18] [b]Voir aussi[/b] [/size] [b]fcntl (2),[/b] [b]recv (2),[/b] [b]select (2),[/b] [b]getsockopt (2),[/b] [b]sendfile (2),[/b] [b]socket (2),[/b] [b]write (2),[/b] [b]socket (7),[/b] [b]ip (7),[/b] [b]tcp (7),[/b] [b]udp (7)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier