setsockopt用法詳解

最近做的一個(gè)程序用到了IOCP通信模型，里面用到了setsockopt對(duì)套接字進(jìn)行設(shè)置，看源代碼的時(shí)候最setsockopt函數(shù)很不理解，看了msdn以后還是不太明白這個(gè)函數(shù)的用法，于是就到網(wǎng)上找了一個(gè)這個(gè)函數(shù)的用法，找到了下面的這篇文章，我覺(jué)得對(duì)setsockopt這個(gè)函數(shù)講解的特別號(hào)，就轉(zhuǎn)過(guò)來(lái)了，方便以后的查閱。。
1.closesocket（一般不會(huì)立即關(guān)閉而經(jīng)歷TIME_WAIT的過(guò)程）后想繼續(xù)重用該socket：BOOL bReuseaddr=TRUE;setsockopt(s,SOL_SOCKET ,SO_REUSEADDR,(const char)&bReuseaddr,sizeof(BOOL));
2. 如果要已經(jīng)處于連接狀態(tài)的soket在調(diào)用closesocket后強(qiáng)制關(guān)閉，不經(jīng)歷TIME_WAIT的過(guò)程：BOOL bDontLinger = FALSE;setsockopt(s,SOL_SOCKET,SO_DONTLINGER,(const char)&bDontLinger,sizeof(BOOL));
3.在send(),recv()過(guò)程中有時(shí)由于網(wǎng)絡(luò)狀況等原因，發(fā)收不能預(yù)期進(jìn)行,而設(shè)置收發(fā)時(shí)限：int nNetTimeout=1000;//1秒//發(fā)送時(shí)限setsockopt(socket，SOL_S0CKET,SO_SNDTIMEO，(char )&nNetTimeout,sizeof(int));//接收時(shí)限setsockopt(socket，SOL_S0CKET,SO_RCVTIMEO，(char )&nNetTimeout,sizeof(int));
4.在send()的時(shí)候，返回的是實(shí)際發(fā)送出去的字節(jié)(同步)或發(fā)送到socket緩沖區(qū)的字節(jié)(異步);系統(tǒng)默認(rèn)的狀態(tài)發(fā)送和接收一次為8688字節(jié)(約為8.5K)；在實(shí)際的過(guò)程中發(fā)送數(shù)據(jù)和接收數(shù)據(jù)量比較大，可以設(shè)置socket緩沖區(qū)，而避免了send(),recv()不斷的循環(huán)收發(fā)：// 接收緩沖區(qū)int nRecvBuf=321024;//設(shè)置為32Ksetsockopt(s,SOL_SOCKET,SO_RCVBUF,(const char)&nRecvBuf,sizeof(int));//發(fā)送緩沖區(qū)int nSendBuf=321024;//設(shè)置為32Ksetsockopt(s,SOL_SOCKET,SO_SNDBUF,(const char)&nSendBuf,sizeof(int));
5. 如果在發(fā)送數(shù)據(jù)的時(shí)，希望不經(jīng)歷由系統(tǒng)緩沖區(qū)到socket緩沖區(qū)的拷貝而影響程序的性能：int nZero=0;setsockopt(socket，SOL_S0CKET,SO_SNDBUF，(char )&nZero,sizeof(nZero));
6.同上在recv()完成上述功能(默認(rèn)情況是將socket緩沖區(qū)的內(nèi)容拷貝到系統(tǒng)緩沖區(qū))：int nZero=0;setsockopt(socket，SOL_S0CKET,SO_RCVBUF，(char )&nZero,sizeof(int));
7.一般在發(fā)送UDP數(shù)據(jù)報(bào)的時(shí)候，希望該socket發(fā)送的數(shù)據(jù)具有廣播特性：BOOL bBroadcast=TRUE;setsockopt(s,SOL_SOCKET,SO_BROADCAST,(const char)&bBroadcast,sizeof(BOOL));
8.在client連接服務(wù)器過(guò)程中，如果處于非阻塞模式下的socket在connect()的過(guò)程中可以設(shè)置connect()延時(shí),直到accpet()被呼叫(本函數(shù)設(shè)置只有在非阻塞的過(guò)程中有顯著的作用，在阻塞的函數(shù)調(diào)用中作用不大)BOOL bConditionalAccept=TRUE;setsockopt(s,SOL_SOCKET,SO_CONDITIONAL_ACCEPT,(const char)&bConditionalAccept,sizeof(BOOL));
9.如果在發(fā)送數(shù)據(jù)的過(guò)程中(send()沒(méi)有完成，還有數(shù)據(jù)沒(méi)發(fā)送)而調(diào)用了closesocket(),以前我們一般采取的措施是"從容關(guān)閉"shutdown(s,SD_BOTH),但是數(shù)據(jù)是肯定丟失了，如何設(shè)置讓程序滿(mǎn)足具體應(yīng)用的要求(即讓沒(méi)發(fā)完的數(shù)據(jù)發(fā)送出去后在關(guān)閉socket)？struct linger {u_short l_onoff;u_short l_linger;};linger m_sLinger;m_sLinger.l_onoff=1;//(在closesocket()調(diào)用,但是還有數(shù)據(jù)沒(méi)發(fā)送完畢的時(shí)候容許逗留)// 如果m_sLinger.l_onoff=0;則功能和2.)作用相同;m_sLinger.l_linger=5;//(容許逗留的時(shí)間為5秒)setsockopt(s,SOL_SOCKET,SO_LINGER,(const char)&m_sLinger,sizeof(linger));
SO_LINGER 此選項(xiàng)指定函數(shù)close對(duì)面向連接的協(xié)議如何操作（如TCP）。缺省close操作是立即返回，如果有數(shù)據(jù)殘留在套接口緩沖區(qū)中則系統(tǒng)將試著將這些數(shù)據(jù) 發(fā)送給對(duì)方。 SO_LINGER選項(xiàng)用來(lái)改變此缺省設(shè)置。使用如下結(jié)構(gòu)： struct linger { int l_onoff; int l_linger; }; 有下列三種情況： l_onoff為0，則該選項(xiàng)關(guān)閉，l_linger的值被忽略，等于缺省情況，close立即返回； l_onoff為非0，l_linger為0，則套接口關(guān)閉時(shí)TCP夭折連接，TCP將丟棄保留在套接口發(fā)送緩沖區(qū)中的任何數(shù)據(jù)并發(fā)送一個(gè)RST 給對(duì)方，而不是通常的四分組終止序列，這避免了TIME_WAIT狀態(tài)； l_onoff 為非0，l_linger為非0，當(dāng)套接口關(guān)閉時(shí)內(nèi)核將拖延一段時(shí)間（由l_linger決定）。如果套接口緩沖區(qū)中仍殘留數(shù)據(jù)，進(jìn)程將處于睡眠狀態(tài)，直 到（a）所有數(shù)據(jù)發(fā)送完且被對(duì)方確認(rèn)，之后進(jìn)行正常的終止序列（描述字訪問(wèn)計(jì)數(shù)為0）或（b）延遲時(shí)間到。此種情況下，應(yīng)用程序檢查close的返回值是 非常重要的，如果在數(shù)據(jù)發(fā)送完并被確認(rèn)前時(shí)間到，close將返回EWOULDBLOCK錯(cuò)誤且套接口發(fā)送緩沖區(qū)中的任何數(shù)據(jù)都丟失。close的成功返 回僅告訴我們發(fā)送的數(shù)據(jù)（和FIN）已由對(duì)方TCP確認(rèn)，它并不能告訴我們對(duì)方應(yīng)用進(jìn)程是否已讀了數(shù)據(jù)。如果套接口設(shè)為非阻塞的，它將不等待close完 成。 l_linger的單位依賴(lài)于實(shí)現(xiàn)，4.4BSD假設(shè)其單位是時(shí)鐘滴答（百分之一秒），但Posix.1g規(guī)定單位為秒。
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
設(shè)置套接口的選項(xiàng)。 #include <winsock.h> int PASCAL FAR setsockopt( SOCKET s, int level, int optname, const char FAR optval, int optlen); s：標(biāo)識(shí)一個(gè)套接口的描述字。 level：選項(xiàng)定義的層次；目前僅支持SOL_SOCKET和IPPROTO_TCP層次。 optname：需設(shè)置的選項(xiàng)。 optval：指針，指向存放選項(xiàng)值的緩沖區(qū)。 optlen：optval緩沖區(qū)的長(zhǎng)度。注釋?zhuān)? setsockopt()函數(shù)用于任意類(lèi)型、任意狀態(tài)套接口的設(shè)置選項(xiàng)值。盡管在不同協(xié)議層上存在選項(xiàng)，但本函數(shù)僅定義了最高的“套接口”層次上的選項(xiàng)。選項(xiàng)影響套接口的操作，諸如加急數(shù)據(jù)是否在普通數(shù)據(jù)流中接收，廣播數(shù)據(jù)是否可以從套接口發(fā)送等等。 有兩種套接口的選項(xiàng)：一種是布爾型選項(xiàng)，允許或禁止一種特性；另一種是整形或結(jié)構(gòu)選項(xiàng)。允許一個(gè)布爾型選項(xiàng)，則將optval指向非零整形數(shù)；禁止一個(gè)選項(xiàng)optval指向一個(gè)等于零的整形數(shù)。對(duì)于布爾型選項(xiàng)，optlen應(yīng)等于sizeof(int)；對(duì)其他選項(xiàng)，optval指向包含所需選項(xiàng)的整形數(shù)或結(jié)構(gòu)，而optlen則為整形數(shù)或結(jié)構(gòu)的長(zhǎng)度。SO_LINGER選項(xiàng)用于控制下述情況的行動(dòng)：套接口上有排隊(duì)的待發(fā)送數(shù)據(jù)，且closesocket()調(diào)用已執(zhí)行。參見(jiàn)closesocket()函數(shù)中關(guān)于SO_LINGER選項(xiàng)對(duì)closesocket()語(yǔ)義的影響。應(yīng)用程序通過(guò)創(chuàng)建一個(gè)linger結(jié)構(gòu)來(lái)設(shè)置相應(yīng)的操作特性： struct linger { int l_onoff; int l_linger; }; 為了允許SO_LINGER，應(yīng)用程序應(yīng)將l_onoff設(shè)為非零，將l_linger設(shè)為零或需要的超時(shí)值（以秒為單位），然后調(diào)用setsockopt()。為了允許SO_DONTLINGER（亦即禁止SO_LINGER），l_onoff應(yīng)設(shè)為零，然后調(diào)用setsockopt()。 缺省條件下，一個(gè)套接口不能與一個(gè)已在使用中的本地地址捆綁（參見(jiàn)bind()）。但有時(shí)會(huì)需要“重用”地址。因?yàn)槊恳粋€(gè)連接都由本地地址和遠(yuǎn)端地址的組合唯一確定，所以只要遠(yuǎn)端地址不同，兩個(gè)套接口與一個(gè)地址捆綁并無(wú)大礙。為了通知WINDOWS套接口實(shí)現(xiàn)不要因?yàn)橐粋€(gè)地址已被一個(gè)套接口使用就不讓它與另一個(gè)套接口捆綁，應(yīng)用程序可在bind()調(diào)用前先設(shè)置SO_REUSEADDR選項(xiàng)。請(qǐng)注意僅在bind()調(diào)用時(shí)該選項(xiàng)才被解釋?zhuān)还蚀藷o(wú)需（但也無(wú)害）將一個(gè)不會(huì)共用地址的套接口設(shè)置該選項(xiàng)，或者在bind()對(duì)這個(gè)或其他套接口無(wú)影響情況下設(shè)置或清除這一選項(xiàng)。 一個(gè)應(yīng)用程序可以通過(guò)打開(kāi)SO_KEEPALIVE選項(xiàng)，使得WINDOWS套接口實(shí)現(xiàn)在TCP連接情況下允許使用“保持活動(dòng)”包。一個(gè)WINDOWS套接口實(shí)現(xiàn)并不是必需支持“保持活動(dòng)”，但是如果支持的話(huà)，具體的語(yǔ)義將與實(shí)現(xiàn)有關(guān)，應(yīng)遵守RFC1122“Internet主機(jī)要求－通訊層”中第4.2.3.6節(jié)的規(guī)范。如果有關(guān)連接由于“保持活動(dòng)”而失效，則進(jìn)行中的任何對(duì)該套接口的調(diào)用都將以WSAENETRESET錯(cuò)誤返回，后續(xù)的任何調(diào)用將以WSAENOTCONN錯(cuò)誤返回。 TCP_NODELAY選項(xiàng)禁止Nagle算法。Nagle算法通過(guò)將未確認(rèn)的數(shù)據(jù)存入緩沖區(qū)直到蓄足一個(gè)包一起發(fā)送的方法，來(lái)減少主機(jī)發(fā)送的零碎小數(shù)據(jù)包的數(shù)目。但對(duì)于某些應(yīng)用來(lái)說(shuō)，這種算法將降低系統(tǒng)性能。所以TCP_NODELAY可用來(lái)將此算法關(guān)閉。應(yīng)用程序編寫(xiě)者只有在確切了解它的效果并確實(shí)需要的情況下，才設(shè)置TCP_NODELAY選項(xiàng)，因?yàn)樵O(shè)置后對(duì)網(wǎng)絡(luò)性能有明顯的負(fù)面影響。TCP_NODELAY是唯一使用IPPROTO_TCP層的選項(xiàng)，其他所有選項(xiàng)都使用SOL_SOCKET層。 如果設(shè)置了SO_DEBUG選項(xiàng)，WINDOWS套接口供應(yīng)商被鼓勵(lì)（但不是必需）提供輸出相應(yīng)的調(diào)試信息。但產(chǎn)生調(diào)試信息的機(jī)制以及調(diào)試信息的形式已超出本規(guī)范的討論范圍。 setsockopt()支持下列選項(xiàng)。其中“類(lèi)型”表明optval所指數(shù)據(jù)的類(lèi)型。選項(xiàng) 類(lèi)型 意義SO_BROADCAST BOOL 允許套接口傳送廣播信息。SO_DEBUG BOOL 記錄調(diào)試信息。SO_DONTLINER BOOL 不要因?yàn)閿?shù)據(jù)未發(fā)送就阻塞關(guān)閉操作。設(shè)置本選項(xiàng)相當(dāng)于將SO_LINGER的l_onoff元素置為零。SO_DONTROUTE BOOL 禁止選徑；直接傳送。SO_KEEPALIVE BOOL 發(fā)送“保持活動(dòng)”包。SO_LINGER struct linger FAR* 如關(guān)閉時(shí)有未發(fā)送數(shù)據(jù)，則逗留。SO_OOBINLINE BOOL 在常規(guī)數(shù)據(jù)流中接收帶外數(shù)據(jù)。SO_RCVBUF int 為接收確定緩沖區(qū)大小。SO_REUSEADDR BOOL 允許套接口和一個(gè)已在使用中的地址捆綁（參見(jiàn)bind()）。SO_SNDBUF int 指定發(fā)送緩沖區(qū)大小。TCP_NODELAY BOOL 禁止發(fā)送合并的Nagle算法。 setsockopt()不支持的BSD選項(xiàng)有：選項(xiàng)名 類(lèi)型 意義SO_ACCEPTCONN BOOL 套接口在監(jiān)聽(tīng)。SO_ERROR int 獲取錯(cuò)誤狀態(tài)并清除。SO_RCVLOWAT int 接收低級(jí)水印。SO_RCVTIMEO int 接收超時(shí)。SO_SNDLOWAT int 發(fā)送低級(jí)水印。SO_SNDTIMEO int 發(fā)送超時(shí)。SO_TYPE int 套接口類(lèi)型。IP_OPTIONS 在IP頭中設(shè)置選項(xiàng)。返回值： 若無(wú)錯(cuò)誤發(fā)生，setsockopt()返回0。否則的話(huà)，返回SOCKET_ERROR錯(cuò)誤，應(yīng)用程序可通過(guò)WSAGetLastError()獲取相應(yīng)錯(cuò)誤代碼。錯(cuò)誤代碼： WSANOTINITIALISED：在使用此API之前應(yīng)首先成功地調(diào)用WSAStartup()。 WSAENETDOWN：WINDOWS套接口實(shí)現(xiàn)檢測(cè)到網(wǎng)絡(luò)子系統(tǒng)失效。 WSAEFAULT：optval不是進(jìn)程地址空間中的一個(gè)有效部分。 WSAEINPROGRESS：一個(gè)阻塞的WINDOWS套接口調(diào)用正在運(yùn)行中。 WSAEINVAL：level值非法，或optval中的信息非法。 WSAENETRESET：當(dāng)SO_KEEPALIVE設(shè)置后連接超時(shí)。 WSAENOPROTOOPT：未知或不支持選項(xiàng)。其中，SOCK_STREAM類(lèi)型的套接口不支持SO_BROADCAST選項(xiàng)，SOCK_DGRAM類(lèi)型的套接口不支持SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE選項(xiàng)。 WSAENOTCONN：當(dāng)設(shè)置SO_KEEPALIVE后連接被復(fù)位。 WSAENOTSOCK：描述字不是一個(gè)套接口。