listen()
告訴 socket 要監聽(listen)請求的連線

函式原型

1
#include <sys/socket.h>
2
3
int listen(int s, int backlog);
Copied!

說明

你可以用你的 socket descriptor(利用 socket() system call 建立的),並將它提供給 listen() 用來聽取請求的連線。各位,這就是 server 與 clients 的差異。
參數 backlog 代表在 kernel 開始拒絕新連線以前,你可以有多少的連線在等待。所以當新的連線進入時,你應該盡快的用 accept() 來處理,讓 backlog 不會滿出來。試著將它設定成 10 之類,然後在高負載時,若你的 clients 開始出現"拒絕連線"時要試著將值提高。
在呼叫 listen() 以前,你的 server 應該要先呼叫 bind(),將 socket 綁定到一個 port number,這個 port number 跟 server 的 IP address 是用來讓 clients 連線的。

傳回值

成功時傳回零,或者錯誤時傳回 -1(並設定對應的 errno)。

範例

1
struct addrinfo hints, *res;
2
int sockfd;
3
4
// 首先,使用 getaddrinfo() 載入位址結構:
5
6
memset(&hints, 0, sizeof hints);
7
hints.ai_family = AF_UNSPEC; // 使用 IPv4 或 IPv6,兩者皆可
8
hints.ai_socktype = SOCK_STREAM;
9
hints.ai_flags = AI_PASSIVE; // 幫我填上我的 IP
10
11
getaddrinfo(NULL, "3490", &hints, &res);
12
13
// 建立 socket:
14
15
sockfd = socket(res->ai_family, res->ai_socktype, res->ai_protocol);
16
17
// 將它綁定到我們於 getaddrinfo() 中傳遞的 port:
18
19
bind(sockfd, res->ai_addr, res->ai_addrlen);
20
21
listen(sockfd, 10); // 將 s 設定為 server(監聽的)的 socket
22
23
// 接著這裡會有個迴圈用來呼叫 accept() 接受連線
Copied!

參考

accept(), bind(), socket()