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