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-1180807-1.png

Image grohtml-1180807-2.png

Image grohtml-1180807-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