linux 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));

/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

設定套介面的選項。

#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：描述字不是一個套介面。

參見：
bind(), getsockopt(), ioctlsocket(), socket(), WSAAsyncSelect().