Manpages

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_RAWSOCK_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+15ethertap 設 備 實 例 。 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手 冊 頁 翻 譯 計 劃 》 :

http://cmpp.linuxforum.net

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 : https://github.com/man-pages-zh/manpages-zh