.\" 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