SEND(2) | Manuel du programmeur Linux | SEND(2) |
send, sendto, sendmsg - Envoyer un message sur une socket
#include <sys/types.h> #include <sys/socket.h>
ssize_t send(int sockfd, const void *buf, size_t len, int flags);
ssize_t sendto(int sockfd, const void *buf, size_t len, int flags, const struct sockaddr *dest_addr, socklen_t addrlen);
ssize_t sendmsg(int sockfd, const struct msghdr *msg, int flags);
Les appels système send(), sendto() et sendmsg() permettent de transmettre un message à destination d'une autre socket.
L'appel send() ne peut être utilisé qu'avec les sockets connectées (ainsi, le destinataire visé est connu). La seule différence entre send() et write(2) est la présence de flags. Si flags est nul, send() est équivalent à write(2). De plus l'appel suivant :
send(sockfd, buf, len, flags);
est équivalent à :
sendto(sockfd, buf, len, flags, NULL, 0);
Le paramètre sockfd est le descripteur de fichier de la socket émettrice.
Si sendto() est utilisée sur une socket en mode connexion (SOCK_STREAM, SOCK_SEQPACKET), les paramètres dest_addr et addrlen sont ignorés (et l'erreur EISCONN peut être retournée s'il n'y pas NULL ou 0), et l'erreur ENOTCONN est retournée lorsque la socket n'est pas vraiment connectée. Autrement, l'adresse de la cible est fournie par dest_addr, addrlen spécifiant sa taille. Pour sendmsg(), l'adresse de la cible est fournie par msg.msg_name, msg.msg_namelen spécifiant sa taille.
Pour send() et sendto(), le message se trouve dans buf et a pour longueur len. Pour sendmsg(), le message est pointé par les éléments du tableau msg.msg_iov. L'appel sendmsg() permet également l'envoi de métadonnées (également appelées données de contrôle).
Si le message est trop long pour être transmis intégralement par le protocole sous‐jacent, l'erreur EMSGSIZE sera déclenchée et rien ne sera émis.
Aucune indication d'échec de distribution n'est fournie par send(). 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 send() va bloquer, à moins que la socket ait été configurée en mode d'entrées-sorties non bloquantes auquel cas elle échouera avec l'erreur EAGAIN ou EWOULDBLOCK. On peut utiliser l'appel système select(2) pour vérifier s'il est possible d'émettre des données.
Le paramètre flags est un OU bit à bit de zéro ou plusieurs des options suivantes :
La définition de la structure msghdr employée par sendmsg() est la suivante :
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 */
size_t msg_controllen; /* Ancillary data buffer len */
int msg_flags; /* Flags (unused) */ };
Le champ msg_name est utilisé pour préciser à une socket non connectée l'adresse cible pour un datagramme. Il pointe vers un tampon contenant cette adresse ; le champ msg_namelen doit contenir la taille de cette adresse. Dans le cas d'une socket connectée, ces champs doivent respectivement valoir NULL et 0.
Les champs msg_iov et msg_iovlen précisent les emplacements de dispersion-regroupement (scatter-gather), de la même façon que pour writev(2).
You may send control information (ancillary data) using the msg_control and msg_controllen members. The maximum control buffer length the kernel can process is limited per socket by the value in /proc/sys/net/core/optmem_max; see socket(7). For further information on the use of ancillary data in various socket domains, see unix(7) and ip(7).
Le champ msg_flags est ignoré.
En cas d'envoi réussi, ces fonctions renvoient le nombre d'octets envoyés. En cas d'erreur, -1 est renvoyé, et errno contient le code d'erreur.
Voici les erreurs standards engendrées par la couche socket. Des erreurs supplémentaires peuvent être déclenchées par les protocoles sous-jacents. Consultez leurs pages de manuel respectives.
4.4BSD, SVr4, POSIX.1-2001. These interfaces first appeared in 4.2BSD.
POSIX.1-2001 décrit seulement les drapeaux MSG_OOB et MSG_EOR. POSIX.1-2008 ajoute la spécification de MSG_NOSIGNAL. Le drapeau MSG_CONFIRM est une extension Linux.
According to POSIX.1-2001, the msg_controllen field of the msghdr structure should be typed as socklen_t, and the msg_iovlen field should be typed as int, but glibc currently types both as size_t.
Consultez sendmmsg(2) pour plus d'informations au sujet d'un appel système propre à Linux, utilisé pour transmettre des datagrammes multiples avec un unique appel.
Linux peut retourner EPIPE au lieu de ENOTCONN.
Un exemple d'utilisation de sendto() se trouve dans la page de manuel de getaddrinfo(3).
fcntl(2), getsockopt(2), recv(2), select(2), sendfile(2), sendmmsg(2), shutdown(2), socket(2), write(2), cmsg(3), ip(7), ipv6(7), socket(7), tcp(7), udp(7), unix(7)
Cette page fait partie de la publication 5.10 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page peuvent être trouvées à l'adresse https://www.kernel.org/doc/man-pages/.
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> et Frédéric Hantrais <fhantrais@gmail.com>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 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.
1 novembre 2020 | Linux |