Linux内核API完全参考手册(第2版)
上QQ阅读APP看书,第一时间看更新

3.13 函数:task_active_pid_ns( )

文件包含:

        #include <linux/pid_namespace.h>

函数定义:

在内核源码中的位置:linux-3.19.3/kernel/pid.c

函数定义格式:struct pid_namespace *task_active_pid_ns(struct task_struct *tsk)

函数功能描述:

此函数用于获取任务中包含进程的命名空间信息,函数执行如下:首先调用函数task_pid( )获得任务字段pids[PIDTYPE_PID]的pid值,然后调用函数ns_of_pid( )获取函数task_pid( )返回值的命名空间信息。

输入参数说明:

参数tsk是struct task_struct结构体类型的变量指针,保存任务描述符信息,其定义参见内核源码文件linux-3.19.3/include/linux/sched.h,内核注释比较详细,请读者自行分析。

返回参数说明:

函数返回结果是struct pid_namespace型变量,是对进程命名空间信息的描述,其定义及详细解释请读者自行参考本章函数__task_pid_nr_ns( )分析文档的输入参数说明部分。

实例解析:

编写测试文件:task_active_pid_ns.c

头文件引用:

        #include <linux/module.h>
        #include <linux/sched.h>
        #include <linux/pid.h>
        #include <linux/pid_namespace.h>
        MODULE_LICENSE("GPL");

模块加载函数定义:

        static int __init task_active_pid_ns_init(void)
        {
            printk("into task_active_pid_ns_init.\n");
            struct pid * kpid=find_get_pid(current->pid);           //获取当前进程描述符
            struct task_struct * task=pid_task(kpid, PIDTYPE_PID); //获取任务描述符
            struct pid_namespace * ns=task_active_pid_ns(task);     //获取任务中进程的命名空间

            // 显示进程的PID
            printk("the pid of the find_get_pid result is :%d\n", kpid->numbers[kpid->level].nr);

            // 显示命名空间字段last_pid的值
            printk("the last_pid of the task_active_pid_ns result is:%d\n", ns->last_pid);

            printk("the pid of current thread is :%d\n", current->pid); //显示当前进程的PID
            printk("out task_active_pid_ns_init.\n");
              return 0;
          }

模块退出函数定义:

        static void __exit task_active_pid_ns_exit(void)
        {
            printk("Goodbye task_active_pid_ns\n");
        }

模块加载、退出函数调用:

        module_init(task_active_pid_ns_init);
        module_exit(task_active_pid_ns_exit);

实例运行结果及分析:

首先编译模块,执行命令insmod task_active_pid_ns.ko插入模块,然后执行命令dmesg -c,会出现如图3-13所示的结果。

图3-13 插入task_active_pid_ns模块系统输出信息

结果分析:

由图3-13可以看出函数task_active_pid_ns( )能够获得与任务相对应的进程的命名空间信息,当前进程的PID值为17353,命名空间的字段last_pid的值也为17353,因为此进程只被目前一个任务使用,所以任务对应进程的命名空间的last_pid和此任务的进程的PID值相同。