NAME 名 稱
netlink, PF_NETLINK - 內 核 與 用 戶 之 間 的 通 訊
SYNOPSIS 總 攬
#include
<asm/types.h>
#include <sys/socket.h>
#include <linux/netlink.h>
netlink_socket = socket(PF_NETLINK, socket_type, netlink_family);
DESCRIPTION 描 述
Netlink 用 於 在 內 核 模 塊 與 在 用 戶 地 址 空 間 中 的 進 程 之 間 傳 遞 消 息 的 。 它 包 含 了 用 於 用 戶 進 程 的 基 於 標 準 套 接 字 的 接 口 和 用 於 內 核 模 塊 的 一 個 內 部 核 心 API。 有 關 這 個 內 部 核 心 接 口 的 資 料 沒 有 包 含 在 此 手 冊 頁 中 。 同 樣 還 有 一 個 過 時 的 通 過 netlink 字 符 設 備 的 接 口 也 沒 有 包 含 在 此 , 它 只 是 提 供 向 下 兼 容 特 性 。
Netlink 是 一 個 面 向 數 據 包 的 服 務 。 SOCK_RAW 和 SOCK_DGRAM 都 是 socket_type 的 有 效 值 。 然 而 netlink 協 議 對 數 據 包 datagram 和 原 套 接 字 ( raw sockets) 並 不 作 區 分 。
netlink_family
選 擇 核 心 模 塊
或 netlink 組 進 行 通
訊 。 現 有 可 指
定 的 netlink 的 種 類
有 :
NETLINK_ROUTE 接 收 路 由
更 新 信 息 , 可
以 用 來 修 改 IPv4 的
路 由 表 。 (參 見
rtnetlink(7))。
NETLINK_FIREWALL 接 收 IPv4 防
火 牆 編 碼 發 送
的 數 據 包 。
NETLINK_ARPD 用 以 維 護
用 戶 地 址 空 間
裏 的 arp 表
NETLINK_ROUTE6 接 收 和 發
送 IPv6 路 由 表 更 新
消 息 。
NETLINK_IP6_FW 接 收 未 通
過 IPv6 防 火 牆 檢 查
的 數 據 包 (尚 未
實 現 )
NETLINK_TAPBASE...NETLINK_TAPBASE+15 是
ethertap 設 備 實 例 。
Ethertap 是 從 用 戶 程
序 空 間 對 以 太
網 驅 動 程 序 進
行 仿 真 的 “僞
”網 絡 通 道 設 備
。
NETLINK_SKIP
Enskip 的 保 留 選 項 。
NETLINK_USERSOCK 爲 今 後 用 戶 程 序 空 間 協 議 用 保 留 選 項 。
Netlink 數 據 信 息 由 具 有 一 個 或 多 個 nlmsghdr 數 據 報 頭 及 其 有 效 數 據 的 字 節 流 組 成 。 對 於 分 成 多 個 數 據 包 的 Netlink 信 息 , 數 據 報 頭 中 的 NLM_F_MULTI 標 誌 位 將 被 設 置 , 除 了 最 後 一 個 包 的 報 頭 具 有 標 誌 NLMSG_DONE外 。 字 節 流 應 只 能 用 標 準 的 NLMSG_* 宏 來 訪 問 , 參 閱 netlink(3).
Netlink 不 是 可 靠 的 協 議 。 它 只 是 儘 可 能 地 將 信 息 傳 輸 到 目 的 地 , 但 在 內 存 耗 盡 或 發 生 其 他 錯 誤 時 , 它 會 丟 失 信 息 。 爲 保 證 信 息 可 靠 傳 輸 , 可 以 設 置 標 誌 NLM_F_ACK 來 要 求 接 收 方 確 認 。 數 據 接 收 確 認 是 一 個 NLMSG_ERROR 數 據 包 , 包 中 的 出 錯 字 段 設 置 爲 0。 應 用 程 序 必 須 自 己 創 建 收 到 信 息 確 認 消 息 。 在 信 息 傳 送 過 程 中 , 內 核 一 直 (嘗 試 )對 每 個 出 錯 的 數 據 包 發 送 NLMSG_ERROR 消 息 。 用 戶 進 程 也 應 當 遵 循 這 一 個 慣 例 。 每 一 個 netlink 數 據 類 都 有 一 個 32位 廣 播 分 組 , 當 對 套 接 字 調 用 bind(2) 時 , sockaddr_nl 中 的 nl_groups 字 段 設 置 成 所 要 偵 聽 的 廣 播 組 的 位 掩 碼 。 其 默 認 值 爲 0, 表 示 不 接 收 任 何 廣 播 。 一 個 套 接 字 可 以 對 任 意 一 個 多 址 廣 播 組 廣 播 消 息 , 只 要 在 調 用 sendmsg(2) 或 調 用 connect(2) 時 , 將 位 掩 碼 nl_groups 設 置 成 要 發 送 消 息 的 廣 播 組 的 值 就 可 以 了 。 只 有 具 有 有 效 uid 爲 0 的 用 戶 或 具 有
CAP_NET_ADMIN 權 限 的 用 戶 纔 可 能 發 送 或 偵 聽 針 對 netlink 多 址 廣 播 組 的 消 息 。 任 何 一 個 對 多 址 廣 播 組 消 息 的 響 應 需 發 回 進 程 標 識 pid 和 廣 播 組 地 址 。
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; /* 造 成 出 錯
的 消 息 報 頭 */ }; 在
每 個nlmsghdr 後 跟 隨
着 有 效 數 據 。
nlmsg_type 可 以 成 爲
標 準 消 息 的 類
型 : NLMSG_NOOP 可 以
忽 略 的 消 息 ,
NLMSG_ERROR 發 出 錯 誤
發 生 的 消 息 ,
有 關 數 據 中 包
含 一 個 nlmsgerr 結 構
, NLMSG_DONE 一 個 多
數 據 包 消 息 結
束 的 信 息 。 一
個 netlink 類 通 常 指
定 更 多 的 消 息
類 型 , 請 參 閱
有 關 手 冊 頁 ,
如 NETLINK_ROUTE. 中 的
rtnetlink(7)
注 NLM_F_ATOMIC 要 求 用 戶 有 CAP_NET_ADMIN 或 超 級 用 戶 權 。
地 址 格 式
sockaddr_nl 描 述 了 在 用 戶 空 間 或 在 覈 心 空 間 裏 一 個 netlink 客 戶 對 象 的 數 據 結 構 。 一 個 sockaddr_nl 對 象 可 以 是 單 址 廣 播 或 對 一 個 netlink 多 址 組 (nl_groups 不 爲 0).
struct
sockaddr_nl
{
sa_family_t nl_family; /* AF_NETLINK */
unsigned short nl_pad; /* 零 */
pid_t nl_pid; /* 進 程 標 識
號 pid */
__u32 nl_groups; /* 多 址 廣 播
組 掩 碼 */ };
nl_pid 是 用 戶 空 間 中 netlink 的 進 程 標 識 號 pid, 如 果 是 在 內 核 時 此 值 爲 0。 nl_groups 是 一 個 代 表 neltlink 組 號 的 位 掩 碼 。
BUGS
本 手 冊 頁 並 不 完 整 。
NOTES 注 意
通 過 libnetlink 調 用 netlink 功 能 通 常 比 通 過 低 層 內 核 接 口 要 來 得 好 些 。
VERSIONS 版 本
netlink 套 接 字 接 口 是 Linux 2.2 新 特 性
Linux 2.0 支 持 更 多 的 基 於 netlink接 口 的 原 始 設 備 (作 爲 向 下 兼 容 特 性 , 這 些 設 備 目 前 仍 可 使 用 。 舊 接 口 特 性 沒 有 在 此 敘 述 。
另 見
cmsg(3), rtnetlink(7), netlink(3).
ftp://ftp.inr.ac.ru/ip-routing/iproute2* 有 關 libnetlink 部 分
[中 文 版 維 護 人 ]
LetBright <letbright [AT] netease.com>
[中 文 版 最 新 更 新 ]
2000/11/09
《 中 國 linux論 壇 man手 冊 頁 翻 譯 計 劃 》 :
跋
本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh