setsockopt()函數 參數詳解

Socket描述符選項[SOL_SOCKET]

#include <sys/socket.h>

     int setsockopt( int socket, int level, int option_name,

                         const void *option_value, size_t option_len);

    第一個參數socket是套接字描述符。第二個參數level是被設定的選項的級别，如果想要在套接字級别上設定選項，就必須把level設定為 SOL_SOCKET。 option_name指定準備設定的選項，option_name可以有哪些取值，這取決于level，以linux 2.6核心為例（在不同的平台上，這種關系可能會有不同），在套接字級别上(SOL_SOCKET)，option_name可以有以下取 值：

1.     SO_DEBUG，打開或關閉調試資訊。

       當option_value不等于0時，打開調試資訊，否則，關閉調試資訊。它實際所做的工作是在sock->sk->sk_flag中置 SOCK_DBG(第10)位，或清SOCK_DBG位。

1.     SO_REUSEADDR，打開或關閉位址複用功能。

       當option_value不等于0時，打開，否則，關閉。它實際所做的工作是置sock->sk->sk_reuse為1或0。

1.     SO_DONTROUTE，打開或關閉路由查找功能。

       當option_value不等于0時，打開，否則，關閉。它實際所做的工作是在sock->sk->sk_flag中置或清SOCK_LOCALROUTE位。

1.     SO_BROADCAST，允許或禁止發送廣播資料。

       當option_value不等于0時，允許，否則，禁止。它實際所做的工作是在sock->sk->sk_flag中置或清SOCK_BROADCAST位。

1.     SO_SNDBUF，設定發送緩沖區的大小。

       發送緩沖區的大小是有上下限的，其上限為256 * (sizeof(struct sk_buff) + 256)，下限為2048位元組。該操作将sock->sk->sk_sndbuf設定為val * 2，之是以要乘以2，是防

   止大資料量的發送，突然導緻緩沖區溢出。最後，該操作完成後，因為對發送緩沖的大小 作了改變，要檢查sleep隊列，如果有程序正在等待寫，将它們喚醒。

1.     SO_RCVBUF，設定接收緩沖區的大小。

       接收緩沖區大小的上下限分别是：256 * (sizeof(struct sk_buff) + 256)和256位元組。該操作将sock->sk->sk_rcvbuf設定為val * 2。

2.     SO_KEEPALIVE，套接字保活。

       如果協定是TCP，并且目前的套接字狀态不是偵聽(listen)或關閉(close)，那麼，當option_value不是零時，啟用TCP保活定時 器，否則關閉保活定時器。對于所有協定，該操

   作都會根據option_value置或清 sock->sk->sk_flag中的 SOCK_KEEPOPEN位。

3.     SO_OOBINLINE，緊急資料放入普通資料流。

       該操作根據option_value的值置或清sock->sk->sk_flag中的SOCK_URGINLINE位。

4.     SO_NO_CHECK，打開或關閉校驗和。

       該操作根據option_value的值，設定sock->sk->sk_no_check。

5.     SO_PRIORITY，設定在套接字發送的所有包的協定定義優先權。Linux通過這一值來排列網絡隊列。

       這個值在0到6之間（包括0和6），由option_value指定。賦給sock->sk->sk_priority。

1.     SO_LINGER，如果選擇此選項, close或 shutdown将等到所有套接字裡排隊的消息成功發送或到達延遲時間後>才會傳回. 否則, 調用将立即傳回。

       該選項的參數（option_value)是一個linger結構：

           struct linger {

               int   l_onoff;   

               int   l_linger;  

           };

   如果linger.l_onoff值為0(關閉），則清 sock->sk->sk_flag中的SOCK_LINGER位；否則，置該位，并賦sk->sk_lingertime值為 linger.l_linger。

1.     SO_PASSCRED，允許或禁止SCM_CREDENTIALS 控制消息的接收。

       該選項根據option_value的值，清或置sock->sk->sk_flag中的SOCK_PASSCRED位。

2.     SO_TIMESTAMP，打開或關閉資料報中的時間戳接收。

       該選項根據option_value的值，清或置sock->sk->sk_flag中的SOCK_RCVTSTAMP位，如果打開，則還需設sock->sk->sk_flag中的SOCK_TIMESTAMP位，同時，将全局變量

   netstamp_needed加1。

3.     SO_RCVLOWAT，設定接收資料前的緩沖區内的最小位元組數。

       在Linux中，緩沖區内的最小位元組數是固定的，為1。即将sock->sk->sk_rcvlowat固定指派為1。

1.     SO_RCVTIMEO，設定接收逾時時間。

       該選項最終将接收逾時時間賦給sock->sk->sk_rcvtimeo。

1.     SO_SNDTIMEO，設定發送逾時時間。

       該選項最終将發送逾時時間賦給sock->sk->sk_sndtimeo。

2.     SO_BINDTODEVICE，将套接字綁定到一個特定的裝置上。

       該選項最終将裝置賦給sock->sk->sk_bound_dev_if。

1.     SO_ATTACH_FILTER和SO_DETACH_FILTER。

       關于資料包過濾，它們最終會影響sk->sk_filter。

       以上所介紹的都是在SOL_SOCKET層的一些套接字選項，如果超出這個範圍， 給出一些不在這一level的選項作為參數，最終會得到- ENOPROTOOPT的傳回值。但以上的分析僅限

   于這些選項對sock-sk的值的影響，這些選項真正如何發揮作用，我們的探索道路 将漫漫其修遠。

   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：描述字不是一個套接口。