setsockopt

待我称王封你为后i 2023-06-05 05:55 1阅读 0赞

#### 概要 ####

`setsockopt（int s，int level，int optname，const void * optval，socklen_t optlen）;`

int s， 				//套接字描述符
    int level，				//选项所在协议层；支持SOL_SOCKET(套接字本身)、IPPROTO_TCP、IPPROTO_IP和IPPROTO_IPV6。
    int optname，			//指定请求适用的单个选项。
    const void * optval，	//指定选项的值。
    socklen_t optlen		//指定选项值的长度。
    ）;

#### 参数 ####

`s`指定应为其设置选项的套接字。  
`level` 标识该操作是适用于套接字本身还是适用于所使用的基础协议。套接字本身由符号常量SOL\_SOCKET标识。其他协议级别需要用于控制选项的适当协议的协议编号。  
`optname`指定请求适用的单个选项。  
`optval`指定选项的值。  
`optlen`指定选项值的长度。

#### 返回值 ####

如果成功，setsockopt（） 将返回0。如果失败将返回值-1并将errno设置为以下值之一：  
`EBADF`s不是有效的描述符  
`EFAULT`optval是无效的指针  
`ENOTSOCK`s不是套接字描述符  
`EINVAL`在调用setsockopt()时，optlen无效  
`ENOPROTOOPT`optname在指示的级别未知

#### 描述 ####

`optname`

<table> 
 <thead> 
  <tr> 
   <th align="left">选项名</th> 
   <th align="left">说明</th> 
   <th align="left">数据类型</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">SO_BROADCAST</td> 
   <td align="left">允许发送广播数据</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_DEBUG</td> 
   <td align="left">允许调试</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_DONTROUTE</td> 
   <td align="left">不查找路由</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_ERROR</td> 
   <td align="left">获得套接字错误</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_KEEPALIVE</td> 
   <td align="left">保持连接</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_LINGER</td> 
   <td align="left">延迟关闭连接</td> 
   <td align="left">struct linger</td> 
  </tr> 
  <tr> 
   <td align="left">SO_OOBINLINE</td> 
   <td align="left">带外数据放入正常数据流</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_RCVBUF</td> 
   <td align="left">接收缓冲区大小</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_SNDBUF</td> 
   <td align="left">发送缓冲区大小</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_RCVLOWAT</td> 
   <td align="left">接收缓冲区下限</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_SNDLOWAT</td> 
   <td align="left">发送缓冲区下限</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_RCVTIMEO</td> 
   <td align="left">接收超时</td> 
   <td align="left">struct timeval</td> 
  </tr> 
  <tr> 
   <td align="left">SO_SNDTIMEO</td> 
   <td align="left">发送超时</td> 
   <td align="left">struct timeval</td> 
  </tr> 
  <tr> 
   <td align="left">SO_REUSERADDR</td> 
   <td align="left">允许重用本地地址和端口</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_TYPE</td> 
   <td align="left">获得套接字类型</td> 
   <td align="left">int</td> 
  </tr> 
  <tr> 
   <td align="left">SO_BSDCOMPAT</td> 
   <td align="left">与BSD系统兼容</td> 
   <td align="left">int</td> 
  </tr> 
 </tbody> 
</table>

*  `SO_DEBUG`  
    提供打开调试信息记录的功能。此选项在optval 参数中采用int值。这是BOOL选项。
 *  `SO_BROADCAST`  
    如果协议支持，则允许发送广播消息。此选项在optval 参数中采用int值。这是BOOL选项。
 *  `SO_REUSEADDR`  
    指定在协议支持的情况下，用于验证提供给bind（）的地址的规则 应允许重用本地地址。此选项在optval参数中采用int值。这是BOOL选项。
 *  `SO_KEEPALIVE`  
    如果协议支持，则通过启用消息的定期传输来使连接保持活动状态。  
    如果连接的套接字无法响应这些消息，则连接断开，并使用ENETRESET errno通知写入该套接字的 进程。此选项 在optval参数中采用int值。这是BOOL选项。
 *  `SO_LINGER`  
    指定如果存在数据，套接字是否在close（）上停留。如果设置了SO\_LINGER，则系统在close（）期间阻止该过程，直到可以传输数据或直到l\_linger成员指示的间隔结束为止（以先到者为准）。如果未指定SO\_LINGER并 发出close（），则系统将以允许进程尽快继续进行的方式处理调用。这个选项需要一个萦绕在结构optval的参数。
 *  `SO_OOBINLINE`  
    指定套接字是否使接收到的带外数据（标记为紧急数据）保持排队。此选项在optval参数中采用int值。这是BOOL选项。
 *  `SO_SNDBUF`  
    设置发送缓冲区大小信息。此选项 在optval参数中采用int值。
 *  `SO_RCVBUF`  
    设置接收缓冲区大小信息。此选项 在optval参数中采用int值。  
    SO\_RCVBUF和SO\_SNDBUF每个套接口都有一个发送缓冲区和一个接收缓冲区，使用这两个套接口选项可以改变缺省缓冲区大小。
 *  `SO_DONTROUTE`  
    指定传出消息是否绕过标准路由工具。目标必须在直接连接的网络上，并且根据目标地址将消息定向到适当的网络接口。此选项的效果（如果有）取决于所使用的协议。此选项在optval参数中采用int值 。这是BOOL选项。
 *  `TCP_NODELAY`  
    指定是否禁用TCP用于发送合并的Nagle算法。此选项在optval参数中采用int值 。这是BOOL选项。对于布尔选项，零值表示禁用该选项，非零值表示启用该选项。

### **注意：** ###

当设置TCP套接口接收缓冲区的大小时，函数调用顺序是很重要的，因为TCP的窗口规模选项是在建立连接时用SYN与对方互换

