NetBSD kqueue的udata字段类型不一致：是否为Bug及上报渠道咨询

1. 是否属于NetBSD的Bug？ #

是，这属于文档一致性Bug：

• NetBSD 10.1的系统头文件sys/event.h中udata字段为intptr_t类型，本地man kqueue文档也与该实现匹配；
• 但官网在线手册及wiki教程仍标注udata为void*，与实际实现不符，属于文档未及时更新的问题。

2. 如何上报此类问题？ #

NetBSD的Bug提交可通过以下方式：

• 使用系统自带的send-pr工具：终端执行send-pr，按提示选择分类（推荐docs类），填写系统版本、问题详情，附上uname -a和grep udata /usr/include/sys/event.h的输出，明确说明官网文档与本地实现的差异；
• 通过NetBSD官方Bug跟踪系统提交：需提供清晰的版本信息、头文件内容、官网文档的错误位置描述，方便维护人员定位修复。

3. 兼容性代码的优雅写法（避免后续修复失效） #

不要在业务代码中零散写#ifdef类型转换，建议用宏封装udata的赋值与读取逻辑，后续NetBSD修复后仅需调整宏定义，业务代码无需改动：

#include <sys/event.h>

#ifdef __NetBSD__
// 适配NetBSD中udata为intptr_t的情况
#define KEVENT_SET_UDATA(kev, user_ptr)  ((kev).udata = (intptr_t)(user_ptr))
#define KEVENT_GET_UDATA(kev)            ((void*)((kev).udata))
#else
// 其他BSD/macOS系统的原生void*类型
#define KEVENT_SET_UDATA(kev, user_ptr)  ((kev).udata = (user_ptr))
#define KEVENT_GET_UDATA(kev)            ((kev).udata)
#endif

// 使用示例
struct MyData {
    int fd;
    char buffer[64];
};

int main() {
    struct kevent ev;
    struct MyData* data = malloc(sizeof(struct MyData));
    
    KEVENT_SET_UDATA(ev, data);
    // ... 注册事件等操作 ...
    
    // 读取udata
    struct MyData* retrieved = KEVENT_GET_UDATA(ev);
    return 0;
}

这种方式既解决了当前编译问题，又保证了代码可读性，后续若NetBSD将udata改回void*，删除__NetBSD__分支的宏定义即可，不会影响原有业务逻辑。

内容的提问来源于stack exchange，提问作者Thierry Lelegard