NETLINK 7

中文man手册

NAME 名称 netlink, PF_NETLINK
SYNOPSIS 总揽 .nf .
DESCRIPTION 描述 Netlink 用于在内核模块与在用户地址空间中的进程之间传递消息的。它包含了用于用户进程的基于标准套接字的接口和用于内核模块的一个内部核心 API。有关这个内部核心接口的资料没有包含在此手册页中。同样还有一个过时的通过 netlink 字符设备的接口也没有包含在此，它只是提供向下兼容特性。 Netlink 是一个面向数据包的服务。 .B SOCK_RAW 和 .B SOCK_DGRAM 都是 .IR socket_type 的有效值。然而 netlink 协议对数据包 datagram 和原套接字（raw sockets）并不作区分。 .I netlink_family 选择核心模块或 netlink 组进行通讯。现有可指定的 netlink 的种类有： .TP .B NETLINK_ROUTE 接收路由更新信息，可以用来修改 IPv4 的路由表。(参见 .BR rtnetlink (7))。 .TP .B NETLINK_FIREWALL 接收 IPv4 防火墙编码发送的数据包。 .TP .B NETLINK_ARPD 用以维护用户地址空间里的 arp 表 .TP .B NETLINK_ROUTE6 接收和发送 IPv6 路由表更新消息。 .TP .B NETLINK_IP6_FW 接收未通过 IPv6 防火墙检查的数据包(尚未实现) .TP .BR NETLINK_TAPBASE ... NETLINK_TAPBASE+15 是 .B ethertap 设备实例。Ethertap 是从用户程序空间对以太网驱动程序进行仿真的“伪”网络通道设备。 .TP .B NETLINK_SKIP Enskip 的保留选项。 .TP .B NETLINK_USERSOCK 为今后用户程序空间协议用保留选项。 .PP Netlink 数据信息由具有一个或多个 .B nlmsghdr 数据报头及其有效数据的字节流组成。对于分成多个数据包的 Netlink 信息，数据报头中的 .B NLM_F_MULTI 标志位将被设置，除了最后一个包的报头具有标志 .BR NLMSG_DONE 外。字节流应只能用标准的 .B NLMSG_* 宏来访问，参阅 .BR netlink (3). Netlink 不是可靠的协议。它只是尽可能地将信息传输到目的地，但在内存耗尽或发生其他错误时，它会丢失信息。为保证信息可靠传输，可以设置标志 .B NLM_F_ACK 来要求接收方确认。数据接收确认是一个 .B NLMSG_ERROR 数据包，包中的出错字段设置为 0。应用程序必须自己创建收到信息确认消息。在信息传送过程中，内核一直(尝试)对每个出错的数据包发送 .B NLMSG_ERROR 消息。用户进程也应当遵循这一个惯例。每一个 netlink 数据类都有一个32位广播分组，当对套接字调用 .BR bind (2) 时， .B sockaddr_nl 中的 .B nl_groups 字段设置成所要侦听的广播组的位掩码。其默认值为 0，表示不接收任何广播。一个套接字可以对任意一个多址广播组广播消息，只要在调用 .BR sendmsg (2) 或调用 .BR connect (2) 时，将位掩码 .B nl_groups 设置成要发送消息的广播组的值就可以了。只有具有有效 uid 为 0 的用户或具有 .B CAP_NET_ADMIN 权限的用户才可能发送或侦听针对 netlink 多址广播组的消息。任何一个对多址广播组消息的响应需发回进程标识 pid 和广播组地址。 .RS .nf .ta 4 13 25 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; /* 造成出错的消息报头*/ }; .ta .fi .RE 在每个 .B nlmsghdr 后跟随着有效数据。 .B nlmsg_type 可以成为标准消息的类型： .B NLMSG_NOOP 可以忽略的消息， .B NLMSG_ERROR 发出错误发生的消息，有关数据中包含一个 .I nlmsgerr 结构， .B NLMSG_DONE 一个多数据包消息结束的信息。 .
地址格式 .B sockaddr_nl 描述了在用户空间或在核心空间里一个 netlink 客户对象的数据结构。一个 sockaddr_nl 对象可以是单址广播或对一个 netlink 多址组 (nl_groups 不为 0). .RS .nf struct sockaddr_nl { sa_family_t nl_family; /* AF_NETLINK */ unsigned short nl_pad; /* 零 */ pid_t nl_pid; /* 进程标识号pid */ __u32 nl_groups; /* 多址广播组掩码*/ }; .fi .RE .B nl_pid 是用户空间中 netlink 的进程标识号 pid，如果是在内核时此值为 0。 .B nl_groups 是一个代表 neltlink 组号的位掩码。 .
BUGS 本手册页并不完整。 .SH NOTES 注意通过 .B libnetlink 调用 netlink 功能通常比通过低层内核接口要来得好些。 .SH VERSIONS 版本 netlink 套接字接口是 Linux 2.2 新特性 Linux 2.0 支持更多的基于netlink接口的原始设备(作为向下兼容特性，这些设备目前仍可使用。旧接口特性没有在此叙述。 .SH 另见 .BR cmsg (3), .BR rtnetlink (7), .BR netlink (3). .PP .BR ftp://ftp.inr.ac.ru/ip-routing/iproute2* 有关 libnetlink 部分 .SH
[中文版最新更新]
《中国linux论坛man手册页翻译计划》:
跋

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 æ¯ä¸ä¸ªé¢åæ°æ®åçæå¡ã SOCK_RAW å SOCK_DGRAM é½æ¯ socket_type çææå¼ãç¶è netlink åè®®å¯¹æ°æ®å datagram ååå¥æ¥åï¼raw socketsï¼ å¹¶ä¸ä½åºåã

netlink_family éæ©æ ¸å¿æ¨¡åæ netlink ç»è¿è¡éè®¯ãç°æå¯æå®ç netlink çç§ç±»æï¼
NETLINK_ROUTE

NETLINK_FIREWALL

æ¥æ¶ IPv4 é²ç«å¢ç¼ç åéçæ°æ®åã

NETLINK_ARPD

ç¨ä»¥ç»´æ¤ç¨æ·å°åç©ºé´éç arp è¡¨

NETLINK_ROUTE6

æ¥æ¶ååé IPv6 è·¯ç±è¡¨æ´æ°æ¶æ¯ã

NETLINK_IP6_FW

æ¥æ¶æªéè¿ IPv6 é²ç«å¢æ£æ¥çæ°æ®å(å°æªå®ç°)

NETLINK_TAPBASE...NETLINK_TAPBASE+15

NETLINK_SKIP

Enskip çä¿çéé¡¹ã

NETLINK_USERSOCK

ä¸ºä»åç¨æ·ç¨åºç©ºé´åè®®ç¨ä¿çéé¡¹ã

Netlink æ°æ®ä¿¡æ¯ç±å·æä¸ä¸ªæå¤ä¸ª nlmsghdr æ°æ®æ¥å¤´åå¶æææ°æ®çå- èæµç»æãå¯¹äºåæå¤ä¸ªæ°æ®åç Netlink ä¿¡æ¯ï¼ æ°æ®æ¥å¤´ä¸ç NLM_F_MULTI æ å¿ä½å°è¢«è®¾ç½®ï¼é¤äºæåä¸ä¸ªåçæ¥å¤´å·ææ å¿ NLMSG_DONEå¤ã å- èæµåºåªè½ç¨æ åç NLMSG_* å®æ¥è®¿é®ï¼åé netlink(3).

æ¯ä¸ä¸ª netlink æ°æ®ç±»é½æä¸ä¸ª32ä½å¹¿æåç»ï¼å½ å¯¹å¥æ¥åè°ç¨ bind(2) æ¶ï¼ sockaddr_nl ä¸ç nl_groups åæ®µè®¾ç½®ææè¦ä¾¦å¬çå¹¿æ- ç»çä½æ©ç ãå¶é»è®¤å¼ä¸º 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-3015223-1.png

Image grohtml-3015223-2.png

Image grohtml-3015223-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 æ°ç¹æ§

å¦è§

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

手册导航

man1

man2

man3

man4

man5

man6

man7

man8