.\" Copyright (c) 1983, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)send.2	6.9 (Berkeley) 5/1/91
.\"
.\" Traduction 15/10/1996 par Christophe Blaess (ccb@club-internet.fr)
.\" Mise a Jour 8/04/97
.\" mj 18/05/1999 (LDP man-pages 1.23)
.TH SEND 2 "18 Mai 1999" Linux "Manuel du programmeur Linux"
.SH NOM
send, sendto, sendmsg \- Envoyer un message sur une socket.
.SH SYNOPSIS
.B #include <sys/types.h>
.br
.B #include <sys/socket.h>
.sp 2
.BI "int send(int " s ", const void *" msg ", size_t " len ","
.BI "int " flags );
.sp
.BI "int sendto(int " s ", const void *" msg ", size_t " len ","
.BI "int " flags ", const struct sockaddr *" to ", socklen_t " tolen );
.sp
.BI "int sendmsg(int " s ", const struct msghdr *" msg ","
.BI "int " flags );
.SH DESCRIPTION
.BR Send ,
.BR sendto ,
et
.B sendmsg
permettent de transmettre un message  destination d'une
autre socket.
.B Send
ne peut tre utilis qu'avec les sockets
.I connecte
alors que
.B sendto
et
.B sendmsg
peuvent tre utiliss tout le temps.

L'adresse de la cible est donne par
.I to
avec la longueur 
.I tolen.
la longueur du message est indique dans
.IR len .
Si le message est trop long pour tre transmis intgralement
au protocole sous\-jacent, l'erreur
.B EMSGSIZE
sera dclenche et rien ne sera mis.

Aucune indication d'chec de distribution n'est
fournie par
.BR send .
Seules les erreurs locales sont dtectes, et indiques
par une valeur de retour \-1.

Si la socket ne dispose pas de la place suffisante pour
le message, alors
.B send
va bloquer,  moins que la socket ait t configure en mode
d'entres/sorties non\-bloquantes.
On peut utiliser l'appel systme
.BR select (2)
pour vrifier s'il est possible d'mettre des donnes.

Le paramtre
.I flags
peut contenir une ou plusieurs des options suivantes

.nf
#define	MSG_OOB        0x1  /* Traiter les donnes hors\-bande */
#define	MSG_DONTROUTE  0x4  /* Contourner le routage           */
.fi

L'option
.B MSG_OOB
est utilise pour mettre des donnes 
.I hors\-bande
sur une socket qui l'autorise (par ex :
.BR SOCK_STREAM ).
Le protocole sous\-jacent doit galement autoriser l'mission
de donnes
.I hors\-bande.

.B MSG_DONTROUTE
est utilise par les programmes de diagnostique ou de routage.

Voir
.BR recv (2)
pour une description de la structure
.IR msghdr .
.SH "VALEUR RENVOYE"
Ces appels systmes renvoient le nombre de caractres
mis, ou \-1 s'ils chouent, auquel cas 
.I errno
contient le code d'erreur.
.SH ERREURS
.TP 0.8i
.B EBADF
Descripteur de socket invalide.
.TP
.B ENOTSOCK
L'argument
.I s
n'est pas une socket.
.TP
.B EFAULT
Un paramtre pointe en dehors de l'espace d'adresssage accessible.
.TP
.B EMSGSIZE
La socket ncessite une emission intgrale du message mais la taille
de celui\-ci ne le permet pas.
.TP
.B EWOULDBLOCK
La socket est non\-bloquante et l'opration demande bloquerait.
.TP
.B EPIPE
L'criture est impossible (correspondant absent), et le signal
SIGPIPE a t ignor par le processus.
.TP
.B ENOMEM
Pas assez de mmoire pour le noyau.
.TP
.B ENOBUFS
La file d'mission de l'interface rseau est pleine. Ceci
indique gnralement une panne de l'interface rseau, mais
peut galement tre d  un engorgement passager.
.SH CONFORMIT
BSD 4.4 (cet appel systme est apparu dans BSD 4.2), SVr4. La version
SVr4 fournit les conditions d'erreur supplmentaires EINVAL, EINTR, EMSGSIZE,
ENOSR, et ENOMEM.
L'appel
.B sendmsg
est apparu dans le noyau Linux 1.3.16.

.SH NOTE
Les prototypes founis plus haut suivent les Spcification Single Unix,
tout comme glibc2. L'argument
.I flags
tait un `int' dans BSD 4.*, mais `unsigned int' dans libc4 et libc5.
L'argument
.I len
tait un  `int' dans BSD 4.* et libc4, mais un `size_t' dans libc5;
L'argument
.I tolen
tait un `int' dans BSD 4.*, libc4 et libc5.
Voir aussi les notes accompagnant la page
.BR accept (2).
.SH "VOIR AUSSI"
.BR fcntl "(2), " recv "(2), " select "(2), " getsockopt "(2), "
.BR socket "(2), " write (2)

.SH TRADUCTION
Christophe Blaess, 1997.