send
接口名称
send(int sockfd, const void *buf, size_t len, int flags)
接口描述
发送数据。
K-NET用户态TCP/IP协议栈数据发送端支持TCP协议优雅断链，当对端异常关闭时，发送端需要借用TCP重传超时机制/保活机制断链。
参数说明
| 参数 | 说明 | 备注 |
|---|---|---|
| sockfd | 通信节点描述符 | 传入socket描述符。 |
| *buf | 要发送的数据缓冲区 | 调用者保证内存的有效性。发送成功后，buf由调用者自行维护。 |
| len | 即将发送的数据长度 | 调用者保证长度的有效性，待发送数据总长度可设置范围为(0, SSIZE_MAX]。代表buf缓冲区中数据的长度。 |
| flags | 指定发送方式 | 支持MSG_DONTWAIT、MSG_NOSIGNAL（默认支持该flag，且不可修改）标志，其他类型不支持。如果携带有其他flags，直接返回失败。MSG_DONTWAIT：启用非阻塞操作。MSG_NOSIGNAL：防止在发送数据到已关闭连接的socket时触发SIGPIPE信号。 |
返回值
类型：ssize_t
- 非负数：实际发送的数据长度，表示成功
- -1：表示失败，并设置errno以指示错误类型
错误码
| 错误码 | 描述 |
|---|---|
| EAGAIN or EWOULDBLOCK | 套接字被标记为非阻塞，请求的操作将阻塞。 |
| ECONNRESET | 连接被对端终止。 |
| EDESTADDRREQ | 套接字不是连接模式，也没有设置对端地址。 |
| EFAULT | 参数在用户的地址空间之外。 |
| EINTR | 被信号中断。 |
| EMSGSIZE | 消息过大，无法一次发送，超过限制。 |
| ENOMEM | 内存申请失败。 |
| ENOTCONN | 套接字未连接。 |
| EPIPE | 套接字关闭写入，或者套接字为连接模式，不再连接。 |
| EOPNOTSUPP | flags参数中的某些位不适合套接字类型，当前只支持MSG_DONTWAIT。 |
| EINVAL | 套接字存在，但是套接字对应的数据结构存在异常。 |
| EINVAL | 入参len大于SSIZE_MAX。 |
| ENETDOWN | 用于到达目的地的本地网络接口已关闭。 |
| ELIBBAD | 系统符号加载失败。 |
| EINVAL | 共线程部署模式时，sockfd的worker id和当前线程的worker id不一致，即socket跨worker线程调用。 |