得到的。对于客户，O\_RCVBUF选项必须在connect之前设置；对于服务器，SO\_RCVBUF选项必须在listen前设置。

结合原理说明：  
**1**.每个套接口都有一个发送缓冲区和一个接收缓冲区。 接收缓冲区被TCP和UDP用来将接收到的数据一直保存到由应用进程来读。

TCP：TCP通告另一端的窗口大小。 TCP套接口接收缓冲区不可能溢出，因为对方不允许发出超过所通告窗口大小的数据。 这就是TCP的

流量控制，如果对方无视窗口大小而发出了超过窗口大小的数据，则接 收方TCP将丢弃它。 UDP：当接收到的数据报装不进套接口接收缓

冲区时，此数据报就被丢弃。UDP是没有流量控制的；快的发送者可以很容易地就淹没慢的接收者，导致接收方的UDP丢弃数据报。  
**2**.我们经常听说tcp协议的三次握手,但三次握手到底是什么，其细节是什么，为什么要这么做呢?  
第一次:客户端发送连接请求给服务器，服务器接收;  
第二次:服务器返回给客户端一个确认码,附带一个从服务器到客户端的连接请求,客户机接收,确认客户端到服务器的连接.  
第三次:客户机返回服务器上次发送请求的确认码,服务器接收,确认服务器到客户端的连接.  
我们可以看到:  
1. tcp的每个连接都需要确认.  
2. 客户端到服务器和服务器到客户端的连接是独立的.  
我们再想想tcp协议的特点:连接的,可靠的,全双工的,实际上tcp的三次握手正是为了保证这些特性的实现.

**3**.setsockopt的用法举例  
1、 closesocket（一般不会立即关闭而经历TIME\_WAIT的过程）后想继续重用该socket：  
`BOOL bReuseaddr=TRUE;`  
`setsockopt(s,SOL_SOCKET ,SO_REUSEADDR,(const char*)&bReuseaddr,sizeof(BOOL));`  
2、 如果要已经处于连接状态的soket在调用closesocket后强制关闭，不经历TIME\_WAIT的过程：  
`BOOL bDontLinger = FALSE;`  
`setsockopt(s,SOL_SOCKET,SO_DONTLINGER,(const char*)&bDontLinger,sizeof(BOOL));`  
3.在send(),recv()过程中有时由于网络状况等原因，发收不能预期进行,而设置收发时限：  
`int nNetTimeout=1000;//1秒`  
//发送时限  
`setsockopt(socket，SOL_S0CKET,SO_SNDTIMEO，(char *)&nNetTimeout,sizeof(int));`  
//接收时限  
`setsockopt(socket，SOL_S0CKET,SO_RCVTIMEO，(char *)&nNetTimeout,sizeof(int));`

4.在send()的时候，返回的是实际发送出去的字节(同步)或发送到socket缓冲区的字节  
(异步);系统默认的状态发送和接收一次为8688字节(约为8.5K)；在实际的过程中发送数据  
和接收数据量比较大，可以设置socket缓冲区，而避免了send(),recv()不断的循环收发：  
// 接收缓冲区  
`int nRecvBuf=32*1024;//设置为32K`  
`setsockopt(s,SOL_SOCKET,SO_RCVBUF,(const char*)&nRecvBuf,sizeof(int));`  
//发送缓冲区  
`int nSendBuf=32*1024;//设置为32K`  
`setsockopt(s,SOL_SOCKET,SO_SNDBUF,(const char*)&nSendBuf,sizeof(int));`  
5. 如果在发送数据的时，希望不经历由系统缓冲区到socket缓冲区的拷贝而影响  
程序的性能：  
`int nZero=0;`  
`setsockopt(socket，SOL_S0CKET,SO_SNDBUF，(char *)&nZero,sizeof(nZero));`

6.同上在recv()完成上述功能(默认情况是将socket缓冲区的内容拷贝到系统缓冲区)：  
`int nZero=0;`  
`setsockopt(socket，SOL_S0CKET,SO_RCVBUF，(char *)&nZero,sizeof(int));`

7.一般在发送UDP数据报的时候，希望该socket发送的数据具有广播特性：  
`BOOL bBroadcast=TRUE;`  
`setsockopt(s,SOL_SOCKET,SO_BROADCAST,(const char*)&bBroadcast,sizeof(BOOL));`

8.在client连接服务器过程中，如果处于非阻塞模式下的socket在connect()的过程中可以设置connect()延时,直到accpet()被呼叫(本函数设置只有在非阻塞的过程中有显著的作用，在阻塞的函数调用中作用不大)  
`BOOL bConditionalAccept=TRUE;`  
`setsockopt(s,SOL_SOCKET,SO_CONDITIONAL_ACCEPT,(const char*)&bConditionalAccept,sizeof(BOOL));`  
9.如果在发送数据的过程中(send()没有完成，还有数据没发送)而调用了closesocket(),以前我们一般采取的措施是"从容关闭"  
shutdown(s,SD\_BOTH),但是数据是肯定丢失了，如何设置让程序满足具体应用的要求(即让没发完的数据发送出去后在关闭socket)？

struct linger {
    u_short l_onoff;
    u_short l_linger;
    };
    linger m_sLinger;
    m_sLinger.l_onoff=1;//(在closesocket()调用,但是还有数据没发送完毕的时候容许逗留)
    // 如果m_sLinger.l_onoff=0;则功能和2.)作用相同;
    m_sLinger.l_linger=5;//(容许逗留的时间为5秒)
    setsockopt(s,SOL_SOCKET,SO_LINGER,(const char*)&m_sLinger,sizeof(linger));