setsockopt（）用法详解

#include

#include

int setsockopt(int sockfd, int level, int optname,const void *optval, socklen_t optlen);

    sockfd:标识一个套接口的描述字。

    level:选项定义的层次;支持SOL_SOCKET、IPPROTO_TCP、IPPROTO_IP和IPPROTO_IPV6。

    optname:需设置的选项。

    optval:指针，指向存放选项待设置的新值的缓冲区。

    optlen:optval缓冲区长度

应用程序通过创建一个linger结构来设置相应的操作特性:

struct linger {

int l_onoff;

int l_linger;

};

    为了允许SO_LINGER，应用程序应将l_onoff设为非零，将l_linger设为零或需要的超时值(以秒为单位)，然后调用setsockopt()。为了允许SO_DONTLINGER(亦即禁止SO_LINGER)，l_onoff应设为零，然后调用setsockopt()。

    缺省条件下，一个套接口不能与一个已在使用中的本地地址捆绑(参见bind())。但有时会需要"重用"地址。因为每一个连接都由本地地址和远端地址的组合唯一确定，所以只要远端地址不同，两个套接口与一个地址捆绑并无大碍。为了通知套接口实现不要因为一个地址已被一个套接口使用就不让它与另一个套接口捆绑，应用程序可在bind()调用前先设置SO_REUSEADDR选项。请注意仅在bind()调用时该选项才被解释;故此无需(但也无害)将一个不会共用地址的套接口设置该选项，或者在bind()对这个或其他套接口无影响情况下设置或清除这一选项。

    一个应用程序可以通过打开SO_KEEPALIVE选项，使得套接口实现在TCP连接情况下允许使用"保持活动"包。一个套接口实现并不是必需支持"保持活动"，但是如果支持的话，具体的语义将与实现有关，应遵守RFC1122"Internet主机要求-通讯层"中第4.2.3.6节的规范。如果有关连接由于"保持活动"而失效，则进行中的任何对该套接口的调用都将以WSAENETRESET错误返回，后续的任何调用将以WSAENOTCONN错误返回。

    TCP_NODELAY选项禁止Nagle算法。Nagle算法通过将未确认的数据存入缓冲区直到蓄足一个包一起发送的方法，来减少主机发送的零碎小数据包的数目。但对于某些应用来说，这种算法将降低系统性能。所以TCP_NODELAY可用来将此算法关闭。应用程序编写者只有在确切了解它的效果并确实需要的情况下，才设置TCP_NODELAY选项，因为设置后对网络性能有明显的负面影响。TCP_NODELAY是唯一使用IPPROTO_TCP层的选项，其他所有选项都使用SOL_SOCKET层。

    如果设置了SO_DEBUG选项，套接口供应商被鼓励(但不是必需)提供输出相应的调试信息。但产生调试信息的机制以及调试信息的形式已超出本规范的讨论范围。

setsockopt()支持下列选项。其中"类型"表明optval所指数据的类型。

选项                      类型       意义

SO_BROADCAST BOOL     允许套接口传送广播信息。

SO_DEBUG         BOOL     记录调试信息。

SO_DONTLINER BOOL     不要因为数据未发送就阻塞关闭操作。设置本选项相当于将SO_LINGER的l_onoff元素置为零。

SO_DONTROUTE BOOL     禁止选径;直接传送。

SO_KEEPALIVE BOOL         发送"保持活动"包。

SO_LINGER struct linger FAR* 如关闭时有未发送数据，则逗留。

SO_OOBINLINE BOOL         在常规数据流中接收带外数据。

SO_RCVBUF         int             为接收确定缓冲区大小。

SO_REUSEADDR BOOL         允许套接口和一个已在使用中的地址捆绑(参见bind())。

SO_SNDBUF         int         指定发送缓冲区大小。

TCP_NODELAY     BOOL     禁止发送合并的Nagle算法。

setsockopt()不支持的BSD选项有:

选项名                     类型             意义

SO_ACCEPTCONN BOOL 套接口在监听。

SO_ERROR              int        获取错误状态并清除。

SO_RCVLOWAT     int     接收低级水印。

SO_RCVTIMEO         int     接收超时。

SO_SNDLOWAT     int 发送低级水印。

SO_SNDTIMEO     int 发送超时。

SO_TYPE                 int 套接口类型。

IP_OPTIONS 在IP头中设置选项。

返回值

    若无错误发生，setsockopt()返回0。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。

错误代码:

    WSANOTINITIALISED:在使用此API之前应首先成功地调用WSAStartup()。

    WSAENETDOWN:套接口实现检测到网络子系统失效。

    WSAEFAULT:optval不是进程地址空间中的一个有效部分。

    WSAEINPROGRESS:一个阻塞的套接口调用正在运行中。

    WSAEINVAL:level值非法，或optval中的信息非法。

    WSAENETRESET:当SO_KEEPALIVE设置后连接超时。

    WSAENOPROTOOPT:未知或不支持选项。其中，SOCK_STREAM类型的套接口不支持SO_BROADCAST选项，SOCK_DGRAM类型的套接口不支持SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE选项。

    WSAENOTCONN:当设置SO_KEEPALIVE后连接被复位。

    WSAENOTSOCK:描述字不是一个套接口。

应用举例

1.设置调用close(socket)后,仍可继续重用该socket。调用close(socket)一般不会立即关闭socket，而经历TIME_WAIT的过程。

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_SOCKET, SO_SNDTIMEO, ( char * )&nNetTimeout, sizeof( int ) );

//接收时限

setsockopt( socket, SOL_SOCKET, SO_RCVTIMEO, ( char * )&nNetTimeout, sizeof( int ) );

  

 4.在send()的时候，返回的是实际发送出去的字节(同步)或发送到socket缓冲区的字节(异步);系统默认的状态发送和接收一次为8688字节(约

为8.5K);在实际的过程中如果发送或是接收的数据量比较大，可以设置socket缓冲区，避免send(),recv()不断的循环收发:

// 接收缓冲区

int nRecvBufLen = 32 * 1024; //设置为32K

setsockopt( s, SOL_SOCKET, SO_RCVBUF, ( const char* )&nRecvBufLen, sizeof( int ) );

//发送缓冲区

int nSendBufLen = 32*1024; //设置为32K

setsockopt( s, SOL_SOCKET, SO_SNDBUF, ( const char* )&nSendBufLen, sizeof( int ) );

5.在发送数据的时，不执行由系统缓冲区到socket缓冲区的拷贝，以提高程序的性能:

int nZero = 0;

setsockopt( socket, SOL_SOCKET, SO_SNDBUF, ( char * )&nZero, sizeof( nZero ) );

6.在接收数据时，不执行将socket缓冲区的内容拷贝到系统缓冲区:

int nZero = 0;

setsockopt( s, SOL_SOCKET, 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()没有完成，还有数据没发送，而调用了close(socket),以前一般采取的措施是shutdown(s,SD_BOTH),但是数

据将会丢失。

某些具体程序要求待未发送完的数据发送出去后再关闭socket，可通过设置让程序满足要求:

struct linger {

u_short l_onoff;

u_short l_linger;

};

struct linger m_sLinger;

m_sLinger.l_onoff = 1; //在调用close(socket)时还有数据未发送完，允许等待

// 若m_sLinger.l_onoff=0;则调用closesocket()后强制关闭

m_sLinger.l_linger = 5; //设置等待时间为5秒

setsockopt( s, SOL_SOCKET, SO_LINGER, (const char*)&m_sLinger, sizeof(struct linger));