• Makefile'ы для модулей ядра
  • Модули ядра из нескольких файлов
  • Hello, world

    Традиционно все учебники программирования начинаются с программы "Hello, world!". Я не знаю, что случается с людьми, которые порывают с этой традицией, и думаю, что безопаснее не выяснять. 

    Модуль ядра (в дальнейшем просто модуль для краткости) должен иметь по крайней мере две функции: init_module, которая вызывается, когда модуль вставляется в ядро и cleanup_module, которая вызывается, когда он удаляется. Обычно init_module регистрирует драйвер для каких-либо действий с ядром или заменяет одну из ядерных функций собственным кодом (обычно код делает что-то и затем вызывает первоначальную функцию). Функция cleanup_module, как предполагается, отменяет все, что сделано init_module, так что модуль может быть выгружен безопасно.

    hello.c

    /* hello.c

    * Copyright (C) 1998 by Ori Pomerantz

    *

    * "Hello, world" - версия для модуля ядра.

    */


    /* The necessary header files */

    /* Standard in kernel modules */

    #include <linux/kernel.h>
    /* We're doing kernel work */

    #include <linux/module.h>
    /* Specifically, a module */


    /* Deal with CONFIG_MODVERSIONS */

    #if CONFIG_MODVERSIONS==1

    #define MODVERSIONS

    #include <linux/modversions.h>

    #endif


    /* Initialize the module */

    int init_module() {

     printk("Hello, world - this is the kernel speaking\n");

     /* If we return a non zero value, it means that

     * init_module failed and the kernel module

     * can't be loaded */

     return 0;

    }


    /* Cleanup - undid whatever init_module did */

    void cleanup_module() {

     printk("Short is the life of a kernel module\n");

    }

    Makefile'ы для модулей ядра

    Модуль не яявляется независимой программой, а представляет собой объектный файл, который будет прилинкован к ядру во время выполнения. В результате, они должны компилироваться с опцией -c. Все модули должны компилироваться с некоторыми определенными символами. 

    • __KERNEL__ — Этот символ сообщает файлам заголовка, что этот код будет выполнен в ядерном режиме (нравится мне такое определение), а не как часть процесса пользователя.

    • MODULE — Этот символ сообщает файлам заголовка, что надо дать соответствующие определения для модуля.

    • LINUX — Технически это не необходимо. Однако, если Вы когда-либо захотите написать серьезный модуль, который компилируется на больше чем одной операционной системе, вы будете счастливы, что Вы сделали данное определение. Это позволит Вам делать условную трансляцию частей, которые являются OS-зависимыми. 

    Имеются другие символы, которые должны быть включены или наоборот выключены в зависимости от параметров с которыми компилировалось ядро. Если вы не уверены, как ядро компилировалось, посмотрите в /usr/include/linux/config.h

    • __SMP__ — Симметричная многопроцессорная обработка. Этот символ должен быть определен, если Вы компилируете модуль для ядра, которое было скомпилировано с опцией «Поддержка SMP» (даже если работать оно будет на однопроцессорной машине). Если Вы используете симметричную многопроцессорную обработку, имеются другие хитрости, которые Вы должны предусмотреть (см. главу 12).

    • CONFIG_MODVERSIONS — Если CONFIG_MODVERSIONS разрешен, Вы должны иметь определить его при компиляции модуля и включить /usr/include/linux/modversions.h. Это может быть также выполнено кодом непосредственно. 

    Makefile 

    # Makefile для базисного ядерного модуля

    CC=gcc

    MODCFLAGS := -Wall -DMODULE -D__KERNEL__ -DLINUX


    hello.o:        hello.c /usr/include/linux/version.h

                    $(CC) $(MODCFLAGS) -c hello.c

                    echo insmod hello.o to turn it on

                    echo rmmod hello to turn if off

                    echo

                    echo X and kernel programming do not mix.

                    echo Do the insmod and rmmod from outside X

    Так, теперь единственное, что надо сделать, это выполнить su, чтобы зайти как root (Вы не компилировали модуль как root, не так ли?[1]) Теперь скомандуйте insmod hello и rmmod hello. Когда Вы даете эти команды, обратите внимание на Ваш новый модуль в /proc/modules.

    Между прочим, причина, почему Makefile предостерегает против выполнения из X в том, что когда ядро имеет сообщение, чтобы печатать его с помощью printk, оно посылает его на консоль. Когда Вы не используете X, оно придет на терминал, который вы используете (тот, который Вы выбрали Alt-F<n>) и Вы его увидите. Когда Вы используете X, имеются две возможности. Или Вы имеете консоль открытой с xterm -C, тогда вывод будет послан туда, или Вы консоль не видите, тогда вывод будет идти на терминал 7 — тот, который «захвачен» X.

    Если в ядре происходит ошибка, у Вас больше шансов получить из ядра отладочные сообщения, если Вы работаете в текстовой консоли, чем если Вы работаете в X. Вне X вывод printk идет непосредственно с ядра на консоль. В X printk идет на процесс режима пользователя (xterm -C). Когда этот процесс получает время CPU, предполагается послать дааные X процессу. Затем, когда X сервер получает время, сообщение отобразится, но нестабильное ядро обычно означает, что система собирается разрушиться или перезагружаться, так что Вы не успеете получить сообщения об ошибках, которые могли бы объяснить Вам, что именно пошло неправильно. Так что, никаких иксов!

    Модули ядра из нескольких файлов

    Иногда имеет смысл разделить модуль на несколько файлов. В этом случае Вы должны делать следующее:

    1. Во всех исходных файлах добавьте строку #define __NO_VERSION__. Это важно, потому что module.h обычно включает определение kernel_version, глобальная переменная версии ядра для которой компилируется модуль. Если Вы нуждаетесь в version.h, Вы должны включить его непосредственно, потому что module.h не будет делать этого после указания __NO_VERSION__.

    2. Скомпилируйте все исходные файлы как обычно.

    3. Объедините все объектные файлы в один. Под x86 это делается командой:

    ld -m elf_i386 -r -o <имя_модуля>.o <1-ый исходный файл>.o <2-ой исходный файл>.o.

    Пример такого модуля:

    start.c

    /* start.c

    * Copyright (C) 1999 by Ori Pomerantz

    *

    * "Hello, world" - the kernel module version.

    * This file includes just the start routine

    */


    /* The necessary header files */

    /* Standard in kernel modules */

    #include <linux/kernel.h>   /* We're doing kernel work */

    #include <linux/module.h>   /* Specifically, a module */


    /* Deal with CONFIG_MODVERSIONS */

    #if CONFIG_MODVERSIONS==1

    #define MODVERSIONS

    #include <linux/modversions.h>

    #endif


    /* Initialize the module */

    int init_module() {

     printk("Hello, world - this is the kernel speaking\n");


     /* If we return a non zero value, it means that

      * init_module failed and the kernel module

      * can't be loaded */

     return 0;

    }

    stop.c   

    /* stop.c

    * Copyright (C) 1999 by Ori Pomerantz

    *

    * "Hello, world" - the kernel module version. This

    * file includes just the stop routine.

    */


    /* The necessary header files */

    /* Standard in kernel modules */

    #include <linux/kernel.h> /* We're doing kernel work */


    #define __NO_VERSION__ /* This isn't "the" file of the kernel module */

    #include <linux/module.h> /* Specifically, a module */

    #include <linux/version.h> /* Not included by module.h because of the __NO_VERSION__ */


    /* Deal with CONFIG_MODVERSIONS */

    #if CONFIG_MODVERSIONS==1

    #define MODVERSIONS

    #include <linux/modversions.h>

    #endif


    /* Cleanup - undid whatever init_module did */

    void cleanup_module(){

     printk("Short is the life of a kernel module\n");

    }

    Makefile

    # Makefile for a multifile kernel module

    CC=gcc

    MODCFLAGS := -Wall -DMODULE -D__KERNEL__ -DLINUX


    hello.o:        start.o stop.o

                    ld -m elf_i386 -r -o hello.o start.o stop.o


    start.o:        start.c /usr/include/linux/version.h

                    $(CC) $(MODCFLAGS) -c start.c


    stop.o:         stop.c /usr/include/linux/version.h

                    $(CC) $(MODCFLAGS) -c stop.c


    Примечания:



    1

    Причина, по которой я предпочитаю не компилировать как root в том, что так наиболее безопасно. Я работаю в службе компьютерной безопасности, так что я параноидален.







     

    Главная | В избранное | Наш E-MAIL | Добавить материал | Нашёл ошибку | Наверх