http://lobert.iteye.com/blog/1767721(代碼）
socket（建立一個socket通信）
|
相關函數
|
accept，bind，connect，listen |
|
表頭文件
|
#include #include |
|
定義函數
|
int socket(int domain,int type,int
protocol); |
|
函數說明
|
socket()用來建立一個新的socket，也就是向系統註冊，通知系統建立一通信端口。參數domain
指定使用何種的地址類型，完整的定義在/usr/include/bits/socket.h 內，底下是常見的協議: PF_UNIX/PF_LOCAL/AF_UNIX/AF_LOCAL UNIX 進程通信協議 PF_INET?AF_INET Ipv4網絡協議 PF_INET6/AF_INET6 Ipv6 網絡協議 PF_IPX/AF_IPX IPX-Novell協議 PF_NETLINK/AF_NETLINK 核心用戶接口裝置 PF_X25/AF_X25 ITU-T X.25/ISO-8208 協議 PF_AX25/AF_AX25 業餘無線AX.25協議 PF_ATMPVC/AF_ATMPVC 存取原始ATM PVCs PF_APPLETALK/AF_APPLETALK appletalk（DDP）協議 PF_PACKET/AF_PACKET 初級封包接口 |
|
參數
|
type有下列幾種數值: SOCK_STREAM 提供雙向連續且可信賴的數據流，即TCP。支持 OOB 機制，在所有數據傳送前必須使用connect()來建立連線狀態。 SOCK_DGRAM 使用不連續不可信賴的數據包連接 SOCK_SEQPACKET 提供連續可信賴的數據包連接 SOCK_RAW 提供原始網絡協議存取 SOCK_RDM 提供可信賴的數據包連接 SOCK_PACKET 提供和網絡驅動程序直接通信。 protocol用來指定socket所使用的傳輸協議編號，通常此參考不用管它，設爲0即可。 |
|
返回值
|
成功則返回socket處理代碼，失敗返回-1。 |
|
錯誤代碼
|
EPROTONOSUPPORT
參數domain指定的類型不支持參數type或protocol指定的協議 ENFILE 核心內存不足，無法建立新的socket結構 EMFILE 進程文件表溢出，無法再建立新的socket EACCESS 權限不足，無法建立type或protocol指定的協議 ENOBUFS/ENOMEM 內存不足 EINVAL 參數domain/type/protocol不合法 |
bind（對socket定位）
|
相關函數
|
socket，accept，connect，listen |
|
表頭文件
|
#include #include |
|
定義函數
|
int bind(int sockfd,struct sockaddr *
my_addr,int addrlen); |
|
函數說明
|
bind()用來設置給參數sockfd的socket一個名稱。此名稱由參數my_addr指向一sockaddr結構，對於不同的socket
domain定義了一個通用的數據結構 struct sockaddr { unsigned short int sa_family; char sa_data[14]; }; sa_family 爲調用socket（）時的domain參數，即AF_xxxx值。 sa_data 最多使用14個字符長度。 此sockaddr結構會因使用不同的socket domain而有不同結構定義，例如使用AF_INET domain，其socketaddr結構定義便爲 struct socketaddr_in { unsigned short int sin_family; uint16_t sin_port; struct in_addr sin_addr; unsigned char sin_zero[8]; }; struct in_addr { uint32_t s_addr; }; sin_family 即爲sa_family sin_port 爲使用的port編號 sin_addr.s_addr 爲IP 地址 sin_zero 未使用。 |
|
參數
|
addrlen爲sockaddr的結構長度。 |
|
返回值
|
成功則返回0，失敗返回-1，錯誤原因存於errno中。 |
|
錯誤代碼
|
EBADF 參數sockfd 非合法socket處理代碼。 EACCESS 權限不足 ENOTSOCK 參數sockfd爲一文件描述詞，非socket。 |
listen（等待連接）
|
相關函數
|
socket，bind，accept，connect |
|
表頭文件
|
#include |
|
定義函數
|
int listen(int s,int
backlog); |
|
函數說明
|
listen()用來等待參數s
的socket連線。參數backlog指定同時能處理的最大連接要求，如果連接數目達此上限則client端將收到ECONNREFUSED的錯誤。Listen()並未開始接收連線，只是設置socket爲listen模式，真正接收client端連線的是accept()。通常listen()會在socket()，bind()之後調用，接着才調用accept()。 |
|
返回值
|
成功則返回0，失敗返回-1，錯誤原因存於errno |
|
附加說明
|
listen()只適用SOCK_STREAM或SOCK_SEQPACKET的socket類型。如果socket爲AF_INET則參數backlog
最大值可設至128。 |
|
錯誤代碼
|
EBADF 參數sockfd非合法socket處理代碼 EACCESS 權限不足 EOPNOTSUPP 指定的socket並未支援listen模式。 |
accept（接受socket連線）
|
相關函數
|
socket，bind，listen，connect |
|
表頭文件
|
#include #include |
|
定義函數
|
int accept(int s,struct sockaddr * addr,int *
addrlen); |
|
函數說明
|
accept()用來接受參數s的socket連線。參數s的socket必需先經bind()、listen()函數處理過，當有連線進來時accept()會返回一個新的socket處理代碼，往後的數據傳送與讀取就是經由新的socket處理，而原來參數s的socket能繼續使用accept()來接受新的連線要求。連線成功時，參數addr所指的結構會被系統填入遠程主機的地址數據，參數addrlen爲scokaddr的結構長度。關於結構sockaddr的定義請參考bind()。 |
|
返回值
|
成功則返回新的socket處理代碼，失敗返回-1，錯誤原因存於errno中。 |
|
錯誤代碼
|
EBADF 參數s 非合法socket處理代碼。 EFAULT 參數addr指針指向無法存取的內存空間。 ENOTSOCK 參數s爲一文件描述詞，非socket。 EOPNOTSUPP 指定的socket並非SOCK_STREAM。 EPERM 防火牆拒絕此連線。 ENOBUFS 系統的緩衝內存不足。 ENOMEM 核心內存不足。 |
connect（建立socket連線）
|
相關函數
|
socket，bind，listen |
|
表頭文件
|
#include #include |
|
定義函數
|
int connect (int sockfd,struct sockaddr *
serv_addr,int addrlen); |
|
函數說明
|
connect()用來將參數sockfd 的socket 連至參數serv_addr
指定的網絡地址。結構sockaddr請參考bind()。參數addrlen爲sockaddr的結構長度。 |
|
返回值
|
成功則返回0，失敗返回-1，錯誤原因存於errno中。 |
|
錯誤代碼
|
EBADF 參數sockfd 非合法socket處理代碼 EFAULT 參數serv_addr指針指向無法存取的內存空間 ENOTSOCK 參數sockfd爲一文件描述詞，非socket。 EISCONN 參數sockfd的socket已是連線狀態 ECONNREFUSED 連線要求被server端拒絕。 ETIMEDOUT 企圖連線的操作超過限定時間仍未有響應。 ENETUNREACH 無法傳送數據包至指定的主機。 EAFNOSUPPORT sockaddr結構的sa_family不正確。 EALREADY socket爲不可阻斷且先前的連線操作還未完成。 |
htons（將16位主機字符順序轉換成網絡字符順序）
|
相關函數
|
htonl，ntohl，ntohs |
|
表頭文件
|
#include |
|
定義函數
|
unsigned short int htons(unsigned short int
hostshort); |
|
函數說明
|
htons()用來將參數指定的16位hostshort轉換成網絡字符順序。 |
|
返回值
|
返回對應的網絡字符順序。 |
htonl（將32位主機字符順序轉換成網絡字符順序）
|
相關函數
|
htons，ntohl，ntohs |
|
表頭文件
|
#include |
|
定義函數
|
unsigned long int htonl(unsigned long int
hostlong); |
|
函數說明
|
htonl（）用來將參數指定的32位hostlong
轉換成網絡字符順序。 |
|
返回值
|
返回對應的網絡字符順序。 |
select（I/O多工機制）
|
表頭文件
|
#include #include #include |
|
定義函數
|
int select(int n,fd_set * readfds,fd_set *
writefds,fd_set * exceptfds,struct timeval *
timeout); |
|
函數說明
|
select()用來等待文件描述詞狀態的改變。參數n代表最大的文件描述詞加1，參數readfds、writefds
和exceptfds 稱爲描述詞組，是用來回傳該描述詞的讀，寫或例外的狀況。底下的宏提供了處理這三種描述詞組的方式: FD_CLR(inr fd,fd_set* set)；用來清除描述詞組set中相關fd 的位 FD_ISSET(int fd,fd_set *set)；用來測試描述詞組set中相關fd 的位是否爲真 FD_SET（int fd,fd_set*set）；用來設置描述詞組set中相關fd的位 FD_ZERO（fd_set *set）； 用來清除描述詞組set的全部位 |
|
參數
|
timeout爲結構timeval，用來設置select()的等待時間，其結構定義如下 struct timeval { time_t tv_sec; time_t tv_usec; }; |
|
返回值
|
如果參數timeout設爲NULL則表示select（）沒有timeout。 |
|
錯誤代碼
|
執行成功則返回文件描述詞狀態已改變的個數，如果返回0代表在描述詞狀態改變前已超過timeout時間，當有錯誤發生時則返回-1，錯誤原因存於errno，此時參數readfds，writefds，exceptfds和timeout的值變成不可預測。 EBADF 文件描述詞爲無效的或該文件已關閉 EINTR 此調用被信號所中斷 EINVAL 參數n 爲負值。 ENOMEM 核心內存不足 |
|
範例
|
常見的程序片段:fs_set readset； FD_ZERO(&readset); FD_SET(fd,&readset); select(fd+1,&readset,NULL,NULL,NULL); if(FD_ISSET(fd,readset){……} |