Beej 網絡編程指南第 12 篇：listen() 監聽連線佇列

listen() 函數原型

int listen(int sockfd, int backlog);

參數說明

• sockfd：由 socket() 返回的套接字描述符。
• backlog：待接受連線佇列的最大長度。系統通常將其截限於 SOMAXCONN（常見值 128 或 20）。建議設為 5~10 或 SOMAXCONN。

工作流程

1. 客戶端呼叫 connect() 發起連線。
2. 核心將連線請求放入該套接字的未完成連線佇列（SYN_RCVD 狀態）。
3. 三向交握完成後，連線移至已完成連線佇列（ESTABLISHED 狀態）。
4. 伺服器呼叫 accept() 從已完成佇列取出連線。

backlog 影響的是已完成連線佇列的上限（歷史上也包含未完成佇列，現代核心多分離）。佇列滿時，新連線請求可能被丟棄或返回 ECONNREFUSED。

典型調用順序

getaddrinfo();
socket();
bind();
listen();
/* accept() 迴圈 */

注意事項

• listen() 僅適用於 SOCK_STREAM（TCP）或 SOCK_SEQPACKET 套接字。
• 錯誤返回 -1，設定 errno（如 EADDRINUSE、EINVAL）。
• 若不呼叫 bind()，核心會隱式綁定一個臨時埠，但伺服器通常需固定埠。