/*
fd, 進(jìn)行監(jiān)聽的套接口的文件描述符
backlog，為指定連接隊列長度的最大值
*/
asmlinkage long sys_listen(int fd, int backlog)
{
struct socket *sock;
int err, fput_needed;
//根據(jù)文件描述符獲取套接口指針，同時返回是否需要減少對文件引用計數(shù)的標(biāo)志
sock = sockfd_lookup_light(fd, &err, &fput_needed);
if (sock) {
//對參數(shù)門限值做檢驗(yàn)，門限值不能超過上限
if ((unsigned)backlog > sysctl_somaxconn)
backlog = sysctl_somaxconn;
// 安全檢查
err = security_socket_listen(sock, backlog);
/*
通過套接口系統(tǒng)調(diào)用的跳轉(zhuǎn)表proto_ops結(jié)構(gòu)，調(diào)用對應(yīng)傳輸層協(xié)議中的 listen 操作。
SOCK_DGRAM 和 SOCK_RAW 類型不支持listen，只有 SOCK_STREAM 類型支持listen接口，
TCP中為 inet_listen()
*/
if (!err)
err = sock->ops->listen(sock, backlog); //inet_listen()
//根據(jù) fput_needed，調(diào)用fput_light減少對文件引用計數(shù)操作
fput_light(sock->file, fput_needed);
}
return err;
}
上述的函數(shù)功能就是通過文件描述符獲取對應(yīng)的套接口指針，然后調(diào)用 inet_listen 進(jìn)行監(jiān)聽操作。
int inet_listen(struct socket *sock, int backlog)
{
struct sock *sk = sock->sk;
unsigned char old_state;
int err;
lock_sock(sk);
/*
*只有插口的類型為 SOCK_STREAM，即“有連接”模式的插口，并且已經(jīng)為其 bind()了插口地址，才允許 listen()。
*對于符合這些條件的插口也不是什么時候都可以調(diào)用 listen()的。
*插口的 sock結(jié)構(gòu)中有個成分 state，用來實(shí)現(xiàn)一種“有限狀態(tài)機(jī)”。只有當(dāng)這個狀態(tài)機(jī)處于 TCP_CLOSE 或 TCP_LISTEN
*這兩種狀態(tài)時才可以對其調(diào)用 listen()。
*在前面 sock_create()的代碼中可以看到在創(chuàng)建一個插口時要調(diào)用函數(shù) sock_init_data()對分配的sock數(shù)據(jù)結(jié)構(gòu)進(jìn)行初始化，
*在那里state被設(shè)置成 TCP_CLOSE。
*狀態(tài)TCP_CLOSE 表示插口只是剛剛建立，尚未宣布成為 server 插口；
*TCP_LISTEN 則表示插口已經(jīng)設(shè)置成 server 插口，當(dāng)尚未建立起連接，并且不是在等待來自 client 一方的連接請求。
*只有在這兩種狀態(tài)下才允許改變插口的參數(shù)（主要是連接請求隊列的容量）。
*/
err = -EINVAL;
if (sock->state != SS_UNCONNECTED || sock->type != SOCK_STREAM)
goto out;
old_state = sk->sk_state;
if (!((1 << old_state) & (TCPF_CLOSE | TCPF_LISTEN)))
goto out;
/* Really, if the socket is already in listen state
? we can only allow the backlog to be adjusted.
/
if (old_state != TCP_LISTEN) {
err = inet_csk_listen_start(sk, backlog);/ 開始偵聽 */
if (err)
goto out;
}
sk->sk_max_ack_backlog = backlog;
err = 0;
out:
release_sock(sk);
return err;
}
int inet_csk_listen_start(struct sock *sk, const int nr_table_entries)
{
struct inet_sock *inet = inet_sk(sk);
struct inet_connection_sock *icsk = inet_csk(sk);
//創(chuàng)建接收隊列，并把該隊列和傳輸控制塊綁定
int rc = reqsk_queue_alloc(&icsk->icsk_accept_queue, nr_table_entries);
if (rc != 0)
return rc;
sk->sk_max_ack_backlog = 0;
sk->sk_ack_backlog = 0;
inet_csk_delack_init(sk);
/* There is race window here: we announce ourselves listening,
? but this transition is still not validated by get_port().
? It is OK, because this socket enters to hash table only
? after validation is complete.
/
/ 設(shè)置控制塊的狀態(tài) /
sk->sk_state = TCP_LISTEN;
/ 檢查端口是否仍然可用，防止bind()后其它進(jìn)程修改了端口信息 */
if (!sk->sk_prot->get_port(sk, inet->num)) { // tcp_v4_get_port()
inet->sport = htons(inet->num);
sk_dst_reset(sk);
/* 把sock鏈接入監(jiān)聽哈希表中 */
sk->sk_prot->hash(sk); // tcp_v4_hash
return 0;
}
sk->sk_state = TCP_CLOSE;
__reqsk_queue_destroy(&icsk->icsk_accept_queue);
return -EADDRINUSE;
}

int sysctl_max_syn_backlog = 256;
int reqsk_queue_alloc(struct request_sock_queue *queue,
unsigned int nr_table_entries)
{
size_t lopt_size = sizeof(struct listen_sock);
struct listen_sock *lopt;
/* nr_table_entries必需在[8, sysctl_max_syn_backlog]之間，默認(rèn)是[8, 256]
? 但實(shí)際上在sys_listen()中要求backlog <= sysctl_somaxconn（默認(rèn)為128）
? 所以此時默認(rèn)區(qū)間為[8, 128]
/
nr_table_entries = min_t(u32, nr_table_entries, sysctl_max_syn_backlog);
nr_table_entries = max_t(u32, nr_table_entries, 8);
/ 使nr_table_entries = 2^n，向上取整 */
nr_table_entries = roundup_pow_of_two(nr_table_entries + 1);
//為半連接隊列申請內(nèi)存
lopt_size += nr_table_entries * sizeof(struct request_sock );
if (lopt_size > PAGE_SIZE)
/ 如果申請內(nèi)存大于1頁，則申請?zhí)摂M地址連續(xù)的空間 /
lopt = __vmalloc(lopt_size,
GFP_KERNEL | __GFP_HIGHMEM | __GFP_ZERO,
PAGE_KERNEL);
else
/ 申請內(nèi)存在1頁內(nèi)，則申請物理地址連續(xù)的空間 */
lopt = kzalloc(lopt_size, GFP_KERNEL);
if (lopt == NULL)
return -ENOMEM;
for (lopt->max_qlen_log = 3;
(1 << lopt->max_qlen_log) < nr_table_entries;
lopt->max_qlen_log++);
/* 獲取一個隨機(jī)數(shù) */
get_random_bytes(&lopt->hash_rnd, sizeof(lopt->hash_rnd));
rwlock_init(&queue->syn_wait_lock);
//全連接隊列頭初始化
queue->rskq_accept_head = NULL;
// 半連接隊列的最大長度
lopt->nr_table_entries = nr_table_entries;
write_lock_bh(&queue->syn_wait_lock);
//半連接隊列設(shè)置
queue->listen_opt = lopt;
write_unlock_bh(&queue->syn_wait_lock);
return 0;
}