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

3.4 函数:find_vpid( )

文件包含:

        #include <linux/pid.h>

函数定义:

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

函数定义格式:struct pid *f ind_vpid(int nr)

函数功能描述:

此函数根据提供的局部进程号获取对应的进程描述符。

输入参数说明:

参数nr是int型变量,是进程对应的局部进程号,一般与进程号相同。

返回参数说明:

此函数的返回结果是struct pid结构体类型的指针变量,保存与参数提供的进程号对应的进程描述符信息,其定义及详细解释请读者自行参考本章函数f ind_get_pid( )分析文档的返回参数说明部分。

实例解析:

编写测试文件:f ind_vpid.c

头文件引用:

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

模块加载函数定义:

        static int __init find_vpid_init(void)
        {
            printk("into find_vpid_init.\n");
            struct pid *vpid =find_vpid(current->pid); //执行函数find_vpid( )获取当前进程描述符

            // 显示进程描述符信息
            printk("the count of the pid is :%d\n", vpid->count);
            printk("the level of the pid is :%d\n", vpid->level);

            // 显示子进程的进程号
            printk("the pid of the find_vpid is :%d\n", vpid->numbers[vpid->level].nr);

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

模块退出函数定义:

        static void __exit find_vpid_exit(void)
        {
            printk("Goodbye   find_vpid\n");
        }

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

        module_init(find_vpid_init);
        module_exit(find_vpid_exit);

实例运行结果及分析:

首先编译模块,执行命令insmod f ind_vpid.ko插入模块,然后执行命令dmesg -c查看内核输出信息,会出现如图3-4所示的结果。

图3-4 插入f ind_vpid模块系统输出信息

结果分析:

图3-4中首先利用函数f ind_vpid( )获取当前进程的进程描述符信息,函数f ind_vpid ( )执行之后,进程描述符的字段count的值为2, f ind_vpid( )不会增加进程count字段的值。而在图3-2中函数f ind_get_pid( )执行之后,进程描述符的字段count的值为3, f ind_get_pid( )会增加进程count字段的值,这是函数f ind_get_pid( )与函数f ind_vpid( )执行结果的唯一不同之处。