socket设置

主要介绍getsockopt(),setsockopt(),ioctlsockopt()，socket错误码。

getsockopt()

简述：
   获取一个套接口选项。
   #include <winsock.h>
   int PASCAL FAR getsockopt( SOCKET s, int level, int optname,
   char FAR* optval, int FAR* optlen);
   s：一个标识套接口的描述字。
   level：选项定义的层次。支持的层次仅有SOL_SOCKET和IPPROTO_TCP。
   optname：需获取的套接口选项。
   optval：指针，指向存放所获得选项值的缓冲区。
   optlen：指针，指向optval缓冲区的长度值。
注释：
   getsockopt()函数用于获取任意类型、任意状态套接口的选项当前值，并把结果存入optval。在不同协议层上存在选项，但往往是在最高的“套接口”层次上，设置选项影响套接口的操作，诸如操作的阻塞与否、包的选径方式、带外数据的传送等。
   被选中选项的值放在optval缓冲区中。optlen所指向的整形数在初始时包含缓冲区的长度，在调用返回时被置为实际值的长度。对SO_LINGER选项而言，相当于linger结构的大小，对其他选项来说，是一个整形数的大小。
   如果未进行setsockopt()调用，则getsockopt()返回系统缺省值。
   getsockopt()支持下列选项。其中“类型”栏指出了optval所指向的值。仅有TCP_NODELAY选项使用了IPPROTO_TCP层；其余选项均使用SOL_SOCKET层。
选项        类型        意义
SO_ACCEPTCONN BOOL        套接口正在用listen()监听。
SO_BROADCAST BOOL        套接口设置为传送广播信息。
SO_DEBUG BOOL        允许调试。
SO_DONTLINER BOOL        若为真，则SO_LINGER选项被禁止。
SO_DONTROUTE BOOL        禁止选径。
SO_ERROR int     获取错误状态并清除。
SO_KEEPALIVE BOOL        发送“保持活动”信息。
SO_LINGER struct linger FAR*   返回当前各linger选项。
SO_OOBINLINE BOOL        在普通数据流中接收带外数据。
SO_RCVBUF int     接收缓冲区大小。
SO_REUSEADDR BOOL        套接口能和一个已在使用中的地址捆绑。
SO_SNDBUF int     发送缓冲区大小。
SO_TYPE     int     套接口类型（如SOCK_STREAM）。
TCP_NODELAY BOOL        禁止发送合并的Nagle算法。
getsockopt()不支持的BSD选项有：
选项名    类型        意义
SO_RCVLOWAT int     接收低级水印。
SO_RCVTIMEO int     接收超时。
SO_SNDLOWAT int     发送低级水印。
SO_SNDTIMEO int     发送超时。
IP_OPTIONS       获取IP头中选项。
TCP_MAXSEG   int     获取TCP最大段的长度。
   用一个未被支持的选项去调用getsockopt()将会返回一个WSAENOPROTOOPT错误代码（可用WSAGetLastError()获取）。
返回值：
   若无错误发生，getsockopt()返回0。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。
错误代码：
   WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。
   WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。
   WSAEFAULT：optlen参数非法。
   WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。
   WSAENOPROTOOPT：未知或不支持选项。其中，SOCK_STREAM类型的套接口不支持SO_BROADCAST选项，SOCK_DGRAM类型的套接口不支持SO_ACCEPTCONN、SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE选项。
   WSAENOTSOCK：描述字不是一个套接口。
参见：
   setsockopt(), WSAAsyncSelect(), socket().

setsockopt()

简述：
   设置套接口的选项。
   #include <winsock.h>
   int PASCAL FAR setsockopt( SOCKET s, int level, int optname,
   const char FAR* optval, int optlen);
   s：标识一个套接口的描述字。
   level：选项定义的层次；目前仅支持SOL_SOCKET和IPPROTO_TCP层次。
   optname：需设置的选项。
   optval：指针，指向存放选项值的缓冲区。
   optlen：optval缓冲区的长度。
