Go genetlink 怎样查询Generic Netlink家族编号

在 Go 中使用 github.com/mdlayher/genetlink 时，不需要自己猜 Generic Netlink 家族编号。最稳妥的做法是先建立 genetlink.Conn，再用家族名称调用 GetFamily，最后从返回值 Family.ID 读取编号。这个编号的类型是 uint16，可以直接作为后续 Execute 或 Send 的目标家族参数。

官方地址：https://pkg.go.dev/github.com/mdlayher/genetlink

一句话记忆：名称用于查询，Family.ID 用于发请求，Family.Version 用于组织消息头；不要把某台机器上的数字编号硬编码到所有环境。

先看清家族编号从哪里来

Generic Netlink 的调用通常有两个名字：一个是开发者容易记住的家族名称，例如 nl80211；另一个是内核连接真正使用的数字家族编号。genetlink.Conn.GetFamily(name) 把前者解析成 genetlink.Family，这个结构除了 ID，还包含 Name、Version 和多播组信息。

因此，文章里的“查询编号”不是遍历一张本地常量表，而是查询当前 Generic Netlink 控制器注册的家族信息。连接、查询结果和后续请求的关系可以按下面的静态结构理解。

第一步：建立并正确关闭 genetlink.Conn

使用高层接口时，直接调用 genetlink.Dial(nil) 即可创建连接。配置参数传入 nil 时，库会采用底层 netlink 连接的默认配置。连接创建成功后要立刻安排 defer c.Close()，这样查询过程返回或出错时都能释放资源。

package main

import (
    "errors"
    "fmt"
    "log"
    "os"

    "github.com/mdlayher/genetlink"
)

func main() {
    // Dial 建立 Generic Netlink 连接；nil 表示使用默认底层配置。
    c, err := genetlink.Dial(nil)
    if err != nil {
        log.Fatalf("连接 Generic Netlink 失败: %v", err)
    }
    // 查询和后续请求结束后关闭连接，避免把套接字留在进程中。
    defer c.Close()

    const familyName = "nl80211"
    family, err := c.GetFamily(familyName)
    if err != nil {
        // 家族未注册时单独处理；其它错误仍然保留原始原因。
        if errors.Is(err, os.ErrNotExist) {
            fmt.Printf("家族 %q 当前不可用\n", familyName)
            return
        }
        log.Fatalf("查询家族 %q 失败: %v", familyName, err)
    }

    // ID 是当前环境返回的数字家族编号，Version 是消息头需要的版本。
    fmt.Printf("name=%s id=%d version=%d groups=%d\n",
        family.Name, family.ID, family.Version, len(family.Groups))
}

这里的关键不是打印，而是 family.ID 的来源：它由 GetFamily 返回的 Family 携带。查询成功后，应用可以把这个字段保存到当前请求的局部变量中，再继续构造消息。

第二步：用 GetFamily 按名称查询

GetFamily 的参数是字符串家族名，返回值是 (genetlink.Family, error)。如果只关心编号，可以写成 family.ID；但建议同时保留 Name 和 Version，因为日志和后续请求都需要它们解释当前目标。

家族名称不是随意写的业务别名，而是对应内核或驱动注册的 Generic Netlink family。比如示例中的 nl80211 是无线网络相关家族；如果目标内核没有注册它，查询会进入不存在分支。

第三步：读取 Family.ID，而不是硬编码数字

Family.ID 的声明类型是 uint16。它适合直接传给 Conn.Execute 的 family uint16 参数，也适合传给 Conn.Send。不要把一次查询得到的数字抄成包级常量：不同内核、模块加载顺序或运行环境可能让同名家族的编号发生变化。

可以把返回的元数据看成一个小型查询结果：

第四步：把 Family.ID 交给 Execute

得到家族后，真正发送业务命令时通常还要准备 genetlink.Message。消息头放命令和版本，Execute 的第二个参数放家族编号，第三个参数放 netlink 标志。这里的命令值和属性编号必须来自目标家族对应的内核头文件或官方文档，不能因为已经拿到了 ID 就猜其它字段。

// family 已由 c.GetFamily(name) 得到；命令值应按目标家族的定义填写。
const commandGet = 1

req := genetlink.Message{
    Header: genetlink.Header{
        // Command 是目标家族理解的命令，Version 来自查询结果。
        Command: commandGet,
        Version: family.Version,
    },
}

// family.ID 指定请求发送到哪个 Generic Netlink 家族。
messages, err := c.Execute(req, family.ID, netlink.Request|netlink.Dump)
if err != nil {
    // Execute 会发送请求、接收回复并检查回复是否匹配请求。
    return fmt.Errorf("执行家族 %q 的命令失败: %w", family.Name, err)
}
_ = messages // 按目标家族定义解码每条回复的 Data。

上面的片段只展示编号与请求接口的衔接，命令常量使用占位值是为了突出结构；接入具体家族时，必须替换为该家族定义的命令，并按其属性格式解码 Message.Data。

第五步：正确区分家族不存在和连接错误

官方文档明确说明，家族不存在时返回的错误可以用 errors.Is(err, os.ErrNotExist) 检查。这个分支适合做能力探测，例如当前内核没有某个可选模块时记录“不可用”并退出当前功能。

不能把所有错误都当成“编号不存在”。连接失败、权限问题、底层套接字错误或回复处理失败，都应该保留原始错误并交给上层决定是否重试。使用 %w 包装错误，可以让调用方继续用 errors.Is 或 errors.As 判断原因。

第六步：不知道名称时用 ListFamilies 排查

如果你只知道环境里“应该有某个家族”，却不知道注册名，ListFamilies 可以返回当前已注册的全部 []genetlink.Family。它适合诊断环境差异和打印可用能力，不适合代替已知名称的定向查询。

families, err := c.ListFamilies()
if err != nil {
    // 列表查询失败时保留底层错误，便于上层判断连接是否需要重建。
    return fmt.Errorf("列出 Generic Netlink 家族失败: %w", err)
}

for _, family := range families {
    // 只打印查询结果中的稳定字段，不把编号写回配置文件。
    log.Printf("family=%s id=%d version=%d", family.Name, family.ID, family.Version)
}

常见问题

为什么不直接写一个固定的家族编号？

因为编号是当前 Generic Netlink 控制器返回的运行环境数据。应用真正知道的是家族名称，启动或建立连接后再查询，才能适应不同环境。

Family.ID 和 Family.Version 是一回事吗？

不是。ID 选择目标家族，Version 属于家族消息头的版本字段；二者在后续请求中承担不同职责。

GetFamily 查询不到家族怎么办？

先用 errors.Is(err, os.ErrNotExist) 判断是否确实没有注册，再决定降级或提示。若不是该错误，应保留原始错误，不要通过换一个数字编号绕过查询。

什么时候应该调用 ListFamilies？

当名称来源不明确、需要诊断机器差异或想输出能力清单时使用。已知家族名称的正常业务路径仍优先使用 GetFamily，结果更直接。

总结

Go genetlink 查询 Generic Netlink 家族编号可以收敛为一条清晰的数据链：用 Dial 得到连接，用 GetFamily(name) 得到 Family，从 Family.ID 取出当前环境的编号，再把它交给 Execute 或 Send。同时保留 Family.Version 和原始错误，就能让后续请求既知道发给谁，也能在家族缺失或连接失败时作出正确处理。