Linux常用C函式—介面處理篇(轉)[@more@]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 核心記憶體不足。

範例參考listen()。

　

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()

　

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為不可阻斷且先前的連線操作還未完成。

範例 /* 利用socket的TCP client
此程式會連線TCP server，並將鍵盤輸入的字串傳送給server。
TCP server範例請參考listen（）。
*/
#include
#include
#include
#include
#include
#include
#include
#define PORT 1234
#define SERVER_IP “127.0.0.1”
main()
{
int s;
struct sockaddr_in addr;
char buffer[256];
if((s = socket(AF_INET,SOCK_STREAM,0))<0){
perror(“socket”);
exit(1);
}
/* 填寫sockaddr_in結構*/
bzero(&addr,sizeof(addr));
addr.sin_family = AF_INET;
addr.sin_port=htons(PORT);
addr.sin_addr.s_addr = inet_addr(SERVER_IP);
/* 嘗試連線*/
if(connect(s,&addr,sizeof(addr))<0){
perror(“connect”);
exit(1);
}
/* 接收由server端傳來的資訊*/
recv(s,buffer,sizeof(buffer),0);
printf(“%s ”,buffer);
while(1){
bzero(buffer,sizeof(buffer));
/* 從標準輸入裝置取得字串*/
read(STDIN_FILENO,buffer,sizeof(buffer));
/* 將字串傳給server端*/
if(send(s,buffer,sizeof(buffer),0)<0){
perror(“send”);
exit(1);
}
}
}

執行 $ ./connect
Welcome to server!
hi I am client! /*鍵盤輸入*/
/*中斷程式*/

　

endprotoent（結束網路協議資料的讀取）
相關函式 getprotoent，getprotobyname，getprotobynumber，setprotoent

表標頭檔案 #include

定義函式 void endprotoent(void);

函式說明 endprotoent()用來關閉由getprotoent()開啟的檔案。

返回值

範例參考getprotoent()

　

endservent（結束網路服務資料的讀取）
相關函式 getservent，getservbyname，getservbyport，setservent

表標頭檔案 #include

定義函式 void endservent(void);

函式說明 endservent()用來關閉由getservent()所開啟的檔案。

返回值

範例參考getservent()。

　

getsockopt（取得socket狀態）
相關函式 setsockopt

表標頭檔案 #include
#include

定義函式 int getsockopt(int s,int level,int optname,void* optval,socklen_t* optlen);

函式說明 getsockopt()會將引數s所指定的socket狀態返回。引數optname代表欲取得何種選項狀態，而引數optval則指向欲儲存結果的記憶體地址，引數optlen則為該空間的大小。引數level、optname請參考setsockopt()。

返回值成功則返回0，若有錯誤則返回-1，錯誤原因存於errno

錯誤程式碼 EBADF 引數s 並非合法的socket處理程式碼
ENOTSOCK 引數s為一檔案描述詞，非socket
ENOPROTOOPT 引數optname指定的選項不正確
EFAULT 引數optval指標指向無法存取的記憶體空間

範例 #include
#include
main()
{
int s,optval,optlen = sizeof(int);
if((s = socket(AF_INET,SOCK_STREAM,0))<0) perror(“socket”);
getsockopt(s,SOL_SOCKET,SO_TYPE,&optval,&optlen);
printf(“optval = %d ”,optval);
close(s);}

執行 optval = 1 /*SOCK_STREAM的定義正是此值*/

　

htonl（將32位主機字元順序轉換成網路字元順序）
相關函式 htons，ntohl，ntohs

表標頭檔案 #include

定義函式 unsigned long int htonl(unsigned long int hostlong);

函式說明 htonl（）用來將引數指定的32位hostlong 轉換成網路字元順序。

返回值返回對應的網路字元順序。

範例參考getservbyport()或connect()。

　

htons（將16位主機字元順序轉換成網路字元順序）
相關函式 htonl，ntohl，ntohs

表標頭檔案 #include

定義函式 unsigned short int htons(unsigned short int hostshort);

函式說明 htons()用來將引數指定的16位hostshort轉換成網路字元順序。

返回值返回對應的網路字元順序。

範例參考connect()。

　

inet_addr（將網路地址轉成二進位制的數字）
相關函式 inet_aton，inet_ntoa

表標頭檔案 #include
#include
#include

定義函式 unsigned long int inet_addr(const char *cp);

