.\" 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.
.\"
.\" 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
.\" 中文版 Copyright (c) 2002 byeyear 和 www.linuxforum.net
.\"
.TH SEND 2 "July 1999" "Linux Man Page" "Linux Programmer's Manual"
.SH NAME
send, sendto, sendmsg \- 從套接字發送消息
.SH 概述
.B #include <sys/types.h>
.br
.B #include <sys/socket.h>
.sp
.BI "int send(int " s ", const void *" msg ", size_t " len ","
.BI "int " flags );
.br
.BI "int sendto(int " s ", const void *" msg ", size_t " len ","
.BI "int " flags ", const struct sockaddr *" to ", socklen_t " tolen );
.br
.BI "int sendmsg(int " s ", const struct msghdr *" msg ","
.BI "int " flags );
.SH 描述
.BR Send ,
.BR sendto ,
和
.B sendmsg
用於向另一個套接字傳遞消息.
.B Send
僅僅用於連接套接字,而 
.B sendto
和
.B sendmsg
可用於任何情況下.
.PP
目標地址用
.I to
指定,
.I tolen
定義其長度.消息的長度用
.IR len
指定.
如果消息太長不能通過下層協議,函數將返回
.B EMSGSIZE
錯誤,消息也不會被送出.
.PP
在數據傳送過程中所產生的錯誤不會返回給
.BR send.
如果發生本地錯誤,則返回\-1.
.PP
當要發送的消息長度大於套接字當前可用緩衝區時,
.B send
將阻塞,除非在套接字上設置了非阻塞式輸入輸出模式.
對於非阻塞模式,這種情況下將返回
.B EAGAIN
錯誤.
The
系統調用
.BR select (2)
可以用來檢測何時可以發送更多的數據.
.PP
參數
.I flags
是一個標誌字,可以包含下列標誌:
.\" XXX document MSG_PROXY
.TP
對於支持帶外數據的套接字,
.B MSG_OOB
將送出
.I out-of-band
(帶外)數據(比如,
.BR SOCK_STREAM
類型的套接字);
下層協議也必須支持.
.I 帶外
數據.
.TP
.B MSG_DONTROUTE
在送出分組時不使用網關.只有直接連接在網絡上的主機
才能接收到數據.這個標誌通常僅用於診斷和路由程序.
可路由的協議族才能使用這個標誌;包套接字不可以.
.TP
.B MSG_DONTWAIT
使用非阻塞式操作;如果操作需要阻塞,將返回
.B EAGAIN 
錯誤(也可以用
.B F_SETFL
.BR fcntl(2)
設置
.B O_NONBLOCK
實現這個功能.)
.TP
.B MSG_NOSIGNAL
當流式套接字的另一端中斷連接時不發送 
.B SIGPIPE 
信號,但仍然返回 
.B EPIPE
錯誤.
.TP
.BR MSG_CONFIRM " (僅用於Linux 2.3以上版本)"
通知鏈路層發生了轉發過程:得到了另一端的成功應答.
如果鏈路層沒有收到通知,它將按照常規探測網絡上的相鄰
主機(比如通過免費arp). 
只能用於 
.B SOCK_DGRAM
和
.B SOCK_RAW
類型的套接字,且僅對IPv4和IPv6有效.詳情參見
.BR arp (7)
.PP
結構體
.I msghdr
的定義如下.詳情參見 
.BR recv (2)
和下文.
.IP
.RS
.nf
.ta 4n 17n 33n
struct msghdr {
	void	* msg_name;	/*地址選項*/
	socklen_t	msg_namelen;	/*地址長度*/
	struct iovec	* msg_iov;	/*消息數組*/
	size_t	msg_iovlen;	/*msg_iov中的元素個數*/
	void	* msg_control;	/*輔助信息,見下文*/
	socklen_t	msg_controllen;	/*輔助數據緩衝區長度*/
	int	msg_flags;	/*接收消息標誌*/
};
.ta
.fi
.RE
.PP
可以使用 
.I msg_control 
和
.I msg_controllen 
成員發送任何控制信息.內核所能處理的最大控制消息緩衝區長度由
.B net.core.optmem_max 
sysctl對每個套接字進行限定;參見
.BR socket (7).
.SH 返回值
成功時返回發送的字符個數,否則返回-1.
.SH 錯誤代碼
其中一些是套接字層產生的標準錯誤.其他的是下層協議模塊產生的;參見
各自的man手冊.
.TP
.B EBADF
指定了非法描述符.
.TP
.B ENOTSOCK
參數
.I s
不是一個套接字.
.TP
.B EFAULT
參數指定的用戶地址空間非法.
.TP
.B EMSGSIZE
消息長度越界.
.TP
.BR EAGAIN "或者" EWOULDBLOCK
套接字設置爲非阻塞式,但所請求的操作需要阻塞.
.TP
.B ENOBUFS
網絡接口輸出隊列已滿.這通常表明接口已停止發送,也有可能是
暫時性的擁擠(這不會發生在linux下,當設備隊列溢出時數據報
只是被簡單丟棄.
.TP
.B EINTR
接收到信號.
.TP
.B ENOMEM
沒有可用內存.
.TP
.B EINVAL
傳遞的參數非法. 
.TP
.B EPIPE
連接套接字的本地端已關閉.這種情況下進程還會接收到
.B SIGPIPE
信號,除非設置了
.B MSG_NOSIGNAL 
.SH 兼容於
4.4BSD,SVr4,POSIX1003.1g草案(這些系統調用首次出現於4.2BSD).
.B MSG_CONFIRM 
是Linux所做的擴展.
.SH 注意
上面給出的函數原型遵循Single Unix Specification,
glibc2也是這麼做的;
.I flags
參數在BSD4.*中是`int',但在libc4和libc5中是`unsigned int';
參數
.I len
在BSD4.*和libc4中是`int',但在libc5中是'size_t';
參數
.I tolen
在BSD4.*,libc4和libc5中都是`int'.
參見
.BR accept (2).
.SH "SEE ALSO"
.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)

.SH "[中文版維護人]"
.B byeyear <love_my_love@263.net >
.SH "[中文版最新更新]"
.B 2002.02.27
.SH "《中國linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR