C函數篇(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()調用已執行。參見close socket（） 函數中關於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_KEEPALⅣE 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_KEEPALⅣE設置後鏈接超時。

WSAENOPROTOOPT：未知或不支持選項。其中，SOCK_STREAM類型的 套接口不支持SO_BROADCAST選項，SOCK_DGRAM類型的套接口不支持SO_DONTLINGER 、SO_KEEPALⅣE、SO_LINGER和SO_OOBINLINE選項。

WSAENOTCONN：當設置SO_KEEPALⅣE後鏈接被複位。

WSAENOTSOCK：描述字不是一個 套接口。

用法

⒈設置調用 closesocket()後，仍可繼續重用該 socket。調用 closesocket()通常不會當即關閉 socket，而經歷TIME_WAIT的過程。

BOOL bReuseaddr = TRUE;

setsockopt(s,SOL_SOCKET, SO_REUSEADDR,(const char*)&bReuseaddr,sizeof(BOOL));

⒉ 若是要已經處於鏈接狀態的soket在調用close socket()後強制關閉，不經歷TIME_WAIT的過程：

BOOL bDontLinger = FALSE;

setsockopt(s,SOL_SOCKET,SO_DONTLINGER,(const char*)&bDontLinger,sizeof(BOOL));

⒊在 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));

⒋在 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));

⒌在發送數據的時，不執行由系統 緩衝區到 socket緩衝區的拷貝，以提升程序的性能：

int nZero = 0;

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

⒍在接收數據時，不執行將 socket 緩衝區的內容拷貝到系統緩衝區：

int nZero = 0;

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

⒎通常在發送 UDP數據報的時候，但願該 socket發送的數據具備廣播特性：

BOOL bBroadcast = TRUE;

setsockopt(s,SOL_SOCKET,SO_BROADCAST,(const char*)&bBroadcast,sizeof(BOOL));

⒏在client鏈接服務器過程當中，若是處於非阻塞模式下的 socket在 connect()的過程當中能夠設置 connect（）延時，直到accpet（）被調用（此設置只

有在非阻塞的過程當中有顯著的做用，在阻塞的 函數調用中做用不大）

BOOL bConditionalAccept = TRUE;

setsockopt(s,SOL_SOCKET,SO_CONDITIONAL_ACCEPT,(const char*)&bConditionalAccept,sizeof(BOOL));

⒐若是在發送數據的過程當中 send()沒有完成，還有數據沒發送，而調用了close socket（），之前通常採起的措施是 shutdown(s,SD_BOTH），可是數

據將會丟失。

某些具體程序要求待未發送完的數據發送出去後再關閉 socket，可經過設置讓程序知足要求：

 1 struct linger {
 2   u_short l_onoff;
 3   u_short l_linger;
 4 };
 5 linger m_sLinger;
 6 m_sLinger.l_onoff = 1;
 7 //在調用closesocket（）時還有數據未發送完，容許等待
 8 //若m_sLinger.l_onoff=0；則調用closesocket（）後強制關閉
 9 m_sLinger.l_linger = 5; //設置等待時間爲5秒
10 setsockopt(s, SOL_SOCKET, SO_LINGER,
11     (const char*)&m_sLinger,sizeof(linger));