getsockopt()
|
簡述：
擷取一個套介面選項。
#include <winsock.h>
int PASCAL FAR getsockopt( SOCKET s, int level, int optname,
char FAR* optval, int FAR* optlen);
s：一個標識套介面的描述字。
level：選項定義的層次。支援的層次僅有SOL_SOCKET和IPPROTO_TCP。
optname：需擷取的套介面選項。
optval：指標，指向存放所獲得選項值的緩衝區。
optlen：指標，指向optval緩衝區的長度值。
注釋：
getsockopt()函數用於擷取任意類型、任意狀態套介面的選項當前值，並把結果存入optval。在不同協議層上存在選項，但往往是在最高的“套介面”層次上，設定選項影響套介面的操作，諸如操作的阻塞與否、包的選徑方式、帶外資料的傳送等。
被選中選項的值放在optval緩衝區中。optlen所指向的整形數在初始時包含緩衝區的長度，在調用返回時被置為實際值的長度。對SO_LINGER選項而言，相當於linger結構的大小，對其他選項來說，是一個整形數的大小。
如果未進行setsockopt()調用，則getsockopt()返回系統預設值。
getsockopt()支援下列選項。其中“類型”欄指出了optval所指向的值。僅有TCP_NODELAY選項使用了IPPROTO_TCP層；其餘選項均使用SOL_SOCKET層。
選項 類型 意義
SO_ACCEPTCONN BOOL 套介面正在用listen()監聽。
SO_BROADCAST BOOL 套介面設定為傳送廣播資訊。
SO_DEBUG BOOL 允許調試。
SO_DONTLINER BOOL 若為真，則SO_LINGER選項被禁止。
SO_DONTROUTE BOOL 禁止選徑。
SO_ERROR int 擷取錯誤狀態並清除。
SO_KEEPALIVE BOOL 發送“保持活動”資訊。
SO_LINGER struct linger FAR* 返回當前各linger選項。
SO_OOBINLINE BOOL 在普通資料流中接收帶外資料。
SO_RCVBUF int 接收緩衝區大小。
SO_REUSEADDR BOOL 套介面能和一個已在使用中的地址捆綁。
SO_SNDBUF int 發送緩衝區大小。
SO_TYPE int 套介面類型（如SOCK_STREAM）。
TCP_NODELAY BOOL 禁止發送合并的Nagle演算法。
getsockopt()不支援的BSD選項有：
選項名 類型 意義
SO_RCVLOWAT int 接收低級浮水印。
SO_RCVTIMEO int 接收逾時。
SO_SNDLOWAT int 發送低級浮水印。
SO_SNDTIMEO int 發送逾時。
IP_OPTIONS 擷取IP頭中選項。
TCP_MAXSEG int 擷取TCP最大段的長度。
用一個未被支援的選項去調用getsockopt()將會返回一個WSAENOPROTOOPT錯誤碼（可用WSAGetLastError()擷取）。
傳回值：
若無錯誤發生，getsockopt()返回0。否則的話，返回SOCKET_ERROR錯誤，應用程式可通過WSAGetLastError()擷取相應錯誤碼。
錯誤碼：
WSANOTINITIALISED：在使用此API之前應首先成功地調用WSAStartup()。
WSAENETDOWN：WINDOWS套介面實現檢測到網路子系統失效。
WSAEFAULT：optlen參數非法。
WSAEINPROGRESS：一個阻塞的WINDOWS套介面調用正在運行中。
WSAENOPROTOOPT：未知或不支援選項。其中，SOCK_STREAM類型的套介面不支援SO_BROADCAST選項，SOCK_DGRAM類型的套介面不支援SO_ACCEPTCONN、SO_DONTLINGER 、SO_KEEPALIVE、SO_LINGER和SO_OOBINLINE選項。
WSAENOTSOCK：描述字不是一個套介面。
參見：
setsockopt(), WSAAsyncSelect(), socket().
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()調用已執行。參見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 為接收確定緩衝區大小。。{最終緩衝區的大小還受限於linux系統的TCP/IP相關的參數配置}
SO_REUSEADDR BOOL 允許套介面和一個已在使用中的地址捆綁（參見bind()）。
SO_SNDBUF int 指定發送緩衝區大小。{最終緩衝區的大小還受限於linux系統的TCP/IP相關的參數配置}
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().
ioctlsocket()
簡述:
控制套介面的模式。
#include <winsock.h>
int PASCAL FAR ioctlsocket( SOCKET s, long cmd, u_long FAR* argp);
s：一個標識套介面的描述字。
cmd：對套介面s的操作命令。
argp：指向cmd命令所帶參數的指標。
注釋：
本函數可用於任一狀態的任一套介面。它用於擷取與套介面相關的巨集指令引數，而與具體協議或通訊子系統無關。支援下列命令：
FIONBIO：允許或禁止套介面s的非阻塞模式。argp指向一個無符號長整型。如允許非阻塞模式則非零，如禁止非阻塞模式則為零。當建立一個套介面時，它就處於阻塞模式（也就是說非阻塞模式被禁止）。這與BSD套介面是一致的。WSAAsynSelect()函數將套介面自動化佈建為非阻塞模式。如果已對一個套介面進行了WSAAsynSelect() 操作，則任何用ioctlsocket()來把套介面重新設定成阻塞模式的試圖將以WSAEINVAL失敗。為了把套介面重新設定成阻塞模式，應用程式必須首先用WSAAsynSelect()調用（IEvent參數置為0）來禁至WSAAsynSelect()。
FIONREAD：確定套介面s自動讀入的資料量。argp指向一個無符號長整型，其中存有ioctlsocket()的傳回值。如果s是SOCKET_STREAM類型，則FIONREAD返回在一次recv()中所接收的所有資料量。這通常與套介面中排隊的資料總量相同。如果S是SOCK_DGRAM 型，則FIONREAD返回套介面上排隊的第一個資料報大小。
SIOCATMARK：確實是否所有的帶外資料都已被讀入。這個命令僅適用於SOCK_STREAM類型的套介面，且該套介面已被設定為可以線上接收帶外資料（SO_OOBINLINE）。如無帶外資料等待讀入，則該操作返回TRUE真。否則的話返回FALSE假，下一個recv()或recvfrom()操作將檢索“標記”前一些或所有資料。應用程式可用SIOCATMARK操作來確定是否有資料剩下。如果在“緊急”（帶外）資料前有常規資料，則按序接收這些資料（請注意，recv()和recvfrom()操作不會在一次調用中混淆常規資料與帶外資料）。argp指向一個BOOL型數，ioctlsocket()在其中存入傳回值。
相容性：
本函數為Berkeley套介面函數ioctl()的一個子集。其中沒有與FIOASYNC等價的命令，SIOCATMARK是套介面層次支援的唯一命令。
傳回值：
成功後，ioctlsocket()返回0。否則的話，返回SOCKET_ERROR錯誤，應用程式可通過WSAGetLastError()擷取相應錯誤碼。
錯誤碼：
WSANOTINITIALISED：在使用此API之前應首先成功地調用WSAStartup()。
WSAENETDOWN：WINDOWS套介面實現檢測到網路子系統失效。
WSAEINVAL：cmd為非法命令，或者argp所指參數不適用於該cmd命令，或者該命令
不適用於此種類型的套介面。
WSAEINPROGRESS：一個阻塞的WINDOWS套介面調用正在運行中。
WSAENOTSOCK：描述字不是一個套介面。
參見：
socket(), setsockopt(), getsockopt(), WSAAsyncSelect(). |
|
fcntl 表標頭檔 #include<fcntl.h>
#include<fcntl.h>
定義函數 int fcntl(int fd , int cmd);
int fcntl(int fd,int cmd,long arg);
int fcntl(int fd,int cmd,struct flock * lock);
fcntl()用來操作檔案描述詞的一些特性。參數fd代表欲設定的檔案描述詞，參數cmd代表欲操作的指令。
有以下幾種情況:
F_DUPFD用來尋找大於或等於參數arg的最小且仍未使用的檔案描述詞，並且複製參數fd的檔案描述詞。執行成功則返回新複製的檔案描述詞。請參考dup2()。F_GETFD取得close-on-exec旗標。若此旗標的FD_CLOEXEC位為0，代表在調用exec()相關函數時檔案將不會關閉。
F_SETFD 設定close-on-exec 旗標。該旗標以參數arg 的FD_CLOEXEC位決定。
F_GETFL 取得檔案描述詞狀態旗標，此旗標為open（）的參數flags。
F_SETFL 設定檔案描述詞狀態旗標，參數arg為新旗標，但只允許O_APPEND、O_NONBLOCK和O_ASYNC位的改變，其他位的改變將不受影響。
F_GETLK 取得檔案鎖定的狀態。
F_SETLK 設定檔案鎖定的狀態。此時flcok 結構的l_type 值必須是F_RDLCK、F_WRLCK或F_UNLCK。如果無法建立鎖定，則返回-1，錯誤碼為EACCES 或EAGAIN。
F_SETLKW F_SETLK 作用相同，但是無法建立鎖定時，此調用會一直等到鎖定動作成功為止。若在等待鎖定的過程中被訊號中斷時，會立即返回-1，錯誤碼為EINTR。參數lock指標為flock 結構指標，定義如下
struct flcok
{
short int l_type;
short int l_whence;
off_t l_start;
off_t l_len;
pid_t l_pid;
};
l_type 有三種狀態:
F_RDLCK 建立一個供讀取用的鎖定
F_WRLCK 建立一個供寫入用的鎖定
F_UNLCK 刪除之前建立的鎖定
l_whence 也有三種方式:
SEEK_SET 以檔案開頭為鎖定的起始位置。
SEEK_CUR 以目前檔案讀寫位置為鎖定的起始位置
SEEK_END 以檔案結尾為鎖定的起始位置。
傳回值 成功則返回0，若有錯誤則返回-1，錯誤原因存於errno. |
設定/讀取socket sendbuf len:
#include <sys/types.h>
#include <sys/socket.h>
#include <stdio.h>
#include <unistd.h>
int main()
{
int s = 0;
int optval;
socklen_t optlen = sizeof(int);
if((s = socket(AF_INET,SOCK_STREAM,0))<0) perror("socket");
getsockopt(s, SOL_SOCKET, SO_SNDBUF, &optval, &optlen);
printf("optlen = %d/n, optval = %d/n", optlen, optval);
int len=164*1024;
setsockopt(s,SOL_SOCKET,SO_SNDBUF,(char *)&len,sizeof(len));
getsockopt(s, SOL_SOCKET, SO_SNDBUF, &optval, &optlen);
printf("optlen = %d/n, optval = %d/n", optlen, optval);
close(s);
return 0;
}
