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);
????第一個參數(shù)socket是套接字描述符。第二個參數(shù)level是被設(shè)置的選項的級別,如果想要在套接字級別上設(shè)置選項,就必須把level設(shè)置為?SOL_SOCKET。?option_name指定準(zhǔn)備設(shè)置的選項,option_name可以有哪些取值,這取決于level,以linux 2.6內(nèi)核為例(在不同的平臺上,這種關(guān)系可能會有不同),在套接字級別上(SOL_SOCKET),option_name可以有以下取?值:
????當(dāng)option_value不等于0時,打開調(diào)試信息,否則,關(guān)閉調(diào)試信息。它實際所做的工作是在sock->sk->sk_flag中置?SOCK_DBG(第10)位,或清SOCK_DBG位。
????當(dāng)option_value不等于0時,打開,否則,關(guān)閉。它實際所做的工作是置sock->sk->sk_reuse為1或0。
????當(dāng)option_value不等于0時,打開,否則,關(guān)閉。它實際所做的工作是在sock->sk->sk_flag中置或清SOCK_LOCALROUTE位。
????當(dāng)option_value不等于0時,允許,否則,禁止。它實際所做的工作是在sock->sk->sk_flag中置或清SOCK_BROADCAST位。
????發(fā)送緩沖區(qū)的大小是有上下限的,其上限為256 * (sizeof(struct sk_buff) + 256),下限為2048字節(jié)。該操作將sock->sk->sk_sndbuf設(shè)置為val * 2,之所以要乘以2,是防
止大數(shù)據(jù)量的發(fā)送,突然導(dǎo)致緩沖區(qū)溢出。最后,該操作完成后,因為對發(fā)送緩沖的大小 作了改變,要檢查sleep隊列,如果有進(jìn)程正在等待寫,將它們喚醒。
????接收緩沖區(qū)大小的上下限分別是:256 * (sizeof(struct sk_buff) + 256)和256字節(jié)。該操作將sock->sk->sk_rcvbuf設(shè)置為val * 2。
作都會根據(jù)option_value置或清 sock->sk->sk_flag中的?SOCK_KEEPOPEN位。
????該操作根據(jù)option_value的值置或清sock->sk->sk_flag中的SOCK_URGINLINE位。
????該操作根據(jù)option_value的值,設(shè)置sock->sk->sk_no_check。
????這個值在0到6之間(包括0和6),由option_value指定。賦給sock->sk->sk_priority。
????該選項的參數(shù)(option_value)是一個linger結(jié)構(gòu):
????????struct linger {
????????????int???l_onoff;???
????????????int???l_linger;??
????????};
如果linger.l_onoff值為0(關(guān)閉),則清 sock->sk->sk_flag中的SOCK_LINGER位;否則,置該位,并賦sk->sk_lingertime值為?linger.l_linger。
????該選項根據(jù)option_value的值,清或置sock->sk->sk_flag中的SOCK_PASSCRED位。
????該選項根據(jù)option_value的值,清或置sock->sk->sk_flag中的SOCK_RCVTSTAMP位,如果打開,則還需設(shè)sock->sk->sk_flag中的SOCK_TIMESTAMP位,同時,將全局變量
netstamp_needed加1。
????在Linux中,緩沖區(qū)內(nèi)的最小字節(jié)數(shù)是固定的,為1。即將sock->sk->sk_rcvlowat固定賦值為1。
????該選項最終將接收超時時間賦給sock->sk->sk_rcvtimeo。
????該選項最終將發(fā)送超時時間賦給sock->sk->sk_sndtimeo。
????該選項最終將設(shè)備賦給sock->sk->sk_bound_dev_if。
????關(guān)于數(shù)據(jù)包過濾,它們最終會影響sk->sk_filter。
????以上所介紹的都是在SOL_SOCKET層的一些套接字選項,如果超出這個范圍,?給出一些不在這一level的選項作為參數(shù),最終會得到- ENOPROTOOPT的返回值。但以上的分析僅限
于這些選項對sock-sk的值的影響,這些選項真正如何發(fā)揮作用,我們的探索道路 將漫漫其修遠(yuǎn)。
?
1.closesocket(一般不會立即關(guān)閉而經(jīng)歷TIME_WAIT的過程)后想繼續(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的過程:
BOOL bDontLinger = FALSE;
setsockopt(s,SOL_SOCKET,SO_DONTLINGER,(const char*)&bDontLinger,sizeof(BOOL));
3.在send(),recv()過程中有時由于網(wǎng)絡(luò)狀況等原因,發(fā)收不能預(yù)期進(jìn)行,而設(shè)置收發(fā)時限:
int nNetTimeout=1000;//1秒
//發(fā)送時限
setsockopt(socket,SOL_S0CKET,SO_SNDTIMEO,(char *)&nNetTimeout,sizeof(int));
//接收時限
setsockopt(socket,SOL_S0CKET,SO_RCVTIMEO,(char *)&nNetTimeout,sizeof(int));
4.在send()的時候,返回的是實際發(fā)送出去的字節(jié)(同步)或發(fā)送到socket緩沖區(qū)的字節(jié)
(異步);系統(tǒng)默認(rèn)的狀態(tài)發(fā)送和接收一次為8688字節(jié)(約為8.5K);在實際的過程中發(fā)送數(shù)據(jù)
和接收數(shù)據(jù)量比較大,可以設(shè)置socket緩沖區(qū),而避免了send(),recv()不斷的循環(huán)收發(fā):
// 接收緩沖區(qū)
int nRecvBuf=32*1024;//設(shè)置為32K
setsockopt(s,SOL_SOCKET,SO_RCVBUF,(const char*)&nRecvBuf,sizeof(int));
//發(fā)送緩沖區(qū)
int nSendBuf=32*1024;//設(shè)置為32K
setsockopt(s,SOL_SOCKET,SO_SNDBUF,(const char*)&nSendBuf,sizeof(int));
5.?如果在發(fā)送數(shù)據(jù)的時,希望不經(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ù)報的時候,希望該socket發(fā)送的數(shù)據(jù)具有廣播特性:
BOOL bBroadcast=TRUE;
setsockopt(s,SOL_SOCKET,SO_BROADCAST,(const char*)&bBroadcast,sizeof(BOOL));
8.在client連接服務(wù)器過程中,如果處于非阻塞模式下的socket在connect()的過程中可
以設(shè)置connect()延時,直到accpet()被呼叫(本函數(shù)設(shè)置只有在非阻塞的過程中有顯著的
作用,在阻塞的函數(shù)調(diào)用中作用不大)
BOOL bConditionalAccept=TRUE;
setsockopt(s,SOL_SOCKET,SO_CONDITIONAL_ACCEPT,(const char*)&bConditionalAccept,sizeof(BOOL));
9.如果在發(fā)送數(shù)據(jù)的過程中(send()沒有完成,還有數(shù)據(jù)沒發(fā)送)而調(diào)用了closesocket(),以前我們
一般采取的措施是"從容關(guān)閉"shutdown(s,SD_BOTH),但是數(shù)據(jù)是肯定丟失了,如何設(shè)置讓程序滿足具體
應(yīng)用的要求(即讓沒發(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ù)沒發(fā)送完畢的時候容許逗留)
// 如果m_sLinger.l_onoff=0;則功能和2.)作用相同;
m_sLinger.l_linger=5;//(容許逗留的時間為5秒)
setsockopt(s,SOL_SOCKET,SO_LINGER,(const char*)&m_sLinger,sizeof(linger));
?
設(shè)置套接口的選項。
???#include <winsock.h>
???int PASCAL FAR?setsockopt( SOCKET s, int level, int optname,
???const char FAR* optval, int optlen);
???s:標(biāo)識一個套接口的描述字。
???level:選項定義的層次;目前僅支持SOL_SOCKET和IPPROTO_TCP層次。
???optname:需設(shè)置的選項。
???optval:指針,指向存放選項值的緩沖區(qū)。
???optlen:optval緩沖區(qū)的長度。
注釋:
setsockopt()函數(shù)用于任意類型、任意狀態(tài)套接口的設(shè)置選項值。盡管在不同協(xié)議層上存在選項,但本函數(shù)僅定義了最高的“套接口”層次上的選項。選項影響套接口的操作,諸如加急數(shù)據(jù)是否在普通數(shù)據(jù)流中接收,廣播數(shù)據(jù)是否可以從套接口發(fā)送等等。
???有兩種套接口的選項:一種是布爾型選項,允許或禁止一種特性;另一種是整形或結(jié)構(gòu)選項。允許一個布爾型選項,則將optval指向非零整形數(shù);禁止一個選項optval指向一個等于零的整形數(shù)。對于布爾型選項,optlen應(yīng)等于sizeof(int);對其他選項,optval指向包含所需選項的整形數(shù)或結(jié)構(gòu),而optlen則為整形數(shù)或結(jié)構(gòu)的長度。SO_LINGER選項用于控制下述情況的行動:套接口上有排隊的待發(fā)送數(shù)據(jù),且 closesocket()調(diào)用已執(zhí)行。參見closesocket()函數(shù)中關(guān)于SO_LINGER選項對closesocket()語義的影響。應(yīng)用程序通過創(chuàng)建一個linger結(jié)構(gòu)來設(shè)置相應(yīng)的操作特性:
???struct linger {
int l_onoff;
int l_linger;
???};
???為了允許SO_LINGER,應(yīng)用程序應(yīng)將l_onoff設(shè)為非零,將l_linger設(shè)為零或需要的超時值(以秒為單位),然后調(diào)用setsockopt()。為了允許SO_DONTLINGER(亦即禁止SO_LINGER),l_onoff應(yīng)設(shè)為零,然后調(diào)用setsockopt()。
???缺省條件下,一個套接口不能與一個已在使用中的本地地址捆綁(參見bind())。但有時會需要“重用”地址。因為每一個連接都由本地地址和遠(yuǎn)端地址的組合唯一確定,所以只要遠(yuǎn)端地址不同,兩個套接口與一個地址捆綁并無大礙。為了通知WINDOWS套接口實現(xiàn)不要因為一個地址已被一個套接口使用就不讓它與另一個套接口捆綁,應(yīng)用程序可在bind()調(diào)用前先設(shè)置SO_REUSEADDR選項。請注意僅在bind()調(diào)用時該選項才被解釋;故此無需(但也無害)將一個不會共用地址的套接口設(shè)置該選項,或者在bind()對這個或其他套接口無影響情況下設(shè)置或清除這一選項。
???一個應(yīng)用程序可以通過打開SO_KEEPALIVE選項,使得WINDOWS套接口實現(xiàn)在TCP連接情況下允許使用“保持活動”包。一個WINDOWS套接口實現(xiàn)并不是必需支持“保持活動”,但是如果支持的話,具體的語義將與實現(xiàn)有關(guān),應(yīng)遵守RFC1122“Internet主機(jī)要求-通訊層”中第 4.2.3.6節(jié)的規(guī)范。如果有關(guān)連接由于“保持活動”而失效,則進(jìn)行中的任何對該套接口的調(diào)用都將以WSAENETRESET錯誤返回,后續(xù)的任何調(diào)用將以WSAENOTCONN錯誤返回。
???TCP_NODELAY選項禁止Nagle算法。Nagle算法通過將未確認(rèn)的數(shù)據(jù)存入緩沖區(qū)直到蓄足一個包一起發(fā)送的方法,來減少主機(jī)發(fā)送的零碎小數(shù)據(jù)包的數(shù)目。但對于某些應(yīng)用來說,這種算法將降低系統(tǒng)性能。所以TCP_NODELAY可用來將此算法關(guān)閉。應(yīng)用程序編寫者只有在確切了解它的效果并確實需要的情況下,才設(shè)置TCP_NODELAY選項,因為設(shè)置后對網(wǎng)絡(luò)性能有明顯的負(fù)面影響。TCP_NODELAY是唯一使用IPPROTO_TCP層的選項,其他所有選項都使用SOL_SOCKET層。
???如果設(shè)置了SO_DEBUG選項,WINDOWS套接口供應(yīng)商被鼓勵(但不是必需)提供輸出相應(yīng)的調(diào)試信息。但產(chǎn)生調(diào)試信息的機(jī)制以及調(diào)試信息的形式已超出本規(guī)范的討論范圍。
setsockopt()支持下列選項。其中“類型”表明optval所指數(shù)據(jù)的類型。
選項????????類型???意義
SO_BROADCAST BOOL 允許套接口傳送廣播信息。
SO_DEBUG BOOL 記錄調(diào)試信息。
SO_DONTLINER BOOL 不要因為數(shù)據(jù)未發(fā)送就阻塞關(guān)閉操作。設(shè)置本選項相當(dāng)于將SO_LINGER的l_onoff元素置為零。
SO_DONTROUTE BOOL 禁止選徑;直接傳送。
SO_KEEPALIVE BOOL 發(fā)送“保持活動”包。
SO_LINGER struct linger FAR*???如關(guān)閉時有未發(fā)送數(shù)據(jù),則逗留。
SO_OOBINLINE BOOL 在常規(guī)數(shù)據(jù)流中接收帶外數(shù)據(jù)。
SO_RCVBUF int 為接收確定緩沖區(qū)大小。
SO_REUSEADDR BOOL 允許套接口和一個已在使用中的地址捆綁(參見bind())。
SO_SNDBUF int 指定發(fā)送緩沖區(qū)大小。
TCP_NODELAY BOOL 禁止發(fā)送合并的Nagle算法。
setsockopt()不支持的BSD選項有:
選項名????類型 意義
SO_ACCEPTCONN BOOL 套接口在監(jiān)聽。
SO_ERROR int 獲取錯誤狀態(tài)并清除。
SO_RCVLOWAT int 接收低級水印。
SO_RCVTIMEO int 接收超時。
SO_SNDLOWAT int 發(fā)送低級水印。
SO_SNDTIMEO int 發(fā)送超時。
SO_TYPE?????int 套接口類型。
IP_OPTIONS????在IP頭中設(shè)置選項。
返回值:
???若無錯誤發(fā)生,setsockopt()返回0。否則的話,返回SOCKET_ERROR錯誤,應(yīng)用程序可通過WSAGetLastError()獲取相應(yīng)錯誤代碼。
錯誤代碼:
???WSANOTINITIALISED:在使用此API之前應(yīng)首先成功地調(diào)用WSAStartup()。
???WSAENETDOWN:WINDOWS套接口實現(xiàn)檢測到網(wǎng)絡(luò)子系統(tǒng)失效。
???WSAEFAULT:optval不是進(jìn)程地址空間中的一個有效部分。
???WSAEINPROGRESS:一個阻塞的WINDOWS套接口調(diào)用正在運行中。
???WSAEINVAL:level值非法,或optval中的信息非法。
???WSAENETRESET:當(dāng)SO_KEEPALIVE設(shè)置后連接超時。
???WSAENOPROTOOPT:未知或不支持選項。其中,SOCK_STREAM類型的套接口不支持SO_BROADCAST選項,SOCK_DGRAM 類型的套接口不支持SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE選項。
???WSAENOTCONN:當(dāng)設(shè)置SO_KEEPALIVE后連接被復(fù)位。
???WSAENOTSOCK:描述字不是一個套接口。
總結(jié)
以上是生活随笔為你收集整理的setsockopt()函数 参数详解的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: VM pow 函数 :undefined
- 下一篇: 嗯?time命令Linux time /