.\" t
.\" Don't change the first line, it tells man that tbl is needed.
.\" This man page copyright 1998 by Andi Kleen. Subject to the GPL.
.\" This manpage copyright 1998 by Andi Kleen. Subject to the GPL.
.\" Based on the original comments from Alexey Kuznetsov
.\" 中文版 Copyright (c) 2000 LetBright，BitBIRD 和 www.linuxforum.net
.TH NETLINK 7 "27 Apr 1999" "Linux Man Page" "Linux Programmer's Manual"
.SH NAME 名稱
netlink, PF_NETLINK \- 核心與使用者之間的通訊
.SH SYNOPSIS 總攬
.nf
.\" XXX
.B #include <asm/types.h>
.br
.B #include <sys/socket.h>
.br
.B #include <linux/netlink.h> 
.br
.PP
.BI "netlink_socket = socket(PF_NETLINK, " socket_type ", " netlink_family ); 
.SH DESCRIPTION 描述
Netlink 用於在核心模組與在使用者地址空間中的程序之間傳遞訊息的。它包
含了用於使用者程序的基於標準套接字的介面和用於核心模組的一個內部核心
API。有關這個內部核心介面的資料沒有包含在此手冊頁中。同樣還有
一個過時的透過 netlink 字元裝置的介面也沒有包含在此，它只是提供
向下相容特性。

Netlink 是一個面向資料包的服務。
.B SOCK_RAW
和
.B SOCK_DGRAM
都是
.IR socket_type
的有效值。然而 netlink 協議對資料包 datagram 和原套接字（raw sockets）
並不作區分。

.I netlink_family
選擇核心模組或 netlink 組進行通訊。現有可指定的 netlink 的種類有： 
.TP
.B NETLINK_ROUTE
接收路由更新資訊，可以用來修改 IPv4 的路由表。(參見
.BR rtnetlink (7))。
.TP
.B NETLINK_FIREWALL
接收 IPv4 防火牆編碼傳送的資料包。
.TP
.B NETLINK_ARPD
用以維護使用者地址空間裡的 arp 表
.TP
.B NETLINK_ROUTE6
接收和傳送 IPv6 路由表更新訊息。
.TP
.B NETLINK_IP6_FW
接收未透過 IPv6 防火牆檢查的資料包(尚未實現)
.TP
.BR NETLINK_TAPBASE ... NETLINK_TAPBASE+15
是
.B ethertap
裝置例項。Ethertap 是從使用者程式空間對乙太網驅動程式進行
模擬的“偽”網路通道裝置。
.TP
.B NETLINK_SKIP
Enskip 的保留選項。
.TP
.B NETLINK_USERSOCK
為今後使用者程式空間協議用保留選項。
.PP
Netlink 資料資訊由具有一個或多個
.B nlmsghdr
資料報頭及其有效資料的位元組流組成。對於分成多個數據包的 Netlink 資訊，
資料報頭中的
.B NLM_F_MULTI
標誌位將被設定，除了最後一個包的報頭具有標誌
.BR NLMSG_DONE 外。
位元組流應只能用標準的
.B NLMSG_*
宏來訪問，參閱
.BR netlink (3). 

Netlink 不是可靠的協議。它只是儘可能地將資訊傳輸到目的地，但在記憶體耗
盡或發生其他錯誤時，它會丟失資訊。為保證資訊可靠傳輸，可以設定標誌
.B NLM_F_ACK
來要求接收方確認。資料接收確認是一個
.B NLMSG_ERROR
資料包，包中的出錯欄位設定為 0。應用程式必須自己建立收到資訊確認訊息。
在資訊傳送過程中，核心一直(嘗試)對每個出錯的資料包傳送
.B NLMSG_ERROR
訊息。使用者程序也應當遵循這一個慣例。

每一個 netlink 資料類都有一個32位廣播分組，當
對套接字呼叫
.BR bind (2)
時， 
.B sockaddr_nl
中的
.B nl_groups
欄位設定成所要偵聽的廣播組的位掩碼。其預設值為 0，表示不接收任何廣播。

一個套接字可以對任意一個多址廣播組廣播訊息，只要在呼叫
.BR sendmsg (2) 
或呼叫
.BR connect (2) 
時，將位掩碼
.B nl_groups
設定成要傳送訊息的廣播組的值就可以了。
只有具有有效 uid 為 0 的使用者或具有

.B CAP_NET_ADMIN
許可權的使用者才可能傳送或偵聽針對 netlink 多址廣播組的訊息。
任何一個對多址廣播組訊息的響應需發回程序標識 pid 和廣播組地址。

