深入浅出：Linux内核第一宏 container_of 详解

本文链接：https://blog.csdn.net/Jay_515/article/details/148513844

本文面向Linux初学者，通过实例解析container_of宏的工作原理与应用场景

什么是`container_of`宏？

container_of是Linux内核中最重要且最常用的宏之一，它被称为"Linux内核第一宏"。这个宏的神奇之处在于：通过结构体成员的地址，反向获取包含该成员的完整结构体地址。

为什么需要这个宏？

在内核开发中，我们经常遇到这种情况：

某个结构体包含多种数据成员
我们只能访问到其中某个特定成员的指针
但实际需要操作的是整个结构体

这时container_of就派上用场了！它在链表实现、设备驱动、内核对象管理等场景中广泛应用。

`container_of`宏的定义

在Linux内核源码中（通常位于include/linux/kernel.h或include/linux/stddef.h），container_of的定义如下：

#define container_of(ptr, type, member) ({              \
    void *__mptr = (void *)(ptr);                   \
    static_assert(__same_type(*(ptr), ((type *)0)->member) ||   \
                  __same_type(*(ptr), void),        \
                  "pointer type mismatch in container_of()");   \
    ((type *)(__mptr - offsetof(type, member)); })

注：不同内核版本可能有细微差异，但核心思想相同

关键概念解析

1. 宏参数说明

参数	说明
`ptr`	指向结构体成员的指针
`type`	包含该成员的结构体类型
`member`	结构体中该成员的名称

2. `offsetof`宏

offsetof是另一个关键宏，用于计算结构体成员在结构体中的偏移量：

#define offsetof(TYPE, MEMBER) ((size_t)&((TYPE *)0)->MEMBER)

这个宏的巧妙之处在于：

将地址0强制转换为(TYPE *)类型
获取成员MEMBER的地址
这个地址值就是成员相对于结构体起始位置的偏移量

图解`container_of`工作原理

计算公式：

结构体地址 = 成员地址 - 成员在结构体中的偏移量

实际代码示例

基础示例

#include <stdio.h>
#include <stddef.h> // 包含offsetof定义

// 定义结构体
struct person {
    int age;
    char *name;
    double height;
};

// 简化版container_of实现
#define my_container_of(ptr, type, member) ({ \
    (type *)((char *)(ptr) - offsetof(type, member)); })

int main() {
    struct person john = {25, "John Doe", 180.0};
    
    // 获取name成员的指针
    char **name_ptr = &john.name;
    
    // 通过container_of获取完整结构体指针
    struct person *p = my_container_of(name_ptr, struct person, name);
    
    printf("Original struct address: %p\n", &john);
    printf("Calculated struct address: %p\n", p);
    printf("Name: %s\n", p->name);
    
    return 0;
}

内核链表应用实例

#include <stdio.h>
#include <stddef.h>

// 链表节点结构
struct list_head {
    struct list_head *next, *prev;
};

// 包含链表节点的用户结构
struct my_data {
    int id;
    char data[32];
    struct list_head list; // 内嵌链表节点
};

// container_of实现
#define container_of(ptr, type, member) ({ \
    (type *)((char *)(ptr) - offsetof(type, member)); })

int main() {
    struct my_data item1 = {1, "Sample Data", {NULL, NULL}};
    
    // 获取list成员的指针（模拟在链表遍历中得到的情况）
    struct list_head *list_ptr = &item1.list;
    
    // 通过container_of获取包含list的完整结构体
    struct my_data *parent = container_of(list_ptr, struct my_data, list);
    
    printf("ID: %d, Data: %s\n", parent->id, parent->data);
    
    return 0;
}