Winsock编程宝典(转帖)
--簡單的 Winsock 應(yīng)用程式設(shè)計
TCP連接建立與關(guān)閉
相信各位讀者現(xiàn)在對於 Winsock 的定義、系統(tǒng)環(huán)境,以及一些 Winsock Stack及 Winsock 應(yīng)用程式,都有基本的認識了。接下來筆者希望能分幾期為各位讀者介紹一下簡單的 Winsock 網(wǎng)路應(yīng)用程式設(shè)計。我們將以 Winsock 1.1 規(guī)格所定義的 46 個應(yīng)用程式介面(API)為基礎(chǔ),逐步來建立一對 TCP socket 主從架構(gòu)(Client / Server)的程式。在這兩個程式中,Server 將使用 Winsock 提供的「非同步」(asynchronous)函式來建立 socket 連結(jié)、關(guān)閉、及資料收送等等;而 Client 則采類似傳統(tǒng) UNIX 的「阻攔式」(blocking)。由於我們的重點并不在於 MS Windows SDK 的程式設(shè)計,所以我們將使用最簡便的方式來顯示訊息;有關(guān) MS Windows 程式的技巧,請各位讀者自行研究相關(guān)的書籍及文章。
今天我們先要看一下主從架構(gòu) TCP socket 的建立連結(jié)(connect)及關(guān)閉(close)。以前筆者曾簡單地介紹過主從架構(gòu)的概念,現(xiàn)在我們再以生活上更淺顯的例子來說明一下,讀者稍後也較容易能明白筆者的敘述。我們可以假設(shè) Server 就像是電信局所提供的一些服務(wù),比如「104 查號臺」或「112 障礙臺」。
(1)電信局先建立好了一個電話總機,這就像是呼叫 socket() 函式開啟了一個 socket。
(2)接著電信局將這個總機的號碼定為 104,就如同我們呼叫 bind() 函式,將 Server 的這個 socket 指定(bind)在某一個 port。當(dāng)然電信局必須讓用戶知道這個號碼;而我們的 Client 程式同樣也要知道 Server 所用的 port,待會才有辦法與之連接。
(3)電信局的 104 查號臺底下會有一些自動服務(wù)的分機,但是它的數(shù)量是有限的,所以有時你會撥不通這個號碼(忙線)。同樣地,我們在建立一個 TCP 的Server socket 時,也會呼叫 listen() 函式來監(jiān)聽等待;listen() 的第二個參數(shù)即是 waiting queue 的數(shù)目,通常數(shù)值是由 1 到 5。(事實上這兩者還是有點不一樣。)
(4)用戶知道了電信局的這個 104 查號服務(wù),他就可以利用某個電話來撥號連接這個服務(wù)了。這就是我們 Client 程式開啟一個相同的 TCP socket,然後呼叫 connect() 函式去連接 Server 指定的那個 port。當(dāng)然了,和電話一樣,如果 waiting queue 滿了、與 Server 間線路不通、或是 Server 沒提供此項服務(wù)時,你的連接就會失敗。
(5)電信局查號臺的總機接受了這通查詢的電話後,它會轉(zhuǎn)到另一個分機做服務(wù),而總機本身則再回到等待的狀態(tài)。Server 的 listening socket 亦是一樣,當(dāng)你呼叫了 accept() 函式之後,Server 端的系統(tǒng)會建立一個新的 socket 來對此連接做服務(wù),而原先的 socket 則再回到監(jiān)聽等待的狀態(tài)。
(6)當(dāng)你查詢完畢了,你就可以掛上電話,彼此間也就離線了。Client和Server間的 socket 關(guān)閉亦是如此;不過這個關(guān)閉離線的動作,可由 Client 端或Server 端任一方先關(guān)閉。有些電話查詢系統(tǒng)不也是如此嗎?
接下來,我們就來看主從架構(gòu)的 TCP socket 是如何利用這些 Winsock 函式來達成的;并利用資策會資訊技術(shù)處的「WinKing」這個 Winsock Stack 中某項功能來顯示 sockets 狀態(tài)的變化。文章中僅列出程式的片段,完整的程式請看附錄的程式。
Server進入監(jiān)聽狀態(tài)
首先我們先看 Server 端如何建立一個 TCP socket,并使其進入監(jiān)聽等待的狀態(tài)。在圖 1. 上,我們可以看到最先被呼叫到的是 WSAStartup() 函式。
WSAStartup
格 式: int PASCAL FAR WSAStartup( WORD wVersionRequested, LPWSADATA lpWSAData );
參 數(shù): wVersionRequested 欲使用的 Windows Sockets API 版本
lpWSAData 指向 WSADATA 資料的指標(biāo)
傳回值: 成功 – 0
失敗 - WSASYSNOTREADY / WSAVERNOTSUPPORTED / WSAEINVAL
說明: 此函式「必須」是應(yīng)用程式呼叫到 Windows Sockets DLL 函式中的第一個,也唯有此函式呼叫成功後,才可以再呼叫其他 Windows Sockets DLL 的函式。此函式亦讓使用者可以指定要使用的 Windows Sockets API 版本,及獲取設(shè)計者的一些資訊。程式中我們要用 Winsock 1.1,所以我們在程式中有一段為:
WSAStartup((WORD)((1<<8)|1),(LPWSADATA) &WSAData)
其中 ((WORD)((1<<8)|1) 表示我們要用的是 Winsock 「1.1」版本,而WSAData 則是用來儲存由系統(tǒng)傳回的一些有關(guān)此一 Winsock Stack 的資料。
socket
再來我們呼叫 socket() 函式來開啟 Server 端的 TCP socket。 socket():建立Socket。
格 式: SOCKET PASCAL FAR socket( int af, int type, int protocol );
參 數(shù): af 目前只提供 PF_INET(AF_INET)
type Socket 的型態(tài) (SOCK_STREAM、SOCK_DGRAM)
protocol 通訊協(xié)定(如果使用者不指定則設(shè)為0)
傳回值: 成功 - Socket 的識別碼
失敗 - INVALID_SOCKET(呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來建立一 Socket,并為此 Socket 建立其所使用的資源。Socket 的型態(tài)可為 Stream Socket 或 Datagram Socket。我們要建立的是 TCP socket,所以程式中我們的第二個參數(shù)為SOCK_STREAM,我們并將開啟的這個 socket 號碼記在 listen_sd 這個變數(shù)。
listen_sd = socket(PF_INET, SOCK_STREAM, 0)
bind
接下來我們要指定一個位址及 port 給 Server 的這個 socket,這樣 Client 才知道待會要連接哪一個位址的哪個 port;所以我們呼叫 bind() 函式。
bind():指定 Socket 的 Local 位址 (Address)。
格式:
int PASCAL FAR bind( SOCKET s, const struct sockaddr FAR *name,int namelen );
參數(shù):
s: Socket的識別碼
name: Socket的位址值
namelen: name的長度
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此一函式是指定 Local 位址及 Port 給某一未定名之 Socket。使用者若不在意位址或 Port 的值,那麼他可以設(shè)定位址為 INADDR_ANY,及 Port 為 0;那麼Windows Sockets 會自動將其設(shè)定適當(dāng)之位址及 Port (1024 到 5000之間的值),使用者可以在此 Socket 真正連接完成後,呼叫 getsockname() 來獲知其被設(shè)定的值。bind() 函式要指定位址及 port,這個位址必須是執(zhí)行這個程式所在機器的 IP位址,所以如果讀者在設(shè)計程式時可以將位址設(shè)定為 INADDR_ANY,這樣Winsock 系統(tǒng)會自動將機器正確的位址填入。如果您要讓程式只能在某臺機器上執(zhí)行的話,那麼就將位址設(shè)定為該臺機器的 IP 位址。由於此端是 Server 端,所以我們一定要指定一個 port 號碼給這個 socket。讀者必須注意一點,TCP socket 一旦選定了一個位址及 port 後,就無法再呼叫另一次 bind 來任意更改它的位址或 port。在程式中我們將 Server 端的 port 指定為 7016,位址則由系統(tǒng)來設(shè)定。
struct sockaddr_in sa;
sa.sin_family = PF_INET;
sa.sin_port = htons(7016); //port number
sa.sin_addr.s_addr = INADDR_ANY;//address
bind(listen_sd, (struct sockaddr far *)&sa, sizeof(sa))
我們在指定 port 號碼時會用到 htons() 這個函式,主要是因為各機器的數(shù)值讀取方式不同(PC與UNIX系統(tǒng)即不相同),所以我們利用這個函式來將 host order 的排列方式轉(zhuǎn)換成 network order 的排列方式;相同地,我們也可以呼叫ntohs() 這個相對的函式將其還原。
host order各機器不同,但network order都相同;htons是針對short數(shù)值,對於long數(shù)值則用hotnl及ntohl。
listen
指定完位址及 port 之後,我們呼叫 listen() 函式,讓這個 socket 進入監(jiān)聽狀態(tài)。一個 Server 端的 TCP socket 必須在做完了 listen 的呼叫後,才能接受 Client 端的連接。
格式:
int PASCAL FAR listen( SOCKET s, int backlog );
參數(shù):
s: Socket 的識別碼
backlog: 未真正完成連接前(尚未呼叫 accept 前)彼端的連接要求的最大個數(shù)
傳回值:
成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 使用者可利用此函式來設(shè)定 Socket 進入監(jiān)聽狀態(tài),并設(shè)定最多可有多少個在未真正完成連接前的彼端的連接要求。(目前最大值限制為 5, 最小值為1)程式中我們將 backlog 設(shè)為 1 。
listen(listen_sd, 1)
呼叫完 listen 後,此時 Client 端如果來連接的話,Client 端的連接動作(connect)會成功,不過此時 Server 端必須再呼叫 accept() 函式,才算正式完成Server 端的連接動作。但是我們什麼時候可以知道 Client 端來連接,而適時地呼叫 accept 呢?在這里我們就要利用 WSAAsyncSelect 函式,將Server 端的這個 socket 轉(zhuǎn)變成 Asynchronous 模式,讓系統(tǒng)主動來通知我們有Client 要連接了。
WSAAsyncSelect
格式:
int PASCAL FAR WSAAsyncSelect( SOCKET s, HWND hWnd, unsigned int wMsg, long lEvent );
參數(shù):
s: Socket 的編號
hWnd: 動作完成後,接受訊息的視窗 handle
wMsg: 傳回視窗的訊息
lEvent: 應(yīng)用程式有興趣的網(wǎng)路事件
傳回值:
成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明:此函式是讓使用者用來要求 Windows Sockets DLL 在偵測到某一 Socket有網(wǎng)路事件時送訊息到使用者指定的視窗;網(wǎng)路事件是由參數(shù) lEvent 設(shè)定。呼叫此函式會主動將該 Socket 設(shè)定為 Non-blocking 模式。lEvent 的值可為以下之「OR」組合:(參見 WINSOCK第1.1版88、89頁) FD_READ、FD_WRITE、FD_OOB、FD_ACCEPT、FD_CONNECT、FD_CLOSE 使用者若是針對某一Socket再次呼叫此函式時,會取消對該 Socket 原先之設(shè)定。若要取消對該Socket 的所有設(shè)定,則 lEvent 的值必須設(shè)為 0。我們在程式中要求 Winsock 系統(tǒng)知道 Client 要來連接時,送一個ASYNC_EVENT 的訊息到程式中 hwnd 這個視窗;由於我們想知道的只有 accept事件,所以我們只設(shè)定 FD_ACCEPT。
WSAAsyncSelect(listen_sd, hwnd, ASYNC_EVENT, FD_ACCEPT)
讀者必須注意一點,WSAAsyncSelect 的設(shè)定是針對「某一個 socket」;也就是說,只有當(dāng)您設(shè)定的這個 socket (listen_sd)的那些事件(FD_ACCEPT)發(fā)生時,您才會收到這個訊息(ASYNC_EVENT)。如果您開啟了很多 sockets,而要讓每個 socket 都變成 asynchronous 模式的話,那麼就必須對「每一個 socket」都呼叫 WSAAsyncSelect 來一一設(shè)定。而如果您想將某一個 socket 的 async 事件通知設(shè)定取消的話,那麼同樣也是用 WSAAsyncSelect 這個函式;且第四個參數(shù)lEvent 一定要設(shè)為 0。
WSAAsyncSelect( s, hWnd, 0, 0 ) -- 取消所有 async 事件設(shè)定
呼叫 WSAAsyncSelect 的同時也將此socket改變成「非阻攔」(non-blocking)模式。但是此時這個 socket 不能很簡單地用 ioctlsocket() 這個函式就將它再變回「阻攔」(blocking)模式。也就是說WSAAsyncSelect 和 ioctlsocket 所改變的「非阻攔」模式仍是有些不同的。如果您想將一個「非同步」(asynchronous)模式的 socket 再變回「阻攔」模式的話,必須先呼叫 WSAAsyncSelect() 將所有的 async 事件取消,再用 ioctlsocket() 將它變回阻攔模式。
ioctlsocket
ioctlsocket():控制 Socket 的模式。
格 式: int PASCAL FAR ioctlsocket( SOCKET s, long cmd, u_long FAR * argP );
參 數(shù): s Socket 的識別碼
cmd 指令名稱
argP 指向 cmd 參數(shù)的指標(biāo)
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來獲取或設(shè)定 Socket 的運作參數(shù)。其所提供的指令有:(參見WINSOCK 第 1.1 版 35、36 頁) cmd 的值可為:
FIONBIO -- 開關(guān) non-blocking 模式//允許或禁止套接字的非阻塞模式,允許為非0,禁止為0
FIONREAD -- 自Socket一次可讀取的資料量(目前 in buffer 的資料量//確定套接字自動讀入的數(shù)據(jù)量
SIOCATMARK -- OOB 資料是否已被讀取完//確定是否所有帶外數(shù)據(jù)都已被讀入
由於我們 Server 端的 socket 是用非同步模式,且設(shè)定了 FD_ACCEPT 事件,所以當(dāng) Client 端和我們連接時,Winsock Stack 會主動通知我們;我們再先來看看Client 端要如何和 Server 端建立連接?
Client主動建立連接
Client 首先也是呼叫 WSAStartup() 函式來與 Winsock Stack 建立關(guān)系;然後同樣呼叫 socket() 來建立一個 TCP socket。(讀者此時一定要用 TCP socket 來連接Server 端的 TCP socket,而不能用 UDP socket 來連接;因為相同協(xié)定的 sockets 才能相通,TCP 對 TCP,UDP 對 UDP)和 Server 端的 socket 不同的地方是:Client 端的 socket 可以呼叫 bind()函式,由自己來指定 IP 位址及 port 號碼;但是也可以不呼叫 bind(),而由 Winsock Stack來自動設(shè)定 IP 位址及 port 號碼(此一動作在呼叫 connect() 函式時會由 Winsock 系統(tǒng)來完成)。通常我們是不呼叫 bind(),而由系統(tǒng)設(shè)定的,稍後可呼叫g(shù)etsockname() 函式來檢查系統(tǒng)幫我們設(shè)定了什麼 IP 及 port。一般言,系統(tǒng)會自動幫我們設(shè)定的 port 號碼是在 1024 到 5000 之間;而如果讀者要自己用 bind設(shè)定 port的話,最好是 5000 以上的號碼。
connect():要求連接某一 TCP Socket 到指定的對方。
格 式: int PASCAL FAR connect( SOCKET s, const struct sockaddr FAR *name, int namelen );
參 數(shù): s Socket 的識別碼
name 此 Socket 想要連接的對方位址
namelen name的長度
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫WSAGetLastError()可得知原因)
說明: 此函式用來向?qū)Ψ揭蠼⑦B接。若是指定的對方位址為 0 的話,會傳回錯誤值。當(dāng)連接建立完成後,使用者即可利用此一 Socket 來做傳送或接收資料之用了。
我們的例子中, Client 是要連接的是自己機器上 Server 所監(jiān)聽的 7016 這個port,所以我們有以下的程式片段。(假設(shè)我們機器的 IP 存在my_host_ip)
struct sockaddr_in sa; /* 變數(shù)宣告 */
sa.sin_family = PF_INET; /* 設(shè)定所要連接的 Server 端資料 */
sa.sin_port = htons(7016);
sa.sin_addr.s_addr = htonl(my_host_ip);
connect(mysd, (struct sockaddr far *)&sa, sizeof(sa)) /* 建立連接 */
Server接受連接
由於我們 Server 端的 socket 是設(shè)定為「非同步模式」,且是針對 FD_ACCEPT這個事件,所以當(dāng) Client 來連接時,我們 Server 端的 hwnd 這個視窗會收到Winsock Stack 送來的一個 ASYNC_EVENT 的訊息。(參見前面 WSAAsyncSelect 的設(shè)定)這時,我們應(yīng)該先利用 WSAGETSELECTERROR(lParam) 來檢查是否有錯誤;并由 WSAGETSELECTEVENT(lParam) 得知是什麼事件發(fā)生(因為WSAAsyncSelect 函式可針對同一個 socket 同時設(shè)定很多事件,但是只用一個訊息來代表)(此處當(dāng)然是 FD_ACCEPT 事件);然後再呼叫相關(guān)的函式來處理此一事件。所以我們呼叫 accept() 函式來建立 Server 端的連接。
accept():接受某一 Socket 的連接要求,以完成 Stream Socket 的連接。
格 式: SOCKET PASCAL FAR accept( SCOKET s, struct sockaddr FAR *addr, int FAR *addrlen );
參 數(shù): s Socket的識別碼
addr 存放來連接的彼端的位址
addrlen addr的長度
傳回值:成功 - 新的Socket識別碼
失敗 - INVALID_SOCKET (呼叫 WSAGetLastError() 可得知原因)
說明: Server 端之應(yīng)用程式呼叫此一函式來接受 Client 端要求之 Socket 連接動作;如果Server 端之 Socket 是為 Blocking 模式,且沒有人要求連接動作,那麼此一函式會被 Block 住;如果為 Non-Blocking 模式,此函式會馬上回覆錯誤。accept()函式的答覆值為一新的 Socket,此新建之 Socket 不可再用來接受其它的連接要求;但是原先監(jiān)聽之 Socket 仍可接受其他人的連接要求。
TCP socket 的 Server 端在呼叫 accept() 後,會傳回一個新的 socket 號碼;而這個新的 socket 號碼才是真正與 Client 端相通的 socket。比如說,我們用socket() 建立了一個 TCP socket,而此 socket 的號碼(系統(tǒng)給的)為 1,然後我們呼叫的bind()、listen()、accept() 都是針對此一 socket;當(dāng)我們在呼叫 accept()後,傳回值是另一個 socket 號碼(也是系統(tǒng)給的),比如說 3;那麼真正與 Client 端連接的是號碼 3 這個 socket,我們收送資料也都是要利用 socket 3,而不是 socket 1;讀者不可搞錯。我們在程式中對 accept() 的呼叫如下;我們并可由第二個參數(shù)的傳回值,得知究竟是哪一個 IP 位址及 port 號碼的 Client 與我們 Server 連接。
struct sockaddr_in sa;
int sa_len = sizeof(sa);
my_sd = accept(listen_sd, (struct sockaddr far *)&sa, &sa_len)
當(dāng) Server 端呼叫完 accept() 後,主從架構(gòu)的 TCP socket 連接才算真正建立完畢; Server 及 Client 端也就可以分別利用此一 socket 來送資料到對方或收對方送來的資料了。
Server/Client結(jié)束連接
最後我們來看一下如何結(jié)束 socket 的連接。socket 的關(guān)閉很簡單,而且可由Server 或 Client 的任一端先啟動,只要呼叫 closesocket() 就可以了。而要關(guān)閉監(jiān)聽狀態(tài)的 socket,同樣也是利用此一函式。
closesocket():關(guān)閉某一Socket。
格 式: int PASCAL FAR closesocket( SOCKET s );
參 數(shù): s Socket 的識別碼
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此一函式是用來關(guān)閉某一 Socket。若是使用者原先對要關(guān)閉之 Socket 設(shè)定 SO_DONTLINGER,則在呼叫此一函式後,會馬上回覆,但是此一 Sokcet 尚未傳送完畢的資料會繼續(xù)送完後才關(guān)閉。若是使用者原先設(shè)定此 Socket 為 SO_LINGER,則有兩種情況:
(a) Timeout 設(shè)為 0 的話,此一 Socket 馬上重新設(shè)定 (reset),未傳完或未收到的資料全部遺失。
(b) Timeout 不為 0 的話,則會將資料送完,或是等到 Timeout 發(fā)生後才真正關(guān)閉。
程式結(jié)束前,讀者們可千萬別忘了要呼叫 WSACleanup() 來通知 WinsockStack;如果您不呼叫此一函式,Winsock Stack 中有些資源可能仍會被您占用而無法清除釋放喲。
WSACleanup():結(jié)束 Windows Sockets DLL 的使用。
格 式: int PASCAL FAR WSACleanup( void );
參 數(shù): 無
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 應(yīng)用程式在使用 Windows Sockets DLL 時必須先呼叫WSAStartup() 來向 Windows Sockets DLL 注冊;當(dāng)應(yīng)用程式不再需要使用Windows Sockets DLL 時,須呼叫此一函式來注銷使用,以便釋放其占用的資源。
結(jié)語
這期筆者先介紹主從架構(gòu) TCP sockets 的連接及關(guān)閉,以後會再陸續(xù)介紹如何收送資料,以及其他 API 的使用。想要進一步了解如何撰寫 Winsock 程式的讀者,可以好好研究一下筆者 demoserv 及 democlnt 這兩個程式;也許不是寫的很好,但是希望可以帶給不懂 Winsock 程式設(shè)計的人一個起步。讀者們亦可自行用 anonymous ftp 方式到 SEEDNET 臺北主機 tpts1.seed.net. tw(139.175.1.10)的 UPLOAD / WINKING 目錄下,取得筆者與陳建伶小姐所設(shè)計的WinKing 這個 Winsock Stack 的試用版,來跑 demoserv 與 democlnt 這兩個程式及其他許許多多的 Winsock 應(yīng)用程式。(正式版本請洽 SEEDNET 服務(wù)中心,新版的WinKing 已含 Windows 撥接及 PPP 程式,適合電話撥接用戶在 Windows 環(huán)境下用 SEEDNET;WinKing 同樣也提供 Ethernet 環(huán)境的使用。)
收送資料
在前一期的文章中,筆者為大家介紹了如何在 Winsock 環(huán)境下建立主從架構(gòu)(Client/Server)的 TCP socket 的連接建立與關(guān)閉;今天筆者將繼續(xù)為大家介紹如何利用 TCP socket 來收送資料,并詳細解說 WSAAsyncSelect 函式中的FD_READ 及 FD_WRITE 事件。相信讀者們已經(jīng)知道 TCP socket 的連接是在 Client 端呼叫 connect 函式成功,且 Server 端呼叫 accept 函式後,才算完全建立成功;當(dāng)連接建立成功後, Client 及 Server 也就可以利用這個連接成功的 socket 來傳送資料到對方,或是收取對方送過來的資料了。在介紹資料的收送前,筆者先介紹一下 TCP socket 與 UDP socket 在傳送資料時的特性:
2 Stream (TCP) Socket 提供「雙向」、「可靠」、「有次序」、「不重覆」之資料傳送。
2 Datagram (UDP) Socket 則提供「雙向」之溝通,但沒有「可靠」、「有次序」、「不重覆」等之保證;所以使用者可能會收到無次序、重覆之資料,甚至資料在傳輸過程中也可能會遺漏。由於 UDP Socket 在傳送資料時,并不保證資料能完整地送達對方,所以我們常用的一些應(yīng)用程式(如 telnet、mail、ftp、news...等)都是采用 TCP Socket,以保證資料的正確性。
TCP 及 UDP Socket 都是雙向的,所以我們是利用同一個 Socket 來做傳送及收取資料的動作;一般言 TCP Socket 的資料送、收是呼叫 send 及 recv這兩個函式來達成,而 UDP Socket 則是用 sendto 及 recvfrom 這兩個函式。不過TCP Socket 也可用 sendto 及 recvfrom 函式,UDP Socket 同樣可用 send 及recv 函式;這一點我們稍後再加以解釋。現(xiàn)在我們先看一下 send 及 recv 的函式說明,并回到我們的前一期程式。
◎ send():使用連接式(connected)的 Socket 傳送資料。
格 式: int PASCAL FAR send( SOCKET s, const char FAR *buf, int len, int flags );
參 數(shù): s Socket 的識別碼
buf 存放要傳送的資料的暫存區(qū)
len buf 的長度
flags 此函式被呼叫的方式
傳回值:成功 - 送出的資料長度
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式適用於連接式的 Datagram 或 Stream Socket 來傳送資料。 對Datagram Socket 言,若是 datagram 的大小超過限制,則將不會送出任何資料,并會傳回錯誤值。對 Stream Socket 言,Blocking 模式下,若是傳送 (transport) 系統(tǒng)內(nèi)之儲存空間(output buffer)不夠存放這些要傳送的資料,send 將會被 block住,直到資料送完為止;如果該 Socket 被設(shè)定為 Non-Blocking 模式,那麼將視目前的 output buffer 空間有多少,就送出多少資料,并不會被 block 住。使用者亦須注意 send 函式執(zhí)行完成,并不表示資料已經(jīng)成功地送抵對方了,而是已經(jīng)放到系統(tǒng)的 output buffer 中等待被送出。flags 的值可設(shè)為 0 或 MSG_DONTROUTE及 MSG_OOB 的組合。(參見 WINSOCK第1.1版48頁)
◎ recv():自 Socket 接收資料。
格 式: int PASCAL FAR recv( SOCKET s, char FAR *buf, int len, int flags );
參 數(shù): s Socket 的識別碼
buf 存放接收到的資料的暫存區(qū)
len buf 的長度
flags 此函式被呼叫的方式
傳回值:成功 - 接收到的資料長度 (若對方 Socket 已關(guān)閉,則為 0)
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來自連接式的 Datagram Socket 或 Stream Socket 接收資料。對 Stream Socket 言,我們可以接收到目前 input buffer 內(nèi)有效的資料,但其數(shù)量不超過 len 的大小。若是此 Socket 設(shè)定 SO_OOBINLINE,且有 out-of-band 的資料未被讀取,那麼只有 out-of-band 的資料被取出。對 Datagram Socket 言,只取出第一個 datagram;若是該 datagram 大於使用者提供的儲存空間,那麼只有該空間大小的資料被取出,多馀的資料將遺失,且回覆錯誤的訊息。另外如果 Socket為 Blocking 模式,且目前 input buffer 內(nèi)沒有任何資料,則 recv() 將 block 到有任何資料到達為止;如果為 Non-Blocking 模式,且 input buffer 無任何資料,則會馬上回覆錯誤。參數(shù) flags 的值可為 0 或 MSG_PEEK、MSG_OOB 的組合; MSG_PEEK 代表將資料拷貝到使用者提供的 buffer,但是資料并不從系統(tǒng)的 input buffer 中移走;0 則表示拷貝并移走。(參考 WINSOCK 第1.1版41 頁)
Server收送及關(guān)閉Socket
在前一期中,建立的是一個 Asynchronous 模式的 Server,曾對listen_sd Socket呼叫 WSAAsyncSelect 函式,并設(shè)定FD_ACCEPT 事件,所以當(dāng) Client 與我們連接時,系統(tǒng)會傳給我們一個ASYNC_EVENT 訊息;我們在收到訊息并判斷是FD_ACCEPT 事件,於是呼叫 accept() 來建立連接。
my_sd = accept(listen_sd, (struct sockaddr far *)&sa, &sa_len)
在呼叫完 accept 函式,成功地建立了 Server 端與 Client 端的連接後,便可利用新建的 Socket(my_sd)來收送資料了。由於我們同樣希望用Asynchronous 的方式,因此要再利用 WSAAsyncSelect() 函式來幫新建的Socket 設(shè)定一些事件,以便事件發(fā)生時 Winsock Stack 能主動通知我們。由於我們的 Server 是被動的接受 Client 的要求,然後再做答覆,所以我們設(shè)定FD_READ 事件;我們也希望 Winsock Stack 在知道 Client 關(guān)閉 Socket 時,能主動通知我們,所以同時也設(shè)定 FD_CLOSE 事件。(讀者須注意,我們設(shè)定事件的 Socket 號碼是呼叫 accept 後傳回的新 Socket 號碼,而不是原先監(jiān)聽狀態(tài)的Socket 號碼)
WSAAsyncSelect(my_sd, hwnd, ASYNC_EVENT, FD_READ|FD_CLOSE)
在這里,我們同樣是利用 hwnd 這個視窗及 ASYNC_EVENT 這個訊息;在前文中,筆者曾告訴各位,在收到 ASYNC_EVENT 訊息時,我們可以利用WSAGETSELECTEVENT(lParam) 來判斷究竟是哪一事件(FD_READ 或FD_CLOSE)發(fā)生了;所以并不會混淆。那我們到底在什麼時候會收到FD_READ 或 FD_CLOSE 事件的訊息呢?
FD_READ 事件
我們會收到 FD_READ 事件通知我們?nèi)プx取資料的情況有:
(1)呼叫 WSAAsyncSelect 函式來對此 Socket 設(shè)定 FD_READ 事件時,input buffer 中已有資料。
(2)原先系統(tǒng)的 input buffer 是空的,當(dāng)系統(tǒng)再收到資料時,會通知我們。
(3)使用者呼叫 recv 或 recvfrom 函式,從 input buffer 讀取資料,但是并沒有一次將資料讀光,此時會再驅(qū)動一個 FD_READ 事件,表示仍有資料在input buffer 中。
讀者必須注意:如果我們收到 FD_READ 事件通知的訊息,但是我們故意不呼叫 recv 或 recvfrom 來讀取資料的話,爾後系統(tǒng)又收到資料時,并不會再次通知我們,一定要等我們呼叫了 recv 或 recvfrom 後,才有可能再收到FD_READ 的事件通知。
FD_CLOSE 事件
當(dāng)系統(tǒng)知道對方已經(jīng)將Socket關(guān)閉了的情況下(收到 FIN 通知,并和對方做關(guān)閉動作的 hand-shaking),我們會收到 FD_CLOSE 的事件通知,以便我們也能將這個相對的 Socket 關(guān)閉。FD_CLOSE 事件只會發(fā)生於 TCP Socket,因為它是 connection-oriented;對於 connectionless 的 UDP Socket,即使設(shè)了FD_CLOSE,也不會有作用的。
程式中,當(dāng) Client 端送一個要求(request)來時,系統(tǒng)會以ASYNC_EVENT 訊息通知我們的 hwnd 視窗;我們在利用WSAGETSELECTEVENT(lParam) 及 WSAGETSELECTERROR(lParam) 知道是FD_READ 事件及檢查無誤後,便呼叫 recv() 函式來收取 Client 端送來的資料。
recv(wParam, &data, sizeof(data), 0)
筆者在前一期文章中也曾提到說,FD_XXXX 事件發(fā)生,收到訊息時,視窗 handle 被呼叫時的參數(shù) wParam 代表的就是事件發(fā)生的 Socket 號碼,所以此處 wParam 的值也就是前面提到的 my_sd 這個 Socket 號碼。recv() 的第四個參數(shù)設(shè)為 0,表示我們要將資料從系統(tǒng)的 input buffer 中讀取并移走。收到要求後,我們要答覆 Client 端,也就是要送資料給 Client;這時我們就要利用 send 這個函式了。我們先將資料放到 data 這個資料暫存區(qū),然後呼叫 send 將它送出,我們利用的也是 wParam(my_sd) 這個同樣的 Socket 來做傳送的動作,因為它是雙向的。
send(wParam, &data, strlen(data), 0)
Server 與 Client 收送資料一段時間後(資料全部收送完畢),如果 Client 端先呼叫 closesocket 將它那端的 Socket 關(guān)閉,那麼系統(tǒng)在知道後,會通知我們一個 FD_CLOSE 事件的訊息,此時我們也可以呼叫 closesocket 將我們這端的Socket 關(guān)閉了;當(dāng)然我們也可以呼叫 closesocket 先主動關(guān)閉我們這端的Socket。
Client收送及關(guān)閉Socket
我們例子的 Client 是采 Blocking 模式,所以在呼叫 connect() 函式與 Server連接時,可能會等一下子才成功;connect() 函式返回後,且無錯誤發(fā)生的話,Client 與 Server 端的 TCP socket 連接就算成功了。這時,我們便可利用這個連接成功的 Socket 來送收資料了。由於我們并沒有要設(shè)定為 Asynchronous 模式,所以也不用呼叫 WSAAsyncSelect() 來設(shè)定事件。Client 端通常是會先主動發(fā)出要求到 Server 端,因此我們呼叫 send() 來傳送此一資料。我們的資料量很小,所以并不會被 send() 函式 Block 住;不過如果您要送的資料量很大,那麼可能會等一段時間才會自 send() 函式返回;也就是說必須等資料都放到系統(tǒng)的 output buffer 後才會返回;這是因為我們 Client的Socket 是阻攔模式。如果我們用的是非阻攔模式的 Socket,那麼 send() 函式會視系統(tǒng)的 output buffer 的空間有多少,只拷貝那麼多的資料到 output buffer,然後就返回,并告知使用者送出了多少資料,并不須等所有資料都放到 output buffer 才返回。我們將要求放在 data 資料暫存區(qū),然後呼叫 send() 將要求送出。資料送出後,我們呼叫 recv() 來等待 Server 端的答覆。
send(mysd, data, strlen(data), 0)
recv(mysd, &data, sizeof(data), 0)
由於我們 Client 端是 Blocking 模式,所以 recv() 會一直 Block 住,直到下列的情況之一發(fā)生,才會返回。
(1)Server 端送來資料。(此時 return 值是讀取的資料長度)
(2)Server 端將相對的 Socket 關(guān)閉了。(此時的 return 值會是 0)
(3)Client 端自己呼叫 WSACancelBlockingCall() 來取消 recv() 的呼叫。(此時 return 值是 SOCKET_ERROR 錯誤,錯誤碼 10004 WSAEINTR)
同樣地,資料全部送收完畢後,我們也呼叫 closesocket() 來將 Socket 關(guān)閉。
◎ WSACancelBlockingCall():取消目前正在進行中的 blocking 動作。
格式: int PASCAL FAR WSACancelBlockingCall( void );
參數(shù): 無
傳回值:成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來取消該應(yīng)用程式正在進行中的 blocking 動作。通常的使用時機有:(a) Blocking 動作正在進行中,該應(yīng)用程式又收到某一訊息(Mouse、Keyboard、Timer 等),則可在處理該訊息的段落中呼叫此函式。(b) Blocking 動作正在進行中,而 Windows Sockets 又呼叫回應(yīng)用程式的「blocking hook」函式時,在該函式內(nèi)可呼叫此函式來取消 blocking 動作。
使用者必須注意,在某一 Winsock blocking 函式動作進行時,除了WSAIsBlocking() 及 WSACancelBlockingCall() 外,不可以再呼叫其它任何Windows Sockets DLL 提供的函式,否則會產(chǎn)生錯誤。另外若取消的blocking 動作不是 accept() 或 select() 的話,那麼該 Socket 可能會處於未定狀態(tài),使用者最好是呼叫 closesocket() 來關(guān)閉該 Socket,而不該再對它做任何動作。
介紹完了 TCP Socket 的資料收送,筆者接著為讀者介紹 sendto() 及recvfrom() 這兩個函式,以及許多人可能很容易搞錯的 FD_WRITE 事件。
sendto及recvfrom
一般言,TCP Socket 使用的是 send() 及 recv() 這兩個函式;而 UDP Socket用的是 sendto() 及 recvfrom() 函式。這是因為 TCP 是 Connection-oriented,必須做完 Socket 真正的連接程序後,才可以開始收送資料,此時系統(tǒng)已經(jīng)知道了連接的對方,所以我們不用再指定資料要送到哪里。而 UDP 是 Connectionless,收送資料的雙方并沒有建立真正的連接,所以我們要利用 sendto() 及 recvfrom()來指定收資料的對方及獲知是誰送資料給我們。TCP Socket 也可以用 sendto() 及 recvfrom() 來送收資料,只是此時這兩個函式的最後兩個參數(shù)沒有作用,會被系統(tǒng)所忽略。而 UDP Socket 如果呼叫了connect() 函式來指定對方的位址(這個 connect 并不會真的和對方做連接的動作,而是告知我們本身的系統(tǒng)說我們只想收、送何方的資料),那麼也可以利用 send() 及 recv() 來送收資料。
◎ sendto():將資料送到使用者指定的目的地。
格 式: int PASCAL FAR sendto( SOCKET s, const char FAR *buf, int len, int flags, const struct sockaddr FAR *to, int tolen );
參數(shù):
s: Socket 的識別碼
buf: 存放要傳送的資料的暫存區(qū)
len: buf 的長度
flags: 此函式被呼叫的方式
to: 資料要送達的位址
tolen: to 的大小
傳回值: 成功 - 送出的資料長度
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式適用於 Datagram 或 Stream Socket 來傳送資料到指定的位址。 對 Datagram Socket 言,若是 datagram 的大小超過限制,則將不會送出任何資料,并會傳回錯誤值。對 Stream Socket 言,其作用與 send() 相同;參數(shù) to 及 tolen 的值將被系統(tǒng)所忽略。 若是傳送 (transport) 系統(tǒng)內(nèi)之儲存空間不夠存放這些要傳送的資料,sendto() 將會被 block 住,直到資料都被送出;除非該 Socket 被設(shè)定為 non-blocking 模式。使用者亦須注意 sendto()函式執(zhí)行完成,并不表示資料已經(jīng)成功地送抵對方了,而可能仍在系統(tǒng)的 output buffer 中。 flags 的值可設(shè)為 0、MSG_DONTROUTE 及 MSG_OOB 的組合。 (參見 WINSOCK第1.1版51頁)
◎ recvfrom():讀取資料,并儲存資料來源的位址。
格式: int PASCAL FAR recvfrom( SOCKET s, char FAR *buf, int len, int flags, struct socketaddr FAR *from, int FAR *fromlen );
參數(shù):
s: Socket 的識別碼
buf: 存放接收到的資料的暫存區(qū)
len: buf 的長度
flags: 此函式被呼叫的方式
from: 資料來源的位址
fromlen: from 的大小
傳回值: 成功 - 接收到的資料長度 (若對方 Socket 已關(guān)閉,則為 0)
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來讀取資料并記錄資料來源的位址。對 Datagram Socket(UDP)言,一次讀取一個 Datagram;對 Stream Socket (TCP)言,其作用與recv() 相同,參數(shù) from 及 fromlen 的值會被系統(tǒng)忽略。如果 Socket 為 Blocking 模式,且目前 input buffer 內(nèi)沒有任何資料,則 recvftom() 將 block 到有任何資料到達為止;如果為 Non-Blocking 模式,且 input buffer 無任何資料,則會馬上回覆錯誤。
FD_WRITE事件
筆者在前面介紹過 FD_READ 事件的發(fā)生時機,現(xiàn)在繼續(xù)介紹 FD_WRITE這個較易使人混淆的事件,因為真的有相當(dāng)多的人對此一事件的發(fā)生不明了。由字面上看,FD_WRITE 應(yīng)該是要求系統(tǒng)通知我們某個 Socket 現(xiàn)在是否可以呼叫 send 或 sendto 來傳送資料?答案可以說「是」,但是它和 FD_READ卻又有不同的地方。在前面我們知道呼叫一次 recv 後,如果 input buffer 中尚有資料未被取出的話,系統(tǒng)會再通知我們一次 FD_READ。那麼如果我們呼叫一次 send 後,系統(tǒng)的 output buffer 仍有空間可寫入的話,它是否會再通知我們一個FD_WRITE,叫我們繼續(xù)傳送資料呢?這個答案就是「否定」的了!系統(tǒng)并不會再通知我們了。系統(tǒng)會通知我們 FD_WRITE 事件的訊息,只有下列幾種情況:
(1)呼叫 WSAAsyncSelect來設(shè)定 FD_WRITE 事件時,Socket 已經(jīng)可以傳送資料(TCP scoket 已經(jīng)和對方連接成功了,或 UDP socket 已建立完成),且目前 output buffer 仍有空間可寫入資料。
(2)呼叫 WSAAsyncSelect 來設(shè)定 FD_WRITE 事件時,Socket 尚不能傳送資料,不過一旦 Socket 與對方連接成功,馬上就會收到 FD_WRITE 的通知。
(3)呼叫 send 或 sendto 傳送資料時,系統(tǒng)告知錯誤,且錯誤碼為10035 WSAEWOULDBLOCK(呼叫 WSAGetLastError 得知這項錯誤),這時表示 output buffer 已經(jīng)滿了,無法再寫入任何資料(此時即令呼叫再多次的send 也都一定失敗);一旦系統(tǒng)將部份資料成功送抵對方,空出 output buffer後,便會送一個 FD_WRITE 給使用者,告知可繼續(xù)傳送資料了。換句話說,在呼叫 send 傳送資料時,只要不是返回錯誤 10035 的話,便可一直繼續(xù)呼叫 send 來傳送資料;一旦 send 回返錯誤 10035,那麼便不要再呼叫 send傳送資料,而須等收到 FD_WRITE 後,再繼續(xù)傳送資料。
結(jié)語
在這一期的文章中,筆者介紹了各位有關(guān) TCP Socket 的資料收、送方式及FD_READ、FD_WRITE 等事件的發(fā)生時機;讀者們綜合前一期的文章,應(yīng)該已經(jīng)可以建立出一對主從架構(gòu)的程式,并利用 TCP Socket 來傳送資料了。下一期,筆者將繼續(xù)介紹有關(guān)如何獲取網(wǎng)路資訊的函式,如gethostname、getsockname、getpeername,以及同步與非同步的網(wǎng)路資料庫擷取函式 getXbyY、WSAAsyncGetXByY。本文中所提到的 WinKing 試用版可自 SEEDNET 臺北主機 tpts1.seed.net.tw(139.175.1.10)的 UPLOAD/WINKING 目錄中取得,檔名為 wkdemo.exe; WinKing 提供 Ethernet 及 PPP 連線功能,適用於一般 Ethernet 網(wǎng)路,亦可用來以電話、數(shù)據(jù)機連上 SEEDNET 的 PPP 伺服主機;□例 demoserv、democlnt,以及一些筆者所寫的 Winsock 程式(含原始程式碼)則存放在UPLOAD/WINKING/JNLIN 目錄下;有興趣的讀者可自行用 anonymous ftp 方式取得。
獲取網(wǎng)路資訊
在前兩期的文章中,筆者介紹了如何在 Winsock 環(huán)境下建立主從架構(gòu)的TCP Socket,以及如何利用 Socket 來收送資料;今天,我們接著來看一看如何利用 Winsock 所提供的函式來取得一些基本的網(wǎng)路資料,包括我們本身主機的名稱是什麼、系統(tǒng)主動指定給我們的 Socket 的 IP 位址及 port number、我們的 Socket 所連接的對方是誰、如何查得某些主機的 IP 位址或名稱、以及某些well-known 服務(wù)(如 ftp、telnet 等)所用的 port number 是哪一個等等。今天我們使用的展示程式是筆者以前所撰寫的一個針對 Winsock 1.1 的 46 個函式做測試或教學(xué)用的程式,有興趣了解 46 個函式該如何呼叫的讀者,可用anonymous ftp 方式到「tpts1.seed.net.tw」的「UPLOAD/WINKING/JNLIN」目錄下取得此程式的執(zhí)行檔及原始程式碼,檔名為 hello.*。讀者們也可利用hello 程式來模擬 Server 或 Client 程式,以驗證我們所做的動作。
【如何知道我們所使用的 local 主機名稱】
通常我們都會幫我們自己所使用的這臺主機設(shè)定一個名稱;在程式中,我們也可以透過 Winsock 所提供的一個稱為 gethostname() 的函式來取得這一個主機名稱。
◎ gethostname():獲取目前使用者使用的 local host 的名稱。
格 式: int PASCAL FAR gethostname( char FAR *name, int namelen );
參 數(shù): name 用來存放 local host 名稱的暫存區(qū)
namelen name 的大小
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來獲取 local host 的名稱。在程式中我們呼叫的方法如下:
gethostname( (char FAR *) hname, sizeof(hname) )
讀者們?nèi)绻褂眠^ Trumpet Winsock 的話,可能知道 Trumpet 的環(huán)境設(shè)定中并沒有讓我們設(shè)定 local host 名稱的欄位,所以在執(zhí)行一些 Public Domain 的Winsock 應(yīng)用程式(如 ws_ping、wintalk)時,在呼叫 gethostname() 時會產(chǎn)生錯誤;解決的方法是在 Trumpet 的 「hosts」 檔中加上您的主機 IP 位址及名稱,那麼呼叫這個函式時就不會再產(chǎn)生錯誤了。
【如何得知系統(tǒng)主動指定給我們的 IP 位址及 port number】
以前的文章中,筆者曾提到 Client 端的 TCP Socket 在呼叫 connect() 函式去連接 Server 端之前,可以呼叫 bind() 函式來指定 Client 端 Socket 所用的IP 位址及 port number;但是一般而言,我們 Client 端并不需要呼叫 bind() 來指定特定的 IP 位址及 port number 的,而是交由系統(tǒng)主動幫我們的 Socket 設(shè)定 IP 位址及port number (呼叫 connect() 函式時)。但是我們?nèi)绾蔚弥到y(tǒng)指定了什麼IP位址及 port number 給我們呢?這就要借助 getsockname() 這個函式了。
◎ getsockname():獲取 Socket 的 Local 位址及 port number 資料。
格式: int PASCAL FAR getsockname( SOCKET s, struct sockaddr FAR *name, int FAR *namelen );
參 數(shù): s Socket 的識別碼
name 存放此 Socket 的 Local 位址的暫存區(qū)
namelen name 的長度
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式是用來取得已設(shè)定位址或已連接之 Socket 的本端位址資料。若是此 Socket 被設(shè)定為 INADDR_ANY,則需等真正建立連接成功後才會傳回正確的位址。
在程式中呼叫的方法為:
struct sockaddr_in sa;
int salen = sizeof(sa);
getsockname( sd, (struct sockaddr FAR *)&sa, &salen )
【如何知道和我們的 Socket 連接的對方是誰】
連接的 Socket 是有兩端的,所以相對於 getsockname() 函式,Winsock 也提
供了一個 getpeername() 函式,來讓我們獲得與我們連接的對方的 IP 位址與portnumber。
◎ getpeername():獲取連接成功之 Socket 的對方 IP 位址及 port number。
格 式: int PASCAL FAR getpeername( SOCKET s, struct sockaddr FAR *name, int FAR *namelen );
參 數(shù): s Socket 的識別碼
name 儲存與此 Socket 連接的對方 IP 位址的暫存區(qū)
namelen name 的長度
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式可用來取得已連接成功的 Socket 的彼端之位址資料。
呼叫的方式如下:
struct sockaddr_in sa;
int salen = sizeof(sa);
getpeername( sd, (struct sockaddr FAR *)&sa, &salen )
現(xiàn)在我們?nèi)匀焕?WinKing 來當(dāng)我們的 Winsock Stack,并利用它所提供的工具來觀察 Sockets 的連結(jié)及資料是否正確。由圖 1,我們可以由 WinKing 的視窗看到我們設(shè)定這臺主機的名稱是「vincent」,IP 位址是 「140.92.61.24」。我們并利用兩個 hello 程式,一個當(dāng)成 Client (畫面右邊打開者),一個當(dāng)成 Server (畫面左邊最小化者)。Server所用的 port number 是 「7016」; Client 并沒有呼叫 bind() 來指定 port number,而是呼叫 connect() 時由系統(tǒng)指定。我們呼叫 gethostname(),得到的答案是 「vincent」;而 Client 呼叫g(shù)etsockname() 得到自己的 IP 位址是 「140.92.61.24」,port number 是 「2110」(筆者以前曾提過,由系統(tǒng)主動指定的 port number 會介於 1024 到 5000 間);再呼叫 getpeername() 得到與 Client 連接的 Server 端 IP 位址是 「140.92.61.24」(因為我們的 Client 和 Server 都在同一臺主機),port number 是 「7016」。果然沒錯!(由 WinKing 的 Sockets' Status 視窗亦可觀察到相互連接的 Sockets 資料,與我們呼叫函式所得結(jié)果相同)
讀者必須注意一點,getsockname() 及 getpeername() 所取得的 IP 位址及 port number 都是 network byte order,而不是 host byte order;如果您想轉(zhuǎn)成 host byte order,就必須借助 ntohl() 及 ntohs() 兩個函式。而我們能看到 IP 位址以「字串」方式表達出來,則又是利用了 inet_ntoa() 函式;相對地,我們也可利用inet_addr() 函式將字串方式的 IP 位址轉(zhuǎn)換成 in_addr 格式(network byte order 的unsigned long)。
◎ inet_ntoa():將一網(wǎng)路位址轉(zhuǎn)換成「點格式」字串。
格 式: char FAR * PASCAL FAR inet_ntoa( struct in_addr in );
參 數(shù): in 一個代表 Internet host 位址的結(jié)構(gòu)
傳回值: 成功 - 一個代表位址的「點格式」(dotted) 字串
失敗 – NULL
說明: 此函式將一 Internet 位址轉(zhuǎn)換成「a.b.c.d」字串格式。
struct sockaddr {
u_short sa_family; /* address family */
char sa_data[14]; /* up to 14 bytes of direct address */
};
struct in_addr {
union {
struct { u_char s_b1,s_b2,s_b3,s_b4; } S_un_b;
struct { u_short s_w1,s_w2; } S_un_w;
u_long S_addr;
} S_un;
#define s_addr S_un.S_addr /* can be used for most tcp & ip code */
#define s_host S_un.S_un_b.s_b2 /* host on imp */
#define s_net S_un.S_un_b.s_b1 /* network */
#define s_imp S_un.S_un_w.s_w2 /* imp */
#define s_impno S_un.S_un_b.s_b4 /* imp # */
#define s_lh S_un.S_un_b.s_b3 /* logical host */
};
struct sockaddr_in {
short sin_family;
u_short sin_port;
struct in_addr sin_addr;
char sin_zero[8];
};
◎ inet_addr():將字串格式的位址轉(zhuǎn)換成 32 位元 in_addr 的格式。
格 式: unsigned long PASCAL FAR inet_addr( const char FAR *cp );
參 數(shù): cp 一個代表 IP 位址的「點格式」(dotted) 字串
傳回值: 成功 - 一個代表 Internet 位址的 unsigned long
失敗 - INADDR_NONE
說明: 此函式將一「點格式」的位址字串轉(zhuǎn)換成適用之 Intenet 位址。
「點格式」字串可為以下四種方式之任一:
(i) a.b.c.d (ii) a.b.c (iii) a.b (iv) a
圖 1 的 hello 程式中,我們將 Local 資料寫到 dispmsg 中,再顯示出來;其
用法如下:
wsprintf((LPSTR)dispmsg, "OK! local ip=%s, local port=%d",
inet_ntoa(sa.sin_addr), ntohs(sa.sin_port));
【W(wǎng)insock 提供的資料庫函式】
Winsock 也提供了同步與非同步的網(wǎng)路資料庫函式;不過讀者們要知道,此處的資料庫指的并非如 Informix, Oracle 等商業(yè)用途的資料庫系統(tǒng),而是指主機IP 位址及名稱、well-known 服務(wù)的名稱及 Socket 型態(tài)及所用的 port number、以及協(xié)定(protocol)名稱及代碼等。
【同步資料庫函式】
首先我們來看一下第一組:gethostbyname() 及 gethostbyaddr() 函式這兩個函式的用途是讓我們可以由某個主機名稱求得它的 IP 位址,或是由它的 IP 位址求得它的名稱。一般我們經(jīng)常會用到的是由名稱求得 IP 位址;因為很少人會去記某臺機器的 IP 位址的,另外 TCP/IP 封包的 IP header 上也必須記載送、收主機的 IP 位址,而不是主機名稱。
◎ gethostbyname():利用某一 host 的名稱來獲取該 host 的資料。
格 式: struct hostent FAR * PASCAL FAR gethostbyname( const char FAR *name );
參 數(shù): name host 的名稱
傳回值: 成功 - 指向一個 hostent 結(jié)構(gòu)的指標(biāo)
失敗 - NULL (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式是利用 host 名稱來獲取該主機的其他資料,如 host 的位址、別名,位址的型態(tài)、長度等。
◎ gethostbyaddr():利用某一 host 的 IP 位址來獲取該 host 的資料。
格 式: struct hostent FAR * PASCAL FAR gethostbyaddr( const char FAR *addr, int len, int type );
參 數(shù): addr network 排列方式的位址
len addr 的長度
type PF_INET(AF_INET)
傳回值: 成功 - 指向一個 hostent 結(jié)構(gòu)的指標(biāo)
失敗 - NULL (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式是利用 IP 位址來獲取該主機的其他資料,如 host 的名稱、別名,位址的型態(tài)、長度等。
程式中呼叫的方式分別如下:
char host_name[30];
struct hostent far *htptr;
/* 假設(shè) host_name 的值已先設(shè)定為我們要求得資料的主機名稱 */
htptr = (struct hostent FAR *) gethostbyname( (char far *) host_name )
struct in_addr host_addr;
struct hostent far *htptr;
/* 假設(shè) host_addr 的值已先設(shè)定為我們要求得資料的主機的network byte order 方式的 IP 位址*/
htptr = (struct hostent FAR *) gethostbyaddr((char far *)&host_addr, 4, PF_INET)
一般言,程式中呼叫到 gethostbyname() 及 gethostbyaddr() 時,Winsock Stack 會先在 local 的 「hosts」檔中找看看是否有這個主機的資料;如果沒有, 則可能再透過「領(lǐng)域名稱服務(wù)」(Domain Name Service)的功能,向「名稱伺服器」(Name Server)查詢;所以呼叫這兩個函式時,有時會等一下子才獲得答覆。如果您想讓程式執(zhí)行快一些的話,可將常用主機的資料放在 hosts 檔中,這樣就不必透過 DNS 去查詢了。
接下來我們來看 getservbyname() 及 getservbyport() 這兩個函式。大部份的讀者應(yīng)該都用過 telnet、mail、ftp、news 等服務(wù)應(yīng)用程式;這些應(yīng)用程式的協(xié)定,比如服務(wù)名稱、伺服器端所用的 port number、以及 Socket 的型態(tài),都是固定的;這些資料,我們就可以利用 getservbyname() 或 getservbyport()來取得,而不必刻意去記頌它們。
◎ getservbyname():依照服務(wù) (service) 名稱及通訊協(xié)定(tcp/udp)來獲取該服務(wù)的其他資料。
格 式: struct servent * PASCAL FAR getservbyname( const char FAR *name, const char FAR *proto );
參 數(shù): name 服務(wù)名稱
proto 通訊協(xié)定名稱
傳回值: 成功 - 一指向 servent 結(jié)構(gòu)的指標(biāo)
失敗 - NULL (呼叫 WSAGetLastError() 可得知原因)
說明: 利用服務(wù)名稱及通訊協(xié)定來獲得該服務(wù)的別名、使用的 port 號碼等。
◎ getservbyport():依照服務(wù) (service) 的 port 號碼及通訊協(xié)定(tcp/udp)來獲取該服務(wù)的其他資料。
格 式: struct servent * PASCAL FAR getservbyport( int port, const char FAR *proto );
參 數(shù): port 服務(wù)的 port 編號
proto 通訊協(xié)定名稱
傳回值: 成功 - 一指向 servent 結(jié)構(gòu)的指標(biāo)
失敗 - NULL (呼叫 WSAGetLastError() 可得知原因)
說明: 利用 port 編號及通訊協(xié)定來獲得該服務(wù)的名稱、別名等。
程式中的使用方法分別為:
char serv_name[20];
char proto[10];
struct servent far *svptr;
/* 假設(shè) serv_name 及 proto 已先設(shè)好服務(wù)名稱及通訊協(xié)定 */
svptr = (struct servent FAR *)getservbyname( (char far *)serv_name, (char far*)proto )
int serv_port;
char proto[10];
struct servent far *svptr;
/* 假設(shè) serv_port 及 proto 已先設(shè)好服務(wù)所用的 port number 及通訊協(xié)定 */
svptr = (struct servent FAR *)getservbyport( htons(serv_port), (char far*)proto) )
Winsock 環(huán)境下,我們能夠查詢到的服務(wù)資料都是存放在 local 的「services」檔中;這個檔所存放的都是 well-known 的服務(wù),基本上我們是不需去更改它的。讀者也可以將自己提供的服務(wù)加到這個檔中,不過您所用的服務(wù)資料要公諸於世,不然別人的 services 檔中可是沒有您的服務(wù)的資料喲。
最後的這組 getprotobyname() 及 getprotobynumber() 函式是用來取得一些「協(xié)定」的資料,比如 tcp、udp、igmp 等。一般而言,我們是不太會用到的。
◎ getprotobyname():依照通訊協(xié)定 (protocol) 的名稱來獲取該通訊協(xié)定的其他資料。
格 式: struct protoent FAR * PASCAL FAR getprotobyname( const char FAR *name );
參 數(shù): name 通訊協(xié)定名稱
傳回值: 成功 - 一指向 protoent 結(jié)構(gòu)的指標(biāo)
失敗 - NULL (呼叫 WSAGetLastError() 可得知原因)
說明: 利用通訊協(xié)定的名稱來得知該通訊協(xié)定的別名、編號等資料。
◎ getprotobynumber():依照通訊協(xié)定的編號來獲取該通訊協(xié)定的其他資料。
格 式: struct protoent FAR * PASCAL FAR
getprotobynumber( int number );
參 數(shù): number 以 host order 排列方式的通訊協(xié)定編號
傳回值: 成功 - 一指向 protoent 結(jié)構(gòu)的指標(biāo)
失敗 - NULL (呼叫 WSAGetLastError() 可得知原因)
說明: 利用通訊協(xié)定的編號來得知該通訊協(xié)定的名稱、別名等資料。
程式中呼叫方式分別如下:
struct protoent far *ptptr;
char proto_name[20];
/* 假設(shè) proto_name 已先設(shè)好協(xié)定名稱 */
ptptr = (struct protoent FAR *)getprotobyname( (char far *)proto_name)
struct protoent far *ptptr;
int proto_num;
/* 假設(shè) proto_num 已先設(shè)好協(xié)定編號 */
ptptr = (struct protoent FAR *)getprotobynumber( proto_num )
Winsock Stack 對於應(yīng)用程式呼叫 getprotobyname() 及 getprotobynumber()的資料,是取自於 local 的「protocol」檔;如無需要,我們也不用去變更這個檔案的內(nèi)容。
(圖 2)hello 程式呼叫同步資料庫函式
【非同步資料庫函式】
Winsock 1.1 針對前面筆者所描述的 6 個同步資料庫函式,也提供了相對的6 個非同步資料庫函式,它們分別是 WSAAsyncGetHostByName()、WSAAsyncGetHostByAddr()、WSAAsyncGetServByName()、WSAAsyncGetServByPort()、WSAAsyncGetProtoByName()、WSAAsyncGetProtoByNumber()。
由於它們?nèi)〉玫馁Y料與同步資料庫函式相同,所以筆者僅以WSAAsyncGetHostByName() 為例,說明這些非同步函式,并告訴各位讀者,同步和非同步資料庫函式不同的地方。
由字面來看,「非同步」的意思就是我們發(fā)出問題時,并不會馬上得到答覆,而等到系統(tǒng)取到資料時再告知我們。沒錯,這些非同步資料庫函式的作用就是這樣。和 WSAAsyncSelect() 函式一樣,我們要告訴 Winsock 系統(tǒng)一個接受通知訊息的視窗及訊息代碼,以便系統(tǒng)通知我們。
我們呼叫同步資料庫函式時,return 值 是一個指到相對資料的暫存區(qū),而這個資料暫存區(qū)是由系統(tǒng)所提供的;但是呼叫非同步資料庫函式時,我們必須自己準(zhǔn)備資料暫存區(qū),并將此暫存區(qū)的位址當(dāng)成參 數(shù),傳給系統(tǒng),以便系統(tǒng)用來儲存取到的資料。讀者們必須特別注意一點:在系統(tǒng)通知資料取得成功或失敗前,千萬不可將傳給系統(tǒng)的資料暫存區(qū)刪除釋放,不然當(dāng) 系統(tǒng)取得資料要寫入時,資料區(qū)已不見了,會導(dǎo)至當(dāng)機的。除此之外,資料暫存區(qū)的大小一定要夠大,才足夠讓系統(tǒng)用來存放取得的資料。(Winsock 規(guī)格中的建議值是MAXGETHOSTSTRUCT 1024 bytes 大小的暫存區(qū),筆者認為太大了,100 byets差不多就太夠了)
呼叫非同步資料庫函式時,得到的 return 值是一個代碼,此代碼代表的就是此項呼叫在系統(tǒng)內(nèi)的編號;由於是非同步,所以我們在得到答案前,仍可呼叫 WSACancelAsyncRequest() 函式來取消原先的呼叫,這個取消的動作就要利用到該代碼了。另外,當(dāng)我們收到結(jié)果通知時,wParam 的值也是這個代碼;我們此時可以利用 WSAGETASYNCERROR(lParam) 來得知資料取得是成功或失敗;如果失敗的原因是原先傳入的暫存區(qū)太小的話,我們亦可利用WSAASYNCGETBUFLEN(lParam) 來得知至少要多大的暫存區(qū)才夠。
◎ WSAAsyncGetHostByName():利用某一 host 的名稱來獲取該 host 的資料。(非同步方式)
格 式: HANDLE PASCAL FAR WSAAsyncGetHostByName( HWND hWnd,
unsigned int wMsg, const char FAR *name, char FAR *buf, int buflen );
參 數(shù): hWnd 動作完成後,接受訊息的視窗 handle
wMsg 傳回視窗的訊息
name host 名稱
buf 存放 hostent 資料的暫存區(qū)
buflen buf 的大小
傳回值: 成功 - 代表此非同步動作的 handle 代碼
失敗 - 0 (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式是利用 host 名稱來獲取其他的資料,如 host 的位址、別名,位址的型態(tài)、長度等。使用者呼叫此函式時必須傳入要接收資料的視窗 handle、訊息代碼、資料的存放位址指標(biāo)等,以便得到資料時可以通知該視窗來使用資料。呼叫此函式後會馬上回到使用者的呼叫點并傳回一個 handle 代碼,此代碼可用來辨別此非同步動作或用來取消此非同步動作。當(dāng)資料取得後,系統(tǒng)會送一個訊息到使用者指定的視窗。
◎ WSACancelAsyncRequest():取消某一未完成的非同步要求。
格 式: int PASCAL FAR WSACancelAsyncRequest( HANDLEhAsyncTaskHandle );
參 數(shù):hAsyncTaskHandle 要取消的 task handle 代碼
傳回值: 成功 - 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式是用來取消原先呼叫但尚未完成的WSAAsyncGetXByY(),例如 WSAAsyncGetHostByName(),的動作。參數(shù) hAsyncTaskHandle 即為呼叫WSAAsyncGetXByY() 時傳回之代碼值。若是原先呼叫之非同步要求已經(jīng)完成,則無法加以取消。
(圖 3)hello 程式呼叫非同步資料庫函式
【結(jié)語】
筆者已經(jīng)為各位介紹了大部份 Winsock 應(yīng)用程式設(shè)計時會用到的函式,不知讀者中是否已有人開始練習(xí)自己寫 Winsock 網(wǎng)路程式了嗎?下一期,筆者會將剩下的函式都介紹完。再此筆者并期待各位除了使用別人設(shè)計的網(wǎng)路軟體外,大家也都能自己練習(xí)設(shè)計出一些不錯的網(wǎng)路應(yīng)用軟體,讓世界其他國家的人知道臺灣也有能人的;愿共勉之。
其它
接著筆者要再為各位介紹剩下的幾個函式,包括 select()、setsockopt()、getsockopt(),以及變更系統(tǒng)的 Blocking Hook 函式時,所要用到的WSASetBlockingHook() 和 WSAUnhookBlockingHook()。
select【查詢讀寫連接中斷狀態(tài)】
如果寫過 UNIX BSD socket 程式的讀者,一定都知道這個select()函式是很好用的。因為它可以幫您檢查一整組(set)的 sockets 是否可以讀、寫資料,也可以用來檢查 socket 是否已和對方連接成功,或者是對方是否已將相對的socket 關(guān)閉等。但是在 Winsock 1.1 及 MS Windows 3.X 「非強制性多工」的環(huán)境下,它是否仍是那麼好用呢?我們在使用它時,是否要注意些什麼呢?
◎ select():檢查一或多個 Sockets 是否處於可讀、可寫或錯誤的狀態(tài)。
格式:
int PASCAL FAR select( int nfds, fd_set FAR *readfds, fd_set FAR *writefds, fd_set FAR *exceptfds,
const struct time val FAR *timeout )
參數(shù):
nfds: 此參數(shù)在此并無作用
readfds: 要被檢查是否可讀的 Sockets
writefds: 要被檢查是否可寫的 Sockets
exceptfds:要被檢查是否有錯誤的 Sockets
timeout: 此函式該等待的時間
傳回值: 成功 - 符合條件的 Sockets 總數(shù) (若 Timeout 發(fā)生,則為0)
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明:使用者可利用此函式來檢查 Sockets 是否有資料可被讀取,或是有空間可以寫入,或是有錯誤發(fā)生。Winsock 1.1 所提供的 select() 函式與 UNIX BSD 的 select() 函式,在參數(shù)的個數(shù)及資料型態(tài)上是一樣,都有 nfds、readfds、writefds、exceptfds、及 timeout五個參數(shù);但是 Winsock 的 nfds 是沒有作用的,有這個參數(shù)的目的只是為了與 UNIX BSD 的 select() 函式一致。至於 readfds、writefds、exceptfds 同樣是一組 sockets 的集合,所以您可以同時設(shè)定許多 sockets 的號碼在這三個參數(shù)里面;當(dāng)然這些 sockets 必須是屬於您的這個應(yīng)用程式所建立的。如果您設(shè)定的 socket 號碼中有任一個不是屬於您的這個程式的話,呼叫 select() 函式便會失敗(錯誤碼為 10038 WSAENOTSOCK)。
Winsock 同樣也提供了一些 macros 來讓您設(shè)定或檢查 readfds、writefds、exceptfds 的值,包括有:
2 FD_ZERO(*set) -- 將 set 的值清乾凈
2 FD_SET(s, *set) -- 將 s 加到 set 中
2 FD_CLR(s, *set) -- 將 s 從 set 中刪除
2 FD_ISSET(s, *set) -- 檢查 s 是否存在於 set 中
其中 s 代表的是某一個 socket 的號碼,set 代表的就是 readfds、writefds 或 exceptfds。
讀者們要知道參數(shù)readfds、writefds及exceptfds 都是「called by value- result」。
「called by value-result」的意思就是說,我們在將參數(shù)傳給系統(tǒng)時,要先設(shè)啟始值,并將這些參數(shù)的位址(address)告訴系統(tǒng);而系統(tǒng)則會利用到這些值來做些運算或其他用途,最後并將結(jié)果再寫回這些參數(shù)的位址中。因此這些參數(shù)的值在傳入前和函式回返後可能會不同,所以每次呼叫select() 前對這些參數(shù)一定要重新設(shè)定它們的值。
假設(shè)我們要檢查 socket 1 和 2 目前是否可以用來傳送資料,以及 socket 3 是否有資料可讀,我們不打算檢查 sockets 是否有錯誤發(fā)生,所以 exceptfds 設(shè)為NULL。步驟大致如下:
FD_ZERO( &writefds ); //清除 writefds
FD_ZERO( &readfds ); //清除 readfds
FD_SET( 1, &writefds ); //將 socket 1 加到 writefds
FD_SET( 2, &writefds ); //將 socket 2 加到 writefds
FD_SET( 3, &readfds ); //將 socket 3 加到 readfds
select( ..., &readfds, &writefds, NULL, ...) /* 呼叫 select() 來檢查事件 */
if(FD_ISSET( 1, &writefds )) //檢查 socket 1 是否可寫
send( 1, data ); //呼叫 send() 一定成功
if (FD_ISSET( 2, &writefds )) //檢查 socket 2 是否可寫
send( 2, data ); //呼叫 send() 一定成功
if (FD_ISSET( 3, &readfds )) //檢查 socket 2 是否可讀
recv( 3, data ); //呼叫 recv() 一定成功
select() 函式的第五個參數(shù)「timeout」,是讓我們用來設(shè)定 select 函式要等待(block)多久。茲述說如下:
(1)如果 timeout 設(shè)為「NULL」,那麼 select() 就會一直等到「至少」某一個 socket 的事件成立了才會 return,這和其他的 blocking 函式一樣。
select( ..., NULL ) /* blocking */
(2)如果 timeout 的值設(shè)為 {0, 0} (秒, 微秒),那麼 select() 在檢查後,不管有沒有 socket 的事件成立,都會馬上 return,而不會停留。
timeout.tv_sec = timeout.tv_usec = 0;
select( ..., &timeout ) /* non-blocking */
(3)如果 timout 設(shè)為 {m, n},那麼就會等到至少某一個 socket 的事件發(fā)生,或是時間到了(m 秒 n 微秒),才會 return。
timeout.tv_sec = m;
timeout.tv_usec = n;
select( ..., &timeout ) /* wait m secconds n microseconds */
在 UNIX 系統(tǒng)上,我們通常會利用select()來做「polling」的動作,檢查事件是否發(fā)生;但是在 MS Windows 3.X 的環(huán)境下一直做 polling 的動作一定要非常小心,不然可能會造成整個 Windows 系統(tǒng)停住(因為 CPU 都被您的程式占用了);所以使用時一定要注意「控制權(quán)釋放」,不然就是「不要將 timeout 設(shè)為 {0,0}」(因為 timeout 設(shè)為 {0,0} 的話, Winsock 系統(tǒng)內(nèi)部可能不會呼叫到Blocking Hook 函式來釋放控制權(quán))。UNIX 系統(tǒng)由於是「Time Sharing」的方式,所以并不會有類似的問題。(所謂 polling 的動作是指在程式中有一個回圈,而在回圈內(nèi)一直呼叫像select這樣的函式做檢查的動作)
select()除了可以用來檢查socket是否可讀寫外,對於non-blocking的socket在呼叫connect()後,也可利用select()的 writefds 來檢查連接是否已經(jīng)成功了(當(dāng)這個non-blocking的socket被設(shè)定在 writefds,且被 select 成功時);此外,我們亦可利用readfds來檢查 TCP socket 連接的對方是否已經(jīng)關(guān)閉了(當(dāng)此socket被設(shè)定在readfds,且被select成功,但呼叫recv去收資料卻 return 0 時)。
UNIX 系統(tǒng)上因為沒有提供 WSAAsyncSelect() 函式,所以我們要用 select()函式來做 polling 的動作;但是 Winsock 系統(tǒng)上已經(jīng)有了可以設(shè)定非同步事件的WSAAsyncSelect() 函式,為了讓 MS Windows「訊息驅(qū)動」(message driven)的環(huán)境更有效率,讀者們應(yīng)該盡量使用 WSAAsyncSelect(),而少用 select() 的方式;這也是當(dāng)初為什麼要定義一個 WSAAsyncSelect() 函式的最大目的。
setsockopt【變更socket options】
Winsock 1.1 也提供了一個變更 socket options 的 setsockopt() 函式;由於options 的項目很多,筆者僅就數(shù)個較會用到的項目來解說,其馀的項目請讀者們自行研究。
◎ setsockopt():設(shè)定 Socket 的 options。
格式:
int PASCAL FAR setsockopt( SOCKET s, int level, int optname, const char FAR *optval, int optlen )
參數(shù):
s: Socket 的識別碼
level: option 設(shè)定的 level (SOL_SOCKET 或 IPPROTO_TCP)
optname: option 名稱
optval: option 的設(shè)定值
optlen: option 設(shè)定值的長度
傳回值:
成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來設(shè)定 Socket 的一些 options,藉以更改其動作。可更改的options 有:(詳見 Winsock Spec. 54 頁)
Option Type
SO_BROADCAST BOOL
SO_DEBUG BOOL
SO_DONTLINGER BOOL
SO_DONTROUTE BOOL
SO_KEEPALIVE BOOL
SO_LINGER struct linger FAR*
SO_OOBINLINE BOOL
SO_RCVBUF int
SO_REUSEADDR BOOL
SO_SNDBUF int
TCP_NODELAY BOOL
(1)SO_BROADCAST -- 適用於 UDP socket。其意義是允許UDP socket「廣播」broadcast訊息到網(wǎng)路上。
(2)SO_DONTLINGER -- 適用於 TCP socket。其意義是讓 socket 在呼叫 closesocket() 關(guān)閉時,能馬上 return,而不用等到資料都送完後才從函式呼叫return;closesocket() 函式 return 後,系統(tǒng)仍會繼續(xù)將資料全部送完後,才真正地將這個 socket 關(guān)閉。一個 TCP socket 在開啟時的預(yù)設(shè)值即是 Don't Linger。
(3)SO_LINGER -- 適用於 TCP socket 來設(shè)定 linger 值之用。如果 linger的 值設(shè)為 0,那麼在呼叫 closesocket() 關(guān)閉 socket 時,如果該 socket 的 output buffer 中還有資料的話,將會被系統(tǒng)所忽略,而不會被送出,此時 closesocket() 也會馬上 return;如果 linger 值設(shè)為 n 秒,那麼系統(tǒng)就會在這個時間內(nèi),嘗試去送出output buffer 中的資料,時間到了或是資料送完了,才會從 closesocket() 呼叫return。
(4)SO_REUSEADDR -- 允許 socket 呼叫 bind() 去設(shè)定一個已經(jīng)用過的位址(含 port number)。
我們就以設(shè)定某個socket的 linger 值為例,看看程式中該如何呼叫 setsockopt() 這個函式:
struct linger Linger;
Linger.l_onoff = 1; //開啟 linger 設(shè)定
Linger.l_linger = n; //設(shè)定 linger 時間為 n 秒
setsockopt( s, SOL_SOCKET, SO_LINGER, &Linger, sizeof(struct linger) )
相對地,如果我們想要知道目前的某個 option 的設(shè)定值,那麼就可以利用getsockopt() 函式來取得。
getsockopt【獲取socket options】
◎ getsockopt():取得某一 Socket 目前某個 option 的設(shè)定值。
格式:
int PASCAL FAR getsockopt( SOCKET s, int level, int optname, char FAR *optval, int FAR *optlen )
參數(shù):
S: Socket 的識別碼
Level: option 設(shè)定的 level
optname: option 名稱
optval: option 的設(shè)定值
Optlen: option 設(shè)定值的長度
傳回值:
成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式用來獲取目前 Socket的某些 options 設(shè)定值。同樣地,我們?nèi)砸匀〉媚硞€ socket 的 linger 值為例,看一下程式中應(yīng)該如何呼叫 getsockopt():
struct linger Linger;
int opt_len = sizeof(struct linger);
getsockopt( s, SOL_SOCKET, SO_LINGER, &Linger, &opt_len)
WSASetBlockingHook
【什麼是 Blocking Hook 函式及如何設(shè)定自己的 Blocking Hook 函式】
什麼是「Blocking Hook」函式呢?在解釋之前,我們要先來剖析一下Winsock 1.1 提供的 Blocking 函式(如 accept、connect 等)的內(nèi)部究竟做了哪些事?在 Winsock Stack 的 Blocking 函式內(nèi)部,除了會檢查一些條件外(比如該應(yīng)用程式是否已呼叫過 WSAStartup()?傳入的參數(shù)是否正確?等等),便會進入一個類似下面的回圈:
for (;;)
{
/* 執(zhí)行 Blocking Hook 函式 */
while (BlockingHook());
/* 檢查使用者是否已經(jīng)呼叫了 WSACancelBlockingCall() */
if (operation_cancelled()) break;
/* 檢查動作是否完成了? */
if (operation_complete()) break;
}
現(xiàn)在我們可以很清楚地知道 Blocking 函式的回圈中,有三件重要的事:
(1)執(zhí)行 Blocking Hook 函式
(2)檢查使用者是否呼叫了 WSACancelBlockingCall()來取消此 Blocking 函式的呼叫?
(3)檢查此 Blocking 函式的動作是否已經(jīng)完成了?
讀者們必須注意,不同的 Winsock Stack 在執(zhí)行這三件事時的順序可能會不相同;有的 Winsock Stack 可能會先檢查 Blocking 函式的動作是否已經(jīng)完成了,然後再執(zhí)行 Blocking Hook 函式;所以 Blocking Hook 函式有可能不會被呼叫到。待會解釋完 Blocking Hook 函式的重點後,讀者們就可以知道筆者為什麼在前面告訴各位在使用 polling 方式時一定要非常小心了。
由上面的回圈,我們現(xiàn)在可以知道 Blocking Hook 函式的使用時機是讓系統(tǒng)在等待 Blocking 函式完成前所呼叫的,它并不是給我們自己的應(yīng)用程式所使用的。Winsock 系統(tǒng)本身內(nèi)部就有一個預(yù)設(shè)的 Blocking Hook 函式;現(xiàn)在我們就來看一下這個預(yù)設(shè)的 Blocking Hook 函式會做些什麼事?
BOOL DefaultBlockingHook(void)
{
MSG msg;
BOOL ret;
/* 取得下一個訊息;如果有,就處理它;如果沒有,就釋出控制權(quán) */
ret = (BOOL) PeekMessage(&msg, NULL, 0, 0, PM_REMOVE);
if (ret) {
TranslateMessage(&msg);
DispatchMessage(&msg);
}
return ret;
}
Blocking Hook 函式中很重要的地方就是:讓 Blocking 函式在等待動作完成前能夠處理其他訊息,或是釋出 CPU 控制權(quán),以便讓其他的應(yīng)用程式也有執(zhí)行的機會。
現(xiàn)在回到前面一點的地方,大家仔細想一想:如果在一個 Winsock Stack 的Blocking 函式的回圈內(nèi),先檢查 Blocking 函式的動作是否已經(jīng)完成了,然後再執(zhí)行 Blocking Hook 函式的話;那麼是否就有可能不會釋出 CPU 控制權(quán)來讓其他的程式有執(zhí)行的機會呢?如果我們的程式中再有類似下面的一個回圈,那麼整個Windows 環(huán)境可能就會因我們的程式而 hang 住了。
for (;;)
{
FD_ZERO(&writefds);
FD_SET( s, &writefds );
timeout.tv_sec = timeout.tv_usec = 0;
n = select( 64, NULL, &writefds, NULL, &timeout );
if ( n > 0 ) break;
if ( n == 0) continue;/* timeout */
...
}
send( s, data ... );
在這個回圈例子中,我們原是希望利用 select() 及 polling 的方式來檢查 socket 的 output buffer 中是否尚有空間可寫入資料?如果此時 output buffer 恰好滿了, select() 函式中一檢查到如此的情況,且 timeout 又是 {0,0},那麼就會馬上return 0,而不會呼叫到 Blocking Hook 函式來釋放 CPU 控制權(quán)給 Windows 環(huán)境中的其他程式(包括 Winsock 收送的 Protocol Stack );由於沒有分配到 CPU 時間,所以 Winsock Kernel 便無法將 output buffer 中任何資料送出; Windows 系統(tǒng)因此就 hang 住了 !
Blocking Hook 函式中除了 CPU 控制權(quán)釋放的問題外,還需注意什麼呢?大家再看一看前面 Blocking 函式的回圈;回圈內(nèi)呼叫 Blocking Hook 函式是包在另一個無窮的 while 回圈內(nèi)。如果一個 Blocking Hook 函式的 return 值永遠不為 0 的話,那麼也就永遠被困在這個無窮回圈內(nèi)了;所以我們在設(shè)計自己的 Blocking Hook 函式時一定也要非常小心這個 return 值。
知道了 Blocking Hook 函式的用途及設(shè)計 Blocking Hook 函式該注意的地方後,我們究竟要如何取代掉系統(tǒng)原有的 Blocking Hook 函式呢?那就要利用WSASetBlockingHook() 函式了。
◎ WSASetBlockingHook():建立應(yīng)用程式指定的 blocking hook 函式。
格式: FARPROC PASCAL FAR WSASetBlockingHook( FARPROC lpBlockFunc )
參數(shù): lpBlockfunc 指向要裝設(shè)的 blocking hook 函式的位址的指標(biāo)
傳回值:指向前一個 blocking hook 函式的位址的指標(biāo)
說明: 此函式讓使用者可以設(shè)定他自己的 Blocking Hook 函式,以取代原先系統(tǒng)預(yù)設(shè)的函式。被設(shè)定的函式將會在應(yīng)用程式呼叫到「blocking」動作時執(zhí)行。唯一可在使用者指定的 blocking hook 函式中呼叫的 Winsock 介面函式只有WSACancelBlockingCall()。假設(shè)我們自己設(shè)計了一個 Blocking Hook 函式叫 myblockinghook,那麼在程式中向 Winsock 系統(tǒng)注冊的方法如下:(其中_hInst代表此task的 Instance)
FARPROC lpmybkhook = NULL;
lpmybkhook = MakeProcInstance( (FARPROC)myblockinghook, _hInst) );
WSASetBlockingHook( (FARPROC)lpmybkhook );
我們在設(shè)定自己的 Blocking Hook 程式後,仍可以利用WSAUnhookBlockingHook() 函式,來取消我們設(shè)定的 Blocking Hook 函式,而變更回原先系統(tǒng)內(nèi)定的 Blocking Hook 函式。
◎ WSAUnhookBlockingHook():復(fù)原系統(tǒng)預(yù)設(shè)的 blocking hook 函式。
格 式: int PASCAL FAR WSAUnhookBlockingHook( void )
參 數(shù): 無
傳回值: 成功 – 0
失敗 - SOCKET_ERROR (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式取消使用者設(shè)定的 blocking hook 函式,而回復(fù)系統(tǒng)原先預(yù)設(shè)的 blocking hook 函式。
最後筆者要再說明一點,一個應(yīng)用程式所設(shè)定的 Blocking Hook 函式,只會被這個應(yīng)用程式所使用;其他的應(yīng)用程式并不會執(zhí)行到您設(shè)定的 Blocking Hook 函式的。另外若非極有必要,最好是不要任意變更系統(tǒng)的 Blocking Hook 函式;因為一旦您沒有設(shè)計好的話,整個 Windows 環(huán)境可能就完蛋了。
【結(jié)語】
四期的「Winsock 應(yīng)用程式設(shè)計篇」在此結(jié)束了;筆者除了介紹 Winsock API 外,也將自己親身設(shè)計 winsock.dll 的經(jīng)驗與各位讀者分享了;希望這幾期的文章,對於國內(nèi)想要在 Winsock 1.1 環(huán)境上開發(fā)網(wǎng)路應(yīng)用程式的讀者有些許的幫助。謝謝大家。
[Microsoft Windows-specific Extensions]
(1) WSAAsyncGetHostByAddr():利用某一 host 的位址來獲取該 host 的資料。(非同步方式)
格 式: HANDLE PASCAL FAR WSAAsyncGetHostByAddr( HWND hWnd, unsigned int wMsg, const char FAR *addr, int len, int type, char FAR *buf, int buflen );
參 數(shù):
hWnd 動作完成後,接受訊息的視窗 handle
wMsg 傳回視窗的訊息
addr network 排列方式的位址
len addr 的長度
type PF_INET(AF_INET)
buf 存放 hostent 資料的區(qū)域
buflen buf 的大小
傳回值: 成功 - 代表此 Async 動作的 handle
失敗 - 0 (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式是利用位址來獲取 host 的其他資料,如 host 的名稱、別名, 位址的型態(tài)、長度等。使用者呼叫此函式時必須傳入要接收資料的視窗handle、訊息代碼、資料的存放位置指標(biāo)等,以便得到資料時可以通知該視窗來使用資料。呼叫此函式後會馬上回到使用者的呼叫點并傳回一個 handle,此 handle 可用來辨別此非同步動作或用來取消此非同步動作。當(dāng)資料取得後,會送一個訊息到使用者指定的視窗。
(2) WSAAsyncGetHostByName():利用某一 host 的名稱來獲取該 host 的資料。 (非同步方式)
格 式: HANDLE PASCAL FAR WSAAsyncGetHostByName( HWND hWnd, unsigned int wMsg, const char FAR *name, char FAR *buf, int buflen );
參 數(shù):
hWnd 動作完成後,接受訊息的視窗 handle
wMsg 傳回視窗的訊息
name host 名稱
buf 存放 hostent 資料的區(qū)域
buflen buf 的大小
傳回值: 成功 - 代表此 Async 動作的 handle
失敗 - 0 (呼叫 WSAGetLastError() 可得知原因)
說明: 此函式是利用 host 名稱來獲取其他的資料,如 host 的位址、別名, 位址的型態(tài)、長度等。使用者呼叫此函式時必須傳入要接收資料的視窗handle、訊息代碼、資料的存放位置指標(biāo)等,以便得到資料時可以通知該視窗來使用資料。呼叫此函式後會馬上回到使用者的呼叫點并傳回一個 handle,此handle 可用來辨別此非同步動作或用來取消此非同步動作。當(dāng)資料取得後,會送一個訊息到使用者指定的視窗。
(3) WSAAsyncGetProtoByName():依照通訊協(xié)定的名稱來獲取該通訊協(xié)定的其他資料。(非同步方式)
格 式: HANDLE PASCAL FAR WSAAsyncGetProtoByName( HWND hWnd, unsigned int wMsg, const char FAR *name, char FAR *buf, int buflen );
參 數(shù): hWnd 動作完成後,接受訊息的視窗 handle
wMsg 傳回視窗的訊息
name 通訊協(xié)定名稱
buf 存放 protoent 資料的區(qū)域
buflen buf 的大小
傳回值: 成功 - 代表此 Async 動作的 handle
失敗 - 0 (呼叫 WSAGetLastError() 可得知原因)
說明: 利用通訊協(xié)定的名稱來得知該通訊協(xié)定的別名、編號等資料。使用者呼叫此函式時必須傳入要接收資料的視窗 handle、訊息代碼、資料的存放位置指標(biāo)等,以便得到資料時可以通知該視窗來使用資料。呼叫此函式後會馬上回到使用者的呼叫點并傳回一個 handle,此 handle可用來辨別此?
轉(zhuǎn)載于:https://www.cnblogs.com/bigfish--/archive/2012/01/03/2311435.html
總結(jié)
以上是生活随笔為你收集整理的Winsock编程宝典(转帖)的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: μC-/OS II(一) PC编译环境的
- 下一篇: 腾讯 vs 百度