注释：
   setsockopt()函数用于任意类型、任意状态套接口的设置选项值。尽管在不同协议层上存在选项，但本函数仅定义了最高的“套接口”层次上的选项。选项影响套接口的操作，诸如加急数据是否在普通数据流中接收，广播数据是否可以从套接口发送等等。
   有两种套接口的选项：一种是布尔型选项，允许或禁止一种特性；另一种是整形或结构选项。允许一个布尔型选项，则将optval指向非零整形数；禁止一个选项optval指向一个等于零的整形数。对于布尔型选项，optlen应等于sizeof(int)；对其他选项，optval指向包含所需选项的整形数或结构，而optlen则为整形数或结构的长度。SO_LINGER选项用于控制下述情况的行动：套接口上有排队的待发送数据，且closesocket()调用已执行。参见closesocket()函数中关于SO_LINGER选项对closesocket()语义的影响。应用程序通过创建一个linger结构来设置相应的操作特性：
   struct linger {
int l_onoff;
int l_linger;
   };
   为了允许SO_LINGER，应用程序应将l_onoff设为非零，将l_linger设为零或需要的超时值（以秒为单位），然后调用setsockopt()。为了允许SO_DONTLINGER（亦即禁止SO_LINGER），l_onoff应设为零，然后调用setsockopt()。
   缺省条件下，一个套接口不能与一个已在使用中的本地地址捆绑（参见bind()）。但有时会需要“重用”地址。因为每一个连接都由本地地址和远端地址的组合唯一确定，所以只要远端地址不同，两个套接口与一个地址捆绑并无大碍。为了通知WINDOWS套接口实现不要因为一个地址已被一个套接口使用就不让它与另一个套接口捆绑，应用程序可在bind()调用前先设置SO_REUSEADDR选项。请注意仅在bind()调用时该选项才被解释；故此无需（但也无害）将一个不会共用地址的套接口设置该选项，或者在bind()对这个或其他套接口无影响情况下设置或清除这一选项。
   一个应用程序可以通过打开SO_KEEPALIVE选项，使得WINDOWS套接口实现在TCP连接情况下允许使用“保持活动”包。一个WINDOWS套接口实现并不是必需支持“保持活动”，但是如果支持的话，具体的语义将与实现有关，应遵守RFC1122“Internet主机要求－通讯层”中第4.2.3.6节的规范。如果有关连接由于“保持活动”而失效，则进行中的任何对该套接口的调用都将以WSAENETRESET错误返回，后续的任何调用将以WSAENOTCONN错误返回。
   TCP_NODELAY选项禁止Nagle算法。Nagle算法通过将未确认的数据存入缓冲区直到蓄足一个包一起发送的方法，来减少主机发送的零碎小数据包的数目。但对于某些应用来说，这种算法将降低系统性能。所以TCP_NODELAY可用来将此算法关闭。应用程序编写者只有在确切了解它的效果并确实需要的情况下，才设置TCP_NODELAY选项，因为设置后对网络性能有明显的负面影响。TCP_NODELAY是唯一使用IPPROTO_TCP层的选项，其他所有选项都使用SOL_SOCKET层。
   如果设置了SO_DEBUG选项，WINDOWS套接口供应商被鼓励（但不是必需）提供输出相应的调试信息。但产生调试信息的机制以及调试信息的形式已超出本规范的讨论范围。
   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：WINDOWS套接口实现检测到网络子系统失效。
   WSAEFAULT：optval不是进程地址空间中的一个有效部分。
   WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。
   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.设置调用closesocket()后,仍可继续重用该socket。调用closesocket()一般不会立即关闭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 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.在接收数据时，不执行将socket缓冲区的内容拷贝到系统缓冲区： 　　int nZero = 0; 　　setsockopt( s, 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;则调用closesocket()后强制关闭 　　m_sLinger.l_linger = 5; //设置等待时间为5秒 　　setsockopt( s, SOL_SOCKET, SO_LINGER, ( const char* )&m_sLinger, sizeof( linger ) );
参见：
   bind(), getsockopt(), ioctlsocket(), socket(), WSAAsyncSelect().

ioctlsocket()

简述:
   控制套接口的模式。
   #include <winsock.h>
   int PASCAL FAR ioctlsocket( SOCKET s, long cmd, u_long FAR* argp);
   s：一个标识套接口的描述字。
   cmd：对套接口s的操作命令。
   argp：指向cmd命令所带参数的指针。
注释：
   本函数可用于任一状态的任一套接口。它用于获取与套接口相关的操作参数，而与具体协议或通讯子系统无关。支持下列命令：
   FIONBIO：允许或禁止套接口s的非阻塞模式。argp指向一个无符号长整型。如允许非阻塞模式则非零，如禁止非阻塞模式则为零。当创建一个套接口时，它就处于阻塞模式（也就是说非阻塞模式被禁止）。这与BSD套接口是一致的。WSAAsynSelect()函数将套接口自动设置为非阻塞模式。如果已对一个套接口进行了WSAAsynSelect() 操作，则任何用ioctlsocket()来把套接口重新设置成阻塞模式的试图将以WSAEINVAL失败。为了把套接口重新设置成阻塞模式，应用程序必须首先用WSAAsynSelect()调用（IEvent参数置为0）来禁至WSAAsynSelect()。
   FIONREAD：确定套接口s自动读入的数据量。argp指向一个无符号长整型，其中存有ioctlsocket()的返回值。如果s是SOCKET_STREAM类型，则FIONREAD返回在一次recv()中所接收的所有数据量。这通常与套接口中排队的数据总量相同。如果S是SOCK_DGRAM 型，则FIONREAD返回套接口上排队的第一个数据报大小。
   SIOCATMARK：确实是否所有的带外数据都已被读入。这个命令仅适用于SOCK_STREAM类型的套接口，且该套接口已被设置为可以在线接收带外数据（SO_OOBINLINE）。如无带外数据等待读入，则该操作返回TRUE真。否则的话返回FALSE假，下一个recv()或recvfrom()操作将检索“标记”前一些或所有数据。应用程序可用SIOCATMARK操作来确定是否有数据剩下。如果在“紧急”（带外）数据前有常规数据，则按序接收这些数据（请注意，recv()和recvfrom()操作不会在一次调用中混淆常规数据与带外数据）。argp指向一个BOOL型数，ioctlsocket()在其中存入返回值。
兼容性：
   本函数为Berkeley套接口函数ioctl()的一个子集。其中没有与FIOASYNC等价的命令，SIOCATMARK是套接口层次支持的唯一命令。
返回值：
   成功后，ioctlsocket()返回0。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。
错误代码：
   WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。
   WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。
   WSAEINVAL：cmd为非法命令，或者argp所指参数不适用于该cmd命令，或者该命令
不适用于此种类型的套接口。
   WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。
   WSAENOTSOCK：描述字不是一个套接口。
参见：
   socket(), setsockopt(), getsockopt(), WSAAsyncSelect().
 

 错误码

Socket error 0 - Directly send error
Socket error 10004 - Interrupted function  //call 操作被终止
Socket error 10013 - Permission denied  //c访问被拒绝
Socket error 10014 - Bad address   //c地址错误
Socket error 10022 - Invalid argument   //参数错误
Socket error 10024 - Too many open files  // 打开太多的sockets
Socket error 10035 - Resource temporarily unavailable // 没有可以获取的资料
Socket error 10036 - Operation now in progress   // 一个阻塞操作正在进行中
Socket error 10037 - Operation already in progress  // 操作正在进行中
Socket error 10038 - Socket operation on non-socket //非法的socket对象在操作
Socket error 10039 - Destination address required   //目标地址错误
Socket error 10040 - Message too long            //数据太长
Socket error 10041 - Protocol wrong type for socket //协议类型错误
Socket error 10042 - Bad protocol option      // 错误的协议选项
Socket error 10043 - Protocol not supported   //协议不被支持
Socket error 10044 - Socket type not supported //socket类型不支持
Socket error 10045 - Operation not supported   //不支持该操作
Socket error 10046 - Protocol family not supported  //协议族不支持
Socket error 10047 - Address family not supported by protocol family//使用的地址族不在支持之列
Socket error 10048 - Address already in use   //地址已经被使用
Socket error 10049 - Cannot assign requested address  //地址设置失败
Socket error 10050 - Network is down    //网络关闭
Socket error 10051 - Network is unreachable //网络不可达
Socket error 10052 - Network dropped connection on reset  //网络被重置
Socket error 10053 - Software caused connection abort  //软件导致连接退出
Socket error 10054 - connection reset by peer   //连接被重置
Socket error 10055 - No buffer space available   //缓冲区不足
Socket error 10056 - Socket is already connected  // socket已经连接
Socket error 10057 - Socket is not connected    //socket没有连接
Socket error 10058 - Cannot send after socket shutdown  //socket已经关闭
Socket error 10060 - Connection timed out   //超时
Socket error 10061 - Connection refused     //连接被拒绝
Socket error 10064 - Host is down    //主机已关闭
Socket error 10065 - No route to host  // 没有可达的路由
Socket error 10067 - Too many processes  //进程太多
Socket error 10091 - Network subsystem is unavailable  //网络子系统不可用
Socket error 10092 - WINSOCK.DLL version out of range //winsock.dll版本超出范围
Socket error 10093 - Successful WSAStartup not yet performed //没有成功执行WSAStartup
Socket error 10094 - Graceful shutdown in progress  //
Socket error 11001 - Host not found   //主机没有找到
Socket error 11002 - Non-authoritative host not found   // 非授权的主机没有找到
Socket error 11003 - This is a non-recoverable error  //这是个无法恢复的错误
Socket error 11004 - Valid name, no data record of requested type  //请求的类型的名字或数据错误