linux手册翻译——send(2)

send, sendto, sendmsg - send a message on a socket

系统调用 send()、sendto() 和 sendmsg() 用于将消息传输到另一个套接字。

仅当套接字处于连接状态时才可以使用 send() 调用（以便知道预期的接收者， 也就是说send()仅仅用于数据流类型的数据发送 ，对于TCP，服务端和客户端都可以使用send/recv；但是对于UDP，只能是客户端使用send/recv，服务端只能使用sendto/recvfrom，因为客户端是进行了connect *** 作知道要发送和接受的地址）。send() 和 write(2) 之间的唯一区别是存在 flags 参数。此外，

send(sockfd, buf, len, flags)

等价于

sendto(sockfd, buf, len, flags, NULL, 0)

参数 sockfd 是发送者套接字的文件描述符。

如果在连接模式的套接字(即套接字类型为SOCK_STREAM、SOCK_SEQPACKET)上使用 sendto()，则参数 dest_addr 和 addrlen 将被忽略(当它们不是NULL和0时可能返回错误EISCONN)，若套接字没有实际连接(还没有三次握手建立连接)将返回错误ENOTCONN。 否则，目标地址由 dest_addr 给出， addrlen 指定其大小。 对于 sendmsg()，目标地址由 msg.msg_name 给出， msg.msg_namelen 指定其大小。

对于 send() 和 sendto()，消息位于 buf 中，长度为 len 。 对于sendmsg()，消息存放于 msg.msg_iov 元素指向 数组数据区 (见下)中。 sendmsg() 调用还允许发送辅助数据（也称为控制信息） 。

如果消息太长而无法通过底层协议原子传递( too long to pass atomically through the underlying protocol )，则返回错误 EMSGSIZE，并且不会传输消息。

No indication of failure to deliver is implicit in a send(). Locally detected errors are indicated by a return value of -1.

当消息不适合套接字的发送缓冲区时，send() 通常会阻塞，除非套接字已置于非阻塞 I/O 模式。 在这种情况下，在非阻塞模式下它会失败并显示错误 EAGAIN 或 EWOULDBLOCK。 select(2) 调用可用于确定何时可以发送更多数据 。

上面的的描述还是很笼统的，以TCP为例，按我的理解，我认为只要发送缓冲区有空闲位置，且此时协议栈没有向网络发送数据，那么就可以写入，对于阻塞模式，直到所有数据写入到缓冲区，就会返回，否则一直阻塞，对于非阻塞模式，是有一个超时时间的，这个由 SO_SNDTIMEO 选项控制，详细见 socket(7) ，如果当前有空闲位置可以发即当前可写入，那么就写入到缓冲区，知道超时之前写入多少算多少，然后返回成功写入的字节数，如果超时时任何数据都没写出去，或者当前就是不可写入，那么返回-1 ，并设置errno为 EAGAIN 或 EWOULDBLOCK。

The flags argument is the bitwise OR of zero or more of the following flags.

sendmsg() 使用的 msghdr 结构的定义如下：

对于未连接的套接字 msg_name 指定数据报的目标地址，它指向一个包含地址的缓冲区； msg_namelen 字段应设置为地址的大小。 对于连接的套接字，这些字段应分别指定为 NULL 和 0。 这里的未连接指的是数据报协议，连接指的是数据流协议

The msg_iov and msg_iovlen fields specify scatter-gather locations, as for writev(2).

msg_iov是一个buffer数组:

使用 msg_control 和 msg_controllen 成员发送控制信息（辅助数据）。 内核可以处理的每个套接字最大控制缓冲区长度由 /proc/sys/net/core/optmem_max 中的值限制； 见 socket(7) 。 有关在各种套接字域中使用辅助数据的更多信息，请参阅 unix(7) 和 ip(7)。

msg_flags 字段被忽略。

成功时，返回成功发送的字节数，这个字节数并不一定和我们的缓冲区大小相同 。 出错时，返回 -1，并设置 errno 以指示错误。

这些是套接字层生成的一些标准错误。 底层协议模块可能会产生和返回额外的错误； 请参阅它们各自的手册页。

4.4BSD, SVr4, POSIX.1-2001. These interfaces first appeared in 4.2BSD.

POSIX.1-2001 describes only the MSG_OOB and MSG_EOR flags. POSIX.1-2008 adds a specification of MSG_NOSIGNAL. The MSG_CONFIRM flag is a Linux extension.

根据 POSIX.1-2001，msghdr 结构的 msg_controllen 字段应该是 socklen_t 类型，而 msg_iovlen 字段应该是 int 类型，但是 glibc 目前将两者都视为 size_t。

有关可用于在单个调用中传输多个数据报的 Linux 特定系统调用的信息，请参阅 sendmmsg(2)。

Linux may return EPIPE instead of ENOTCONN.

getaddrinfo(3) 中显示了使用 send() 的示例。

经套接字传送消息

相关函数

sendto,sendmsg,recv,recvfrom,recvmsg,socket

表头文件

#include <sys/socket.h >

定义函数

ssize_t send (int s,const void *msg,size_t len,int flags)

参数说明

第一个参数指定发送端套接字描述符；

第二个参数指明一个存放应用程式要发送数据的缓冲区；

第三个参数指明实际要发送的数据的字符数；

第四个参数一般置0。

函数说明

send() 用来将数据由指定的 socket 传给对方主机。使用 send 时套接字必须已经连接。send 不包含传送失败的提示信息，如果检测到本地错误将返回-1。因此，如果send 成功返回，并不必然表示连接另一端的进程接收数据。所保证的仅是当send 成功返回时，数据已经无错误地发送到网络上。

对于支持为报文设限的协议，如果单个报文超过协议所支持的最大尺寸，send 失败并将 errno 设为 EMSGSIZE ；对于字节流协议，send 会阻塞直到整个数据被传输。

flags 参数有如下的选择：

MSG_DONTROUTE 勿将数据路由出本地网络

MSG_DONTWAIT 允许非阻塞 *** 作（等价于使用O_NONBLOCK）

MSG_EOR 如果协议支持，此为记录结束

MSG_OOB 如果协议支持，发送带外数据

MSG_NOSIGNAL 禁止向系统发送异常信息

返回值

成功则返回实际传送出去的字符数，失败返回－1，错误原因存于errno 中。

错误代码

EBADF 参数 s 非法的 socket 处理代码。

EFAULT 参数中有一指针指向无法存取的内存空间。

WNOTSOCK 参数 s 为一文件描述词，非 socket。

EINTR 被信号所中断。

EAGAIN 此动作会令进程阻断，但参数 s 的 socket 为不可阻断的。

ENOBUFS 系统的缓冲内存不足。

EINVAL 传给系统调用的参数不正确。

在多线程编程中其中使用一个线程来accept要连接的客户端。同时在接受client的请求之后新建一个线程来进行具体的 *** 作。其 *** 作包括向client端发送一定字节的数据，使用send()函数来进行 *** 作。如果在发送过程中出现任何一个client端的断线，则整个程序都会退出。

ssize_t send(int sockfd, const void *buff, size_t nbytes, int flags)

关于Linux命令的介绍，看看《linux就该这么学》，具体关于这一章地址3w(dot)linuxprobe/chapter-02(dot)html

上面为send函数原型，在通常的使用中flags参数一般设置为0.此时如果客户端断开，继续往里边写数据的话，会引发一个信号SIGPIPE,此信号会引发线程的退出、

解决的方法：1）可以将flags参数设置为MSG_NOSIGNAL。2）设置SIG_IGN信号处理函数。

---