函式說明 inet_addr()用來將引數cp所指的網路地址字串轉換成網路所使用的二進位制數字。網路地址字串是以數字和點組成的字串，例如:“163.13.132.68”。

返回值成功則返回對應的網路二進位制的數字，失敗返回-1。

　

inet_aton（將網路地址轉成網路二進位制的數字）
相關函式 inet_addr，inet_ntoa

表標頭檔案 #include
#include
#include

定義函式 int inet_aton(const char * cp,struct in_addr *inp);

函式說明 inet_aton()用來將引數cp所指的網路地址字串轉換成網路使用的二進位制的數字，然後存於引數inp所指的in_addr結構中。
結構in_addr定義如下
struct in_addr
{
unsigned long int s_addr;
};

返回值成功則返回非0值，失敗則返回0。

　

inet_ntoa（將網路二進位制的數字轉換成網路地址）
相關函式 inet_addr，inet_aton

表標頭檔案 #include
#include
#include

定義函式 char * inet_ntoa(struct in_addr in);

函式說明 inet_ntoa()用來將引數in所指的網路二進位制的數字轉換成網路地址，然後將指向此網路地址字串的指標返回。

返回值成功則返回字串指標，失敗則返回NULL。

　

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模式。

範例 #include
#include
#include
#include
#include
#define PORT 1234
#define MAXSOCKFD 10
main()
{
int sockfd,newsockfd,is_connected[MAXSOCKFD],fd;
struct sockaddr_in addr;
int addr_len = sizeof(struct sockaddr_in);
fd_set readfds;
char buffer[256];
char msg[ ] =”Welcome to server!”;
if ((sockfd = socket(AF_INET,SOCK_STREAM,0))<0){
perror(“socket”);
exit(1);
}
bzero(&addr,sizeof(addr));
addr.sin_family =AF_INET;
addr.sin_port = htons(PORT);
addr.sin_addr.s_addr = htonl(INADDR_ANY);
if(bind(sockfd,&addr,sizeof(addr))<0){
perror(“connect”);
exit(1);
}
if(listen(sockfd,3)<0){
perror(“listen”);
exit(1);
}
for(fd=0;fd is_connected[fd]=0;
while(1){
FD_ZERO(&readfds);
FD_SET(sockfd,&readfds);
for(fd=0;fd if(is_connected[fd]) FD_SET(fd,&readfds);
if(!select(MAXSOCKFD,&readfds,NULL,NULL,NULL))continue;
for(fd=0;fd if(FD_ISSET(fd,&readfds)){
if(sockfd = =fd){
if((newsockfd = accept (sockfd,&addr,&addr_len))<0)
perror(“accept”);
write(newsockfd,msg,sizeof(msg));
is_connected[newsockfd] =1;
printf(“cnnect from %s ”,inet_ntoa(addr.sin_addr));
}else{
bzero(buffer,sizeof(buffer));
if(read(fd,buffer,sizeof(buffer))<=0){
printf(“connect closed. ”);
is_connected[fd]=0;
close(fd);
}else
printf(“%s”,buffer);
}
}
}
}

執行 $ ./listen
connect from 127.0.0.1
hi I am client
connected closed.

　

ntohl（將32位網路字元順序轉換成主機字元順序）
相關函式 htonl，htons，ntohs

表標頭檔案 #include

定義函式 unsigned long int ntohl(unsigned long int netlong);

函式說明 ntohl()用來將引數指定的32位netlong轉換成主機字元順序。

返回值返回對應的主機字元順序。

範例參考getservent()。

　

ntohs（將16位網路字元順序轉換成主機字元順序）
相關函式 htonl，htons，ntohl

表標頭檔案 #include

定義函式 unsigned short int ntohs(unsigned short int netshort);

函式說明 ntohs()用來將引數指定的16位netshort轉換成主機字元順序。

返回值返回對應的主機順序。

範例參考getservent()。

　

recv（經socket接收資料）
相關函式 recvfrom，recvmsg，send，sendto，socket

表標頭檔案 #include
#include

定義函式 int recv(int s,void *buf,int len,unsigned int flags);

函式說明 recv()用來接收遠端主機經指定的socket傳來的資料，並把資料存到由引數buf 指向的記憶體空間，引數len為可接收資料的最大長度。

引數 flags一般設0。其他數值定義如下:
MSG_OOB 接收以out-of-band 送出的資料。
MSG_PEEK 返回來的資料並不會在系統內刪除，如果再呼叫recv()會返回相同的資料內容。
MSG_WAITALL強迫接收到len大小的資料後才能返回，除非有錯誤或訊號產生。
MSG_NOSIGNAL此操作不願被SIGPIPE訊號中斷返回值成功則返回接收到的字元數，失敗返回-1，錯誤原因存於errno中。

錯誤程式碼 EBADF 引數s非合法的socket處理程式碼
EFAULT 引數中有一指標指向無法存取的記憶體空間
ENOTSOCK 引數s為一檔案描述詞，非socket。
EINTR 被訊號所中斷
EAGAIN 此動作會令程式阻斷，但引數s的socket為不可阻斷
ENOBUFS 系統的緩衝記憶體不足。
ENOMEM 核心記憶體不足
EINVAL 傳給系統呼叫的引數不正確。

範例參考listen()。

　

recvfrom（經socket接收資料）
相關函式 recv，recvmsg，send，sendto，socket

表標頭檔案 #include
#include

定義函式 int recvfrom(int s,void *buf,int len,unsigned int flags ,struct sockaddr *from ,int *fromlen);

函式說明 recv()用來接收遠端主機經指定的socket 傳來的資料，並把資料存到由引數buf 指向的記憶體空間，引數len 為可接收資料的最大長度。引數flags 一般設0，其他數值定義請參考recv()。引數from用來指定欲傳送的網路地址，結構sockaddr 請參考bind()。引數fromlen為sockaddr的結構長度。

返回值成功則返回接收到的字元數，失敗則返回-1，錯誤原因存於errno中。

錯誤程式碼 EBADF 引數s非合法的socket處理程式碼
EFAULT 引數中有一指標指向無法存取的記憶體空間。
ENOTSOCK 引數s為一檔案描述詞，非socket。
EINTR 被訊號所中斷。
EAGAIN 此動作會令程式阻斷，但引數s的socket為不可阻斷。
ENOBUFS 系統的緩衝記憶體不足
ENOMEM 核心記憶體不足
EINVAL 傳給系統呼叫的引數不正確。

範例 /*利用socket的UDP client
此程式會連線UDP server，並將鍵盤輸入的字串傳給server。
UDP server 範例請參考sendto（）。
*/
#include
#include
#include
#include
#include
#include
#include
#define PORT 2345
#define SERVER_IP “127.0.0.1”
main()
{
int s,len;
struct sockaddr_in addr;
int addr_len =sizeof(struct sockaddr_in);
char buffer[256];
/* 建立socket*/
if((s = socket(AF_INET,SOCK_DGRAM,0))<0){
perror(“socket”);
exit(1);
}
/* 填寫sockaddr_in*/
bzero(&addr,sizeof(addr));
addr.sin_family = AF_INET;
addr.sin_port = htons(PORT);
addr.sin_addr.s_addr = inet_addr(SERVER_IP);
while(1){
bzero(buffer,sizeof(buffer));
/* 從標準輸入裝置取得字串*/
len =read(STDIN_FILENO,buffer,sizeof(buffer));
/* 將字串傳送給server端*/
sendto(s,buffer,len,0,&addr,addr_len);
/* 接收server端返回的字串*/
len = recvfrom(s,buffer,sizeof(buffer),0,&addr,&addr_len);
printf(“receive: %s”,buffer);
}
}

執行 (先執行udp server 再執行udp client)
hello /*從鍵盤輸入字串*/
receive: hello /*server端返回來的字串*/

　

recvmsg（經socket接收資料）
相關函式 recv，recvfrom，send，sendto，sendmsg，socket

表標頭檔案 #include
#include

定義函式 int recvmsg(int s,struct msghdr *msg,unsigned int flags);

函式說明 recvmsg()用來接收遠端主機經指定的socket傳來的資料。引數s為已建立好連線的socket，如果利用UDP協議則不需經過連線操作。引數msg指向欲連線的資料結構內容，引數flags一般設0，詳細描述請參考send()。關於結構msghdr的定義請參考sendmsg()。

返回值成功則返回接收到的字元數，失敗則返回-1，錯誤原因存於errno中。

錯誤程式碼 EBADF 引數s非合法的socket處理程式碼。
EFAULT 引數中有一指標指向無法存取的記憶體空間
ENOTSOCK 引數s為一檔案描述詞，非socket。
EINTR 被訊號所中斷。
EAGAIN 此操作會令程式阻斷，但引數s的socket為不可阻斷。
ENOBUFS 系統的緩衝記憶體不足
ENOMEM 核心記憶體不足
EINVAL 傳給系統呼叫的引數不正確。

範例參考recvfrom()。

　

send（經socket傳送資料）
相關函式 sendto，sendmsg，recv，recvfrom，socket

表標頭檔案 #include
#include

定義函式 int send(int s,const void * msg,int len,unsigned int falgs);

函式說明 send()用來將資料由指定的socket 傳給對方主機。引數s為已建立好連線的socket。引數msg指向欲連線的資料內容，引數len則為資料長度。引數flags一般設0，其他數值定義如下
MSG_OOB 傳送的資料以out-of-band 送出。
MSG_DONTROUTE 取消路由表查詢
MSG_DONTWAIT 設定為不可阻斷運作
MSG_NOSIGNAL 此動作不願被SIGPIPE 訊號中斷。

返回值成功則返回實際傳送出去的字元數，失敗返回-1。錯誤原因存於errno

錯誤程式碼 EBADF 引數s 非合法的socket處理程式碼。
EFAULT 引數中有一指標指向無法存取的記憶體空間
ENOTSOCK 引數s為一檔案描述詞，非socket。
EINTR 被訊號所中斷。
EAGAIN 此操作會令程式阻斷，但引數s的socket為不可阻斷。
ENOBUFS 系統的緩衝記憶體不足
ENOMEM 核心記憶體不足
EINVAL 傳給系統呼叫的引數不正確。

範例參考connect()

　

sendmsg（經socket傳送資料）
相關函式 send，sendto，recv，recvfrom，recvmsg，socket

表標頭檔案 #include
#include

定義函式 int sendmsg(int s,const strcut msghdr *msg,unsigned int flags);

函式說明 sendmsg()用來將資料由指定的socket傳給對方主機。引數s為已建立好連線的socket，如果利用UDP協議則不需經過連線操作。引數msg 指向欲連線的資料結構內容，引數flags一般預設為0，詳細描述請參考send()。
結構msghdr定義如下
struct msghdr
{
void *msg_name; /*Address to send to /receive from . */
socklen_t msg_namelen; /* Length of addres data */
strcut iovec * msg_iov; /* Vector of data to send/receive into */
size_t msg_iovlen; /* Number of elements in the vector */
void * msg_control; /* Ancillary dat */
size_t msg_controllen; /* Ancillary data buffer length */
int msg_flags; /* Flags on received message */
};

返回值成功則返回實際傳送出去的字元數，失敗返回-1，錯誤原因存於errno

錯誤程式碼 EBADF 引數s 非合法的socket處理程式碼。
EFAULT 引數中有一指標指向無法存取的記憶體空間
ENOTSOCK 引數s為一檔案描述詞，非socket。
EINTR 被訊號所中斷。
EAGAIN 此操作會令程式阻斷，但引數s的socket為不可阻斷。
ENOBUFS 系統的緩衝記憶體不足
ENOMEM 核心記憶體不足
EINVAL 傳給系統呼叫的引數不正確。

範例參考sendto()。

　

sendto（經socket傳送資料）
相關函式 send , sendmsg,recv , recvfrom , socket

表標頭檔案 #include < sys/types.h >
#include < sys/socket.h >

定義函式 int sendto ( int s , const void * msg, int len, unsigned int flags, const
struct sockaddr * to , int tolen )

函式說明 sendto() 用來將資料由指定的socket傳給對方主機。引數s為已建好連線的socket,如果利用UDP協議則不需經過連線操作。引數msg指向欲連線的資料內容，引數flags 一般設0，詳細描述請參考send()。引數to用來指定欲傳送的網路地址，結構sockaddr請參考bind()。引數tolen為sockaddr的結果長度。

返回值成功則返回實際傳送出去的字元數，失敗返回－1，錯誤原因存於errno 中。

錯誤程式碼 EBADF 引數s非法的socket處理程式碼。
EFAULT 引數中有一指標指向無法存取的記憶體空間。
WNOTSOCK canshu s為一檔案描述詞，非socket。
EINTR 被訊號所中斷。
EAGAIN 此動作會令程式阻斷，但引數s的soket為補課阻斷的。
ENOBUFS 系統的緩衝記憶體不足。
EINVAL 傳給系統呼叫的引數不正確。

範例 #include < sys/types.h >
#include < sys/socket.h >
# include
#include
#define PORT 2345 /*使用的port*/
main(){
int sockfd,len;
struct sockaddr_in addr;
char buffer[256];
/*建立socket*/
if(sockfd=socket (AF_INET,SOCK_DGRAM,0))<0){
perror (“socket”);
exit(1);
}
/*填寫sockaddr_in 結構*/
bzero ( &addr, sizeof(addr) );
addr.sin_family=AF_INET;
addr.sin_port=htons(PORT);
addr.sin_addr=hton1(INADDR_ANY)
if (bind(sockfd, &addr, sizeof(addr))<0){
perror(“connect”);
exit(1);
}
while(1){
bezro(buffer,sizeof(buffer));
len = recvfrom(socket,buffer,sizeof(buffer), 0 , &addr &addr_len);
/*顯示client端的網路地址*/
printf(“receive from %s “ , inet_ntoa( addr.sin_addr));
/*將字串返回給client端*/
sendto(sockfd,buffer,len,0,&addr,addr_len);”
}
}

執行請參考recvfrom()

　

setprotoent（開啟網路協議的資料檔案）
相關函式 getprotobyname, getprotobynumber, endprotoent

表標頭檔案 #include

定義函式 void setprotoent (int stayopen);

函式說明 setprotoent()用來開啟/etc/protocols，如果引數stayopen值為1，則接下來的getprotobyname()或getprotobynumber()將不會自動關閉此檔案。

　

setservent（開啟主機網路服務的資料檔案）
相關函式 getservent, getservbyname, getservbyport, endservent

表標頭檔案 #include < netdb.h >

定義函式 void setservent (int stayopen);

函式說明 setservent()用來開啟/etc/services，如果引數stayopen值為1，則接下來的getservbyname()或getservbyport()將補回自動關閉檔案。

　

setsockopt（設定socket狀態）
相關函式 getsockopt

表標頭檔案 #include
#include

定義函式 int setsockopt(int s,int level,int optname,const void * optval,,socklen_toptlen);

函式說明 setsockopt()用來設定引數s所指定的socket狀態。引數level代表欲設定的網路層，一般設成SOL_SOCKET以存取socket層。引數optname代表欲設定的選項，有下列幾種數值:
SO_DEBUG 開啟或關閉排錯模式
SO_REUSEADDR 允許在bind（）過程中本地地址可重複使用
SO_TYPE 返回socket形態。
SO_ERROR 返回socket已發生的錯誤原因
SO_DONTROUTE 送出的資料包不要利用路由裝置來傳輸。
SO_BROADCAST 使用廣播方式傳送
SO_SNDBUF 設定送出的暫存區大小
SO_RCVBUF 設定接收的暫存區大小
SO_KEEPALIVE 定期確定連線是否已終止。
SO_OOBINLINE 當接收到OOB 資料時會馬上送至標準輸入裝置
SO_LINGER 確保資料安全且可靠的傳送出去。

引數 optval代表欲設定的值，引數optlen則為optval的長度。

返回值成功則返回0，若有錯誤則返回-1，錯誤原因存於errno。

附加說明 EBADF 引數s並非合法的socket處理程式碼
ENOTSOCK 引數s為一檔案描述詞，非socket
ENOPROTOOPT 引數optname指定的選項不正確。
EFAULT 引數optval指標指向無法存取的記憶體空間。

範例參考getsockopt()。

　

shutdown（終止socket通訊）
相關函式 socket，connect

表標頭檔案 #include

定義函式 int shutdown(int s,int how);

函式說明 shutdown()用來終止引數s所指定的socket連線。引數s是連線中的socket處理程式碼，引數how有下列幾種情況:
how=0 終止讀取操作。
how=1 終止傳送操作
how=2 終止讀取及傳送操作

返回值成功則返回0，失敗返回-1，錯誤原因存於errno。

錯誤程式碼 EBADF 引數s不是有效的socket處理程式碼
ENOTSOCK 引數s為一檔案描述詞，非socket
ENOTCONN 引數s指定的socket並未連線

　

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不合法

範例參考connect()。

Linux常用C函式—介面處理篇(轉)

相關文章