##纯手打
Man——send(2)
-->NAME:
send, sendto, sendmsg - 在socket上发送一条消息
-->总览:
#include <sys/types.h>
#include <sys/socket.h>
ssize_t send(int sockfd, const void *buf, size_t len, int flags);
ssize_t sendto(int sockfd, const void *buf, size_t len, int flags,
const struct sockaddr *dest_addr, socklen_t addrlen);
ssize_t sendmsg(int sockfd, const struct msghdr *msg, int flags);
-->描述：
系统调用send(), sendto(), and sendmsg()用于传输一条消息到另一个socket。
Send()只可能在socket处于连通状态时使用（只有这样接收者才能收到消息）。
Send()和write(2)唯一的不同在于send()的flags参数。当flags值为0时，send()相当于 write(2)。同样，send(sockfd, buf, len, flags)等效于sendto(sockfd, buf, len, flags, NULL, 0)。
参数sockfd 是发送端socket的文件描述符。
如果sendto()用于SOCK_STREAM, SOCK_SEQPACKET连接模式的socket之上，参数dest_addr 和 addrlen 会被无视（当这两个参数非NULL或非0，调用可能会返回error EISCONN）。
如果socket没有连通则会返回error ENOTCONN。有连通，则对端地址会以addrlen的大小赋值到dest_addr。
对于sendmsg()，则由msg.msg_name给出大小为msg.msg_namelen。
对于send()和 sendto()，要发送的消息存于buf，且长为len。
对于sendmsg()，消息参数msg.msg_iov数组指定。
Sendmsg()也可以用来发送辅助性的数据（即控制信息）。
如果消息太长以至于不能原子性地通过底层的协议，会返回error EMSGSIZE，并且消息不会被传输。
No indication of failure to deliver is implicit in a send().（??）。返回-1表明本地调用的错误。
当消息的大小与发送缓冲不匹配时，send()一般会阻塞，除非socket的创建为nonblocking I/O模式。对于非阻塞模式，这种情况则会失败并返回 error EAGAIN or EWOULDBLOCK。
Select(2)调用可以决定什么是否发送更多数据。
参数flags是0或以下更多标记的按位或运算结果：
·MSG_CONFIRM (since Linux 2.3.15)
告诉连接层:你成功收到对端的响应。如果连接层没有收到这个标记，它会不断地再次探测neighbor（??）(譬如通过ARP单播。
只在SOCK_DGRAM 和SOCK_RAW sockets可用，而且当且只在IPv4 和IPv6上实现了。详见 arp(7) f。
· MSG_DONTROUTE
不使用网关发送包，直接通过直连的网络发送到主机。这一般只用于诊断网络或路由的程序。这个只为需要路由的协议族定义了。This is defined only for protocol families that route; packet sockets don't.（??）
·MSG_DONTWAIT (since Linux 2.2)
允许非阻塞操作，如果操作是阻塞的，会返回 EAGAIN或 EWOULDBLOCK (这也可以通过F_SETFL fcntl(2)设置O_NONBLOCK实现。）
·MSG_EOR (since Linux 2.2)
Terminates a record（??） (如果支持这个标记,对SOCK_SEQPACKET类型的sockets 有效)。
·MSG_MORE (Since Linux 2.4.4)
调用者需要发送更多数据。这个标记配合TCP sockets使用，取得同TCP_CORK socket 选项的效果，不同的是这个标记是单次调用生效的。
自Linux 2.6后, 这个标记也支持UDP sockets，而且会通知内核，将带有这个标记的send调用打包到一个数据报里，这些数据只有在不带这标记的send调用中才会被发送。(See also the UDP_CORK socket option described in udp(7).)
·MSG_NOSIGNAL (since Linux 2.2)
请求在流sockets的使用中，当对端断开连接引起错误时不发送SIGPIPE。而仍然返回可能会EPIPE error。
·MSG_OOB
在支持这个标记的sockets上发送带外数据。(如SOCK_STREAM); 底层的协议也必须支持带外数据。
Msghdr结构如下。关于结构属性的更多描述参见recv(2) 和下述。
struct msghdr {
void *msg_name; /* optional address */
socklen_t msg_namelen; /* size of address */
struct iovec *msg_iov; /* scatter/gather array */
size_t msg_iovlen; /* # elements in msg_iov */
void *msg_control; /* ancillary data, see below */
size_t msg_controllen; /* ancillary data buffer len */
int msg_flags; /* flags on received message */
};
你可以用 msg_control 和msg_controllen的成员发送控制信息。对每个socket，内核可处理的最大的控制缓冲长度由socket by the value in /proc/sys/net/core/optmem_max限制。见socket(7)。
-->返回值
成功返回成功发送的字符数。错误则返回-1，且设置适当的errno。
-->ERRORS
一下这些是sockets层生成的标准错误。其他错误可能会由底层 的协议模块生成和返回。参见各自的man手册页。
·EACCES (对unix域sockets有效，由路径名区分）
对目的socket 文件没有写权限，或者对某些目录路径的前缀没有搜索权限。 (参见path_resolution(7).)
(对UDP sockets)在单播地址上作出 网络/广播地址的操作。
·EAGAIN or EWOULDBLOCK
Socket被标记为nonblocking（非阻塞），而请求的操作会导致阻塞。此时，POSIX.1-2001规定允许返回这个两个错误标记，并且并不要求两个常量有相同的值，所以可移植应用应同时检查两个可能的值。
·EBADF 声明了一个无效的文件描述符
·ECONNRESET 对端重置了连接
·EDESTADDRREQ socket不是连接模式，且没有设置对端地址
·EFAULT 设置了无效客户端地址
·EINTR 在传输数据前收到信号，见signal(7).
·EINVAL 无效参数
·EISCONN 连接模式的socket 已连接，但收件人已指定。（这种情况下，要不返回这个错误，要不忽略接收者的指定）
·EMSGSIZE socke的类型要求消息原子性地发送，但要发送的消息的大小使这次调用无效
·ENOBUFS 网络接口的输出队列已满。这一般说明了接口已停止已停止发送，但也可能是瞬间的阻塞造成（一般不会发生在Linux上，当设备队列溢出时Linux的行为一般是静默地弃包）。
·ENOMEM 没有可用内存
·ENOTCONN socket没有连接，且没有给定目标
·ENOTSOCK 参数sockfd 不是socket文件
·EOPNOTSUPP flags参数设置与socket类型冲突
·EPIPE 本地关闭了面向连接的socket。此时，程序会收到SIGPIPE 除非设置MSG_NOSIGNAL
-->符合4.4BSD, SVr4, POSIX.1-2001. 这些函数出现在4.2BSD.
POSIX.1-2001 只描述了MSG_OOB 和MSG_EOR标记。 POSIX.1-2008 添加了MSG_NOSIGNAL的声明。MSG_CONFIRM 标记是 Linux 的扩展。
-->BUGS
Linux可能返回 EPIPE而不是 ENOTCONN.
posted on