.RS
.nf
.ta 4 13 25
struct nlmsghdr
{
__u32 nlmsg_len; /* 包括報頭在內的訊息長度*/
__u16 nlmsg_type; /* 訊息正文 */
__u16 nlmsg_flags; /* 附加標誌*/
__u32 nlmsg_seq; /* 序列號*/
__u32 nlmsg_pid; /* 傳送程序號 PID */
};


struct nlmsgerr
{
int error; /* 負數表示的出錯號 errno 或為 0 要求確認 acks*/ 
struct nlmsghdr msg; /* 造成出錯的訊息報頭*/ 
};
.ta
.fi
.RE

在每個
.B nlmsghdr
後跟隨著有效資料。
.B nlmsg_type
可以成為標準訊息的型別：
.B NLMSG_NOOP
可以忽略的訊息，
.B NLMSG_ERROR
發出錯誤發生的訊息，有關資料中包含一個 
.I nlmsgerr 
結構，
.B NLMSG_DONE
一個多資料包訊息結束的資訊。
.\" 2.1.130 好象不再使用它。
.\" .B NLMSG_OVERRUN
.\" 資料丟棄. 

一個 netlink 類通常指定更多的訊息型別，請參閱有關手冊頁，如
.IR NETLINK_ROUTE .
中的 
.BR rtnetlink (7)

.TS 
tab(:); 
l s 
l l.
nlmsg_flags 的標準標誌位
NLM_F_REQUEST: 設定全部請求訊息
NLM_F_MULTI:T{
此訊息是多資料包訊息之一，透過標誌
.B NLMSG_DONE
結束。
.\" XXX describe that
T}
NLM_F_ACK: 資料成功接收返回確認訊息
NLM_F_ECHO: 要求響應請求資訊
.TE

.TS
tab(:);
l s 
l l.
為 GET 請求設立的附加標誌位
NLM_F_ROOT: 返回物件表而不是單個數據項
NLM_F_MATCH: 尚未實現
NLM_F_ATOMIC: 返回物件表的原子快照(atomic snapshot) 
NLM_F_DUMP: 尚未列入文件
.TE

.TS
tab(:);
l s
l l.
對新建 NEW 請求設立的附加標誌位
NLM_F_REPLACE: 替換現有的物件
NLM_F_EXCL: 如物件已存在，不作替換
NLM_F_CREATE: 建立物件，如果物件不存在
NLM_F_APPEND: 物件表新增物件項
.TE

注 NLM_F_ATOMIC 要求使用者有 CAP_NET_ADMIN 或超級使用者權。

.SH 地址格式

.B sockaddr_nl
描述了在使用者空間或在核心空間裡一個 netlink 客戶物件的資料結構。
一個 sockaddr_nl 物件可以是單址廣播或對一個 netlink 多址組
(nl_groups 不為 0).

.RS
.nf
struct sockaddr_nl
{
sa_family_t nl_family; /* AF_NETLINK */
unsigned short nl_pad; /* 零 */
pid_t nl_pid; /* 程序標識號pid */
__u32 nl_groups; /* 多址廣播組掩碼*/
};
.fi
.RE

.B nl_pid 
是使用者空間中 netlink 的程序標識號 pid，如果是在核心時此值為 0。
.B nl_groups 
是一個代表 neltlink 組號的位掩碼。
.\" XXX describe what that is. 


.SH BUGS
本手冊頁並不完整。


.SH  NOTES 注意
透過
.B libnetlink
呼叫 netlink 功能通常比透過低層核心介面要來得好些。


.SH VERSIONS 版本
netlink 套接字介面是 Linux 2.2 新特性

Linux 2.0 支援更多的基於netlink介面的原始裝置(作為向下相容特性，
這些裝置目前仍可使用。舊介面特性沒有在此敘述。

.SH 另見
.BR cmsg (3),
.BR rtnetlink (7),
.BR netlink (3).
.PP
.BR ftp://ftp.inr.ac.ru/ip-routing/iproute2* 
有關 libnetlink 部分

.SH "[中文版維護人]"
.B LetBright <letbright@netease.com>
.SH "[中文版最新更新]"
.B 2000/11/09
.SH "《中國linux論壇man手冊頁翻譯計劃》:"
.BI http://cmpp.linuxforum.net
.SH "跋"
.br
本頁面中文版由中文 man 手冊頁計劃提供。
.br
中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR