Man page - netlink(7)

Packages contains this manual

Available languages:

en fr ja ru zh_TW zh_CN

Manual

NETLINK

NAME 名 稱
SYNOPSIS 總 攬
DESCRIPTION 描 述
地 址 格 式
BUGS
NOTES 注 意
VERSIONS 版 本
另 見
[中 文 版 維 護 人 ]
[中 文 版 最 新 更 新 ]
《 中 國 linux論 壇 man手 冊 頁 翻 譯 計 劃 》 :
跋

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)

Image grohtml-687463-1.png

Image grohtml-687463-2.png

Image grohtml-687463-3.png

注 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@netease.com>

[中 文 版 最 新 更 新 ]

2000/11/09

《 中 國 linux論 壇 man手 冊 頁 翻 譯 計 劃 》 :

http://cmpp.linuxforum.net

跋

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