kernel thread, wait queue, /proc/sys/kernel entry, call usermode handler in kernel mode

 

author: Joseph(Honggang Yang)@dslab // ganggexiongqi@126.com

date: 05-10-2011

Key words: kernel thread, wait queue, /proc/sys/kernel entry, call usermode handler in kernel mode

====================================================

 

In this section I will show you how to create two kernel threads.

One for process control, the other used to monitor kernel structure.

When kernel structure looks in trouble, the monitor wake up the process kernel thread.

The process kernel thread will call userspace application to handle the error.

In our case, we just print a string to /var/log/messages file.

 

NOTE : Before doing this experiment, you have to registered /proc/sys/kernel/myevent_handler entry.

      ref: http://blog.csdn.net/ganggexiongqi/archive/2011/05/10/6410223.aspx

---------------------------------------------------------------------------------------------------------------------------

1. Code

 

 

// test.c #include <linux/init.h> #include <linux/module.h> #include <linux/sched.h> #include <linux/kthread.h> #include <linux/sysctl.h> MODULE_LICENSE("Dual BSD/GPL"); static DECLARE_WAIT_QUEUE_HEAD(myevent_waitqueue); rwlock_t myevent_lock; /*extern*/ unsigned int myevent_id; //Holds the idendtity of the troubled data structure static void run_umode_handler(int event_id) { int i = 0; char *argv[2], *envp[4], *buffer = NULL; int value; printk("%s is starting .../n", __func__); argv[i++] = myevent_handler; // Defined in kernel/sysctl.c // Fill in the id corresponding to the data structure in trouble if (!(buffer = kmalloc(32, GFP_KERNEL))) return; sprintf(buffer, "TROUBLED_DS=%d", event_id); //If no user mode handlers are found, return if (!argv[0]) return; argv[i] = 0; // Prepare the environment for /path/to/helper i = 0; envp[i++] = "HOME=/"; envp[i++] = "PATH=/sbin:/usr/sbin:/bin:/usr/bin"; envp[i++] = buffer; envp[i] = 0; //Excute the user mode program, /path/to/helper printk("argv[0] is %s/n", argv[0]); value = call_usermodehelper(argv[0], argv, envp, 0); kfree(buffer); } static int monitor(void* unused) { daemonize("josephMonitor"); allow_signal(SIGKILL); write_lock(&myevent_lock);//serialize //Fill in the identity of the dat#!/bin/bash echo Kernel datastructure $TROUBLED_DS is in trouble >> /var/log/messages a structure myevent_id = 9527;//here let make it 9527 write_unlock(&myevent_lock); // Wake up mykthread wake_up_interruptible(&myevent_waitqueue); //set_current_state(TASK_RUNNING); printk("monitor out/n"); return 0; } static int mykthread(void* unused) { unsigned int event_id = 0; DECLARE_WAITQUEUE(wait, current); daemonize("josephThread");//become a kernel thread without attached user resources // reuest delivery of SIGKILL allow_signal(SIGKILL); /* The thread sleeps on this wait queue until it's woken up by parts of the kernel in charge of sensing the health of data structures of interest */ add_wait_queue(&myevent_waitqueue, &wait); for(;;) { //relinquish the processor until the event occurs set_current_state(TASK_INTERRUPTIBLE); schedule();//allow other parts of the kernel to run //Die if I receive SIGKILL if (signal_pending(current)) break; // Control gets here when the thread is woken up read_lock(&myevent_lock);//critical section starts if (myevent_id) { event_id = myevent_id; read_unlock(&myevent_lock);// critical section ends //invoke the registered user mode helper and //pass the identity code in itis environment run_umode_handler(event_id); break;// exit } else { read_unlock(&myevent_lock); } } printk("josephThread out/n"); set_current_state(TASK_RUNNING); remove_wait_queue(&myevent_waitqueue, &wait); return 0; } static int hello_init(void) { rwlock_init(&myevent_lock);// init the read/write<mce:script type="text/javascript" src="http://hi.images.csdn.net/js/blog/tiny_mce/themes/advanced/langs/zh.js" mce_src="http://hi.images.csdn.net/js/blog/tiny_mce/themes/advanced/langs/zh.js"></mce:script><mce:script type="text/javascript" src="http://hi.images.csdn.net/js/blog/tiny_mce/plugins/syntaxhl/langs/zh.js" mce_src="http://hi.images.csdn.net/js/blog/tiny_mce/plugins/syntaxhl/langs/zh.js"></mce:script> lock printk("Hello, I am a test module/n"); //create my kernel thread printk("Create mythread<---------<<<<<<<</n"); kernel_thread(mykthread, NULL, CLONE_FS | CLONE_FILES | CLONE_SIGHAND | SIGCHLD); printk("Create monitor <---------<<<<<</n"); kernel_thread(monitor, NULL, CLONE_FS | CLONE_FILES | CLONE_SIGHAND | SIGCHLD); return 0; } static void hello_exit(void) { printk("Bye, my dear!/n Cruel world/n"); } module_init(hello_init); module_exit(hello_exit); 

 

// Makefile obj-m := test.o  

 

// helper #!/bin/bash echo Kernel datastructure $TROUBLED_DS is in trouble >> /var/log/messages  

 

3. run

 

 

# chmod +x helper   

#echo /usr/src/linux-2.6.23/joseph/helper  > /proc/sys/kernel/myevent_handler // register the usermode helper

# echo "" > /var/log/messages  

#insmod test.ko

# cat /var/log/messages

 

May 11 07:15:31 joseph kernel: [ 4946.127119] Hello, I am a test module

May 11 07:15:31 joseph kernel: [ 4946.127292] Create mythread<---------<<<<<<<<

May 11 07:15:31 joseph kernel: [ 4946.127387] Create monitor <---------<<<<<<

May 11 07:15:31 joseph kernel: [ 4946.127472] monitor out

May 11 07:15:31 joseph kernel: [ 4946.127549] run_umode_handler is starting ...

May 11 07:15:31 joseph kernel: [ 4946.127652] argv[0] is /usr/src/linux-2.6.23/joseph/helper

May 11 07:15:31 joseph kernel: [ 4946.127816] josephThread out

Kernel datastructure 9527 is in trouble

 

OK, We are success!