Linux内核API __wake_up_sync_key

__wake_up_sync_key函数功能描述:此函数用于唤醒等待队列中处于特定状态的进程,此特定状态由第二个参数mode给出。当进程的状态满足此特定状态时就有可能被唤醒,获得CPU资源,从而被调度执行。此函数唤醒的进程不会改变进程之前所在的CPU,不会引起额外的CPU的抢占,并且可以同步唤醒进程。

__wake_up_sync_key文件包含

#include <linux/wait.h>

__wake_up_sync_key函数定义

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

函数定义格式:

void __wake_up_sync_key(wait_queue_head_t *q, unsigned int mode, int nr, void * key)

__wake_up_sync_key输入参数说明

此函数的输入参数与函数__wake_up( )的输入参数基本相同,详细信息参考__wake_up( )

__wake_up_sync_key返回参数说明

此函数的返回结果是一个void型的变量,即没有任何返回结果。

__wake_up_sync_key实例解析

编写测试文件:__wake_up_sync_key.c

头文件引用及全局变量定义:

/*头文件引用*/
#include <linux/module.h>
#include <linux/sched.h>
#include <linux/pid.h>
#include <linux/wait.h>
#include <linux/list.h>
#include <linux/kthread.h>
MODULE_LICENSE("GPL");

/*全局变量定义*/
static wait_queue_head_t head;  //等待队列头元素
struct task_struct * old_thread; //保存进程描述符信息

子进程处理函数定义:

int my_function(void * argc)
{
    printk("in the kernel thread function! \n");
    printk("the current pid is:%d\n", current->pid);      //显示当前进程的PID值

    /*显示父进程的状态*/
    printk("the state of the init funcation is :%ld\n", old_thread->state);
    __wake_up_sync_key(&head, TASK_ALL,0, NULL);          //调用函数唤醒等待队列中的进程

    // 显示函数调用之后的父进程的状态
    printk("the state of the init function after __wake_up_sync_key is :%ld\n", old_thread->state);
    printk("out the kernel thread function\n");
    return 0;
}

模块加载函数定义:

static int __init __wake_up_sync_key_init(void)
{
    char namefrm[]="__wake_up_sync_key.c%s";        //线程的输出类型名,在此无影响
    long time_out; //保存schedule_timeout_uninterruptible( )的返回结果
    struct task_struct * result;                   //保存新进程的信息
    wait_queue_t data;                              //等待队列元素
    printk("into __wake_up_sync_key_init.\n");
    result=kthread_create_on_node(my_function, NULL, -1, namefrm); //创建新进程
    printk("the pid of the new thread is:%d\n", result->pid); //显示新线程的PID值
    printk("the current pid is:%d\n", current->pid);            //显示当前进程的PID值

    init_waitqueue_head(&head);                     //初始化等待队列头元素
    init_waitqueue_entry(&data, current);           //用当前进程初始化等待队列中的一个元素
    add_wait_queue(&head, &data);                   //将等待队列元素加入等待队列中
    old_thread=current;                             //记录当前进程的信息
    wake_up_process(result);                        //唤醒新创建的线程
    time_out=schedule_timeout_uninterruptible(1000*10); //让当前进程进入睡眠状态

    //输出schedule_timeout_uninterruptible( )返回结果
    printk("the schedule timeout is:%ld\n", time_out);
    printk("out __wake_up_sync_key_init.\n");
    return 0;
}

模块退出函数定义:

static void __exit __wake_up_sync_key_exit(void)
{
            printk("Goodbye __wake_up_sync_key\n");
}

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

module_init(__wake_up_sync_key_init);
module_exit(__wake_up_sync_key_exit);

实例运行结果及分析:

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

Linux内核API __wake_up_sync_key

结果分析:

由上图可知模块初始化进程的进程号为6207,新进程的进程号为6208。在新进程中函数__wake_up_sync_key( )执行前模块初始化进程的状态值为2,即处于不可中断的等待状态,因为进程中执行了函数schedule_timeout_uninterruptible( )。函数__wake_up_sync_key( )执行后,模块初始化进程的状态值变为0,并且函数schedule_timeout_uninterruptible( )的返回结果是10000,说明父进程是被强制唤醒的,而非等待超时唤醒。由此可以说明函数__wake_up_sync_key( )能够唤醒等待队列中的满足条件的进程,此条件是进程所处的状态在函数的第二个参数所定义的状态范围内。

进程状态说明:

对于进程能够处于的状态,在函数__wake_up( )的进程状态说明部分有详细的说明。

Camera课程

Python教程

Java教程

Web教程

数据库教程

图形图像教程

办公软件教程

Linux教程

计算机教程

大数据教程

开发工具教程