.\" 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.
.\"
.\"     $Id: send.2,v 1.4 2005/05/30 07:34:00 juan.piernas Exp $
.\"
.\" Modified Sat Jul 24 01:15:33 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Tue Oct 22 17:55:49 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Oct 1998 by Andi Kleen
.\" Translation revised Tue Apr 6 1999 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised Sun Jun 27 1999 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised Sat Jan 29 2000 by Juan Piernas <piernas@ditec.um.es>
.\" Revisado por Miguel Pérez Ibars <mpi79470@alu.um.es> el 29-septiembre-2004
.\"
.TH SEND 2 "31 diciembre 2002" "Página man de Linux" "Manual del Programador de Linux"
.SH NOMBRE
send, sendto, sendmsg \- envía un mensaje de un conector (socket)
.SH SINOPSIS
.B #include <sys/types.h>
.br
.B #include <sys/socket.h>
.sp
.BI "ssize_t send(int " s ", const void *" msg ", size_t " len ,
.BI "int " flags );
.br
.BI "ssize_t sendto(int " s ", const void *" msg ", size_t " len ,
.BI "int " flags ", const struct sockaddr *" to ", socklen_t " tolen );
.br
.BI "ssize_t sendmsg(int " s ", const struct msghdr *" msg ,
.BI "int " flags );
.SH DESCRIPCIÓN
.BR Send ,
.BR sendto
y
.B sendmsg
son utilizados para transmitir un mensaje a otro conector.
.B Send
solo puede ser usado cuando un conector está en un estado
.I connected
mientras
.B sendto
y
.B sendmsg
pueden ser utilizados en cualquier momento.
.PP
La dirección de destino viene dada por
.I to
con
.I tolen
especificando su tamaño. La longitud del mensaje viene dada por
.IR len .
Si el mensaje es demasiado largo para pasar automáticamente a través del
protocolo inferior, se devuelve el error
.B EMSGSIZE
y el mensaje no es transmitido.
.PP
La llamada
.B send
lleva implícita el que no se indiquen los posibles errores en la entrega.
Los errores detectados localmente se indican devolviendo un valor \-1.
.PP
Cuando el mensaje no cabe en el buffer de envío del conector,
.B send
se bloquea, a no ser que el conector se haya colocado en el modo de E/S no
bloqueante. En el modo no bloqueante devolvería
.B EAGAIN
en este caso. Se puede utilizar la llamada
.BR select (2)
para determinar cuando es posible enviar más información.
.PP
El parámetro
.I flags
es una palabra de opciones y puede contener las siguientes opciones:
.\" XXX document MSG_PROXY
.TP
.B MSG_OOB
Enviar datos
.IR "fuera de orden" (out-of-band)
en conectores que soportan esta noción (p.ej. 
.BR SOCK_STREAM );
el protocolo subyacente también debe soportar datos
.IR "fuera de orden" .
.TP
.B MSG_DONTROUTE
No usar un ``gateway'' para enviar el paquete, enviar sólo a los ordenadores
que se encuentren en redes conectadas directamente. Normalmente, esto sólo
lo utilizan los programas de diagnóstico y enrutamiento. Esta opción sólo
está definida para familias de protocolos que enrutan. Los conectores de
paquetes no enrutan.
.TP
.B MSG_DONTWAIT
Habilitar el funcionamiento no bloqueante. Si la operación se bloqueara, se
devolvería
.B EAGAIN
(esto también se puede habilitar usando la bandera
.B O_NONBLOCK
con la operación
.B F_SETFL
de
.BR fcntl(2)).
.TP
.B MSG_NOSIGNAL
Solicitar el no enviar
.B SIGPIPE
en caso de error en conectores orientados a conexión cuando el otro extremo
rompa la conexión. Todavía se devuelve el error
.BR EPIPE .
.TP
.BR MSG_CONFIRM " (Linux 2.3+ solamente)"
Le dice a la capa de enlace que se produjo el proceso de redirección: tienes
una confirmación positiva del otro lado. Si la capa de enlace no recibe esta respuesta
interrogará regularmente al vecino (p.e. a través de un mensaje ARP unicast).
Sólo válida para conectores 
.B SOCK_DGRAM
y
.B SOCK_RAW
y actualmente sólo está implementada en IPv4 e IPv6. Vea
.BR arp (7)
para más detalles.
.PP
La definición de la estructura
.I msghdr
se muestra a continuación. Vea 
.BR recv (2)
y más abajo para una descripción exacta de sus campos.
.IP
.RS
.nf
.ta 4n 17n 33n
struct msghdr {
	void	* msg_name;	/* dirección opcional */
	socklen_t	msg_namelen;	/* tamaño de la dirección */
	struct iovec	* msg_iov;	/* vector dispersión/reunión */
	size_t	msg_iovlen;	/* # elementos en msg_iov */
	void	* msg_control;	/* datos auxiliares, vea más abajo */
	socklen_t	msg_controllen;	/* longitud del buffer de datos auxiliares */
	int	msg_flags;	/* banderas en el mensaje recibido */
};
.ta
.fi
.RE
.PP
Puede enviar información de control usando los miembros
.I msg_control
y
.IR msg_controllen .
La longitud máxima del buffer de control que el núcleo puede procesar está
limitada por conector por la sysctl
.BR net.core.optmem_max .
Vea
.BR socket (7).
.SH "VALOR DEVUELTO"
Las llamadas devuelven el numero de caracteres enviados, o \-1
si ha ocurrido un error.
.SH ERRORES
Estos son algunos errores estándares generados por la capa de conectores.
Los módulos de los protocolos subyacentes pueden generar y devolver errores
adicionales. Vea sus páginas de manual respectivas.
.TP
.B EBADF
Se ha especificado un descriptor no válido.
.TP
.B ENOTSOCK
El argumento
.I s
no es un conector.
.TP
.B EFAULT
Se ha especificado como parámetro una dirección incorrecta del espacio de
usuario.
tro.
.TP
.B EMSGSIZE
El conector requiere que este mensaje sea enviado automáticamente, y el tamaño 
del mensaje a ser enviado lo hace imposible.
.TP
.BR EAGAIN " o " EWOULDBLOCK
El conector está marcado como no bloqueante y la operación solicitada
lo bloquearía.
.TP
.B ENOBUFS
La cola de salida del interfaz de red está llena.
Esto generalmente indica que el interfaz ha parado de enviar,
pero puede ser causado por una congestión temporal.
(Esto no puede ocurrir en Linux, los paquetes simplemente se suprimen
silenciosamente cuando la cola de un dispositivo se desborda.)
.TP
.B EINTR
Se ha producido una señal.
.TP
.B ENOMEM
No hay memoria disponible.
.TP
.B EINVAL
Se ha pasado un argumento inválido.
.TP
.B EPIPE
Se ha desconectado el extremo local en un conector orientado a conexión.
En este caso el proceso tambíen recibirá una señal
.B SIGPIPE
a menos que se active la opción
.BR MSG_NOSIGNAL .
.SH "CONFORME A"
4.4BSD, SVr4, borrador POSIX 1003.1g (estas llamadas a función aparecieron
en 4.2BSD).

.B MSG_CONFIRM 
es una extensión de Linux.
.SH NOTA
Los prototipos indicados más arriba siguen `the Single Unix Specification',
ya que glibc2 también lo hace; el argumento
.I flags
era `int' en BSD 4.* pero `unsigned int' en libc4 y libc5;
el argumento 
.I len
era `int' en BSD 4.* y libc4 pero `size_t' en libc5;
el argumento
.I tolen
era `int' en BSD 4.*, libc4 y libc5.
Vea también
.BR accept (2).
.SH "VÉASE TAMBIÉN"
.BR fcntl (2),
.BR recv (2),
.BR select (2),
.BR getsockopt (2),
.BR sendfile (2),
.BR socket (2),
.BR write (2),
.BR socket (7),
.BR ip (7),
.BR tcp (7),
.BR udp (7)