Programação do Módulo Kernel Linux: Programa Hello World
Módulos do kernel são pedaços de código que podem ser carregados e descarregados no kernel sob demanda. Eles estendem a funcionalidade do kernel sem a necessidade de reinicializar o sistema. Códigos personalizados podem ser adicionados aos kernels do Linux por meio de dois métodos.
- A maneira básica é adicionar o código à árvore fonte do kernel e recompilar o kernel.
- Uma maneira mais eficiente de fazer isso é adicionar código ao kernel enquanto ele está em execução. Este processo é chamado de carregamento do módulo, onde módulo se refere ao código que queremos adicionar ao kernel.
- driver de dispositivo
- driver do sistema de arquivos e
- Chamadas do sistema.
/** * @file hello.c * @author Akshat Sinha * @date 10 Sept 2016 * @version 0.1 * @brief An introductory 'Hello World!' loadable kernel * module (LKM) that can display a message in the /var/log/kern.log * file when the module is loaded and removed. The module can accept * an argument when it is loaded -- the name which appears in the * kernel log files. */ #include /* Needed by all modules */ #include /* Needed for KERN_INFO */ #include /* Needed for the macros */ /// < The license type -- this affects runtime behavior MODULE_LICENSE ( 'GPL' ); /// < The author -- visible when you use modinfo MODULE_AUTHOR ( 'Akshat Sinha' ); /// < The description -- see modinfo MODULE_DESCRIPTION ( 'A simple Hello world LKM!' ); /// < The version of the module MODULE_VERSION ( '0.1' ); static int __init hello_start ( void ) { printk ( KERN_INFO 'Loading hello module... n ' ); printk ( KERN_INFO 'Hello world n ' ); return 0 ; } static void __exit hello_end ( void ) { printk ( KERN_INFO 'Goodbye Mr. n ' ); } module_init ( hello_start ); module_exit ( hello_end );
Explicação para o código acima: Os módulos do kernel devem ter pelo menos duas funções: uma função de 'início' (inicialização) chamada init_module() que é chamada quando o módulo é inserido no kernel e uma função de 'fim' (limpeza) chamada cleanup_module() que é chamada logo antes de ser modificado. Na verdade as coisas mudaram a partir do kernel 2.3.13. Agora você pode usar qualquer nome que desejar para as funções inicial e final de um módulo. Na verdade, o novo método é o método preferido. No entanto, muitas pessoas ainda usam init_module() e cleanup_module() para suas funções inicial e final. Neste código usamos hello_start() como função init e hello_end() como função de limpeza. Outra coisa que você deve ter notado é que em vez da função printf() usamos printk(). Isso ocorre porque o módulo não imprimirá nada no console, mas registrará a mensagem em /var/log/kern.log. Portanto, é usado para depurar módulos do kernel. Além disso, existem oito strings de nível de log possíveis definidas no cabeçalho que são necessárias ao usar printk(). Nós os listamos em ordem decrescente de gravidade: - KERN_EMERG: Usado para mensagens de emergência, geralmente aquelas que precedem uma falha.
- KERN_ALERT: Uma situação que requer ação imediata.
- KERN_CRIT: Condições críticas frequentemente relacionadas a falhas graves de hardware ou software.
- KERN_ERR: Usado para reportar condições de erro; drivers de dispositivo geralmente usam KERN_ERR para relatar dificuldades de hardware.
- KERN_WARNING: Avisos sobre situações problemáticas que por si só não criam problemas graves no sistema.
- KERN_NOTICE: Situações normais mas ainda dignas de nota. Várias condições relacionadas à segurança são relatadas neste nível.
- KERN_INFO: Mensagens informativas. Muitos drivers imprimem informações sobre o hardware que encontram na inicialização neste nível.
- KERN_DEBUG: Usado para depuração de mensagens. Usamos KERN_INFO para imprimir a mensagem. Preparando o sistema para executar o código: The system must be prepared to build kernel code and to do this you must have the Linux headers installed on your device. On a typical Linux desktop machine you can use your package manager to locate the correct package to install. For example under 64-bit Debian you can use:
akshat@gfg:~$ sudo apt-get install build-essential linux-headers-$(uname -r)Makefile para compilar o código fonte:
obj-m = hello.o all: make -C /lib/modules/$(shell uname -r)/build/ M=$(PWD) modules clean: make -C /lib/modules/$(shell uname -r)/build M=$(PWD) clean**Nota: não se esqueça dos espaços de tabulação no Makefile Compilando e carregando o módulo: Run the make command to compile the source code. Then use insmod to load the module.
akshat@gfg:~$ make make -C /lib/modules/4.2.0-42-generic/build/ M=/home/akshat/Documents/hello-module modules make[1]: Entering directory `/usr/src/linux-headers-4.2.0-42-generic' CC [M] /home/akshat/Documents/hello-module/hello.o Building modules stage 2. MODPOST 1 modules CC /home/akshat/Documents/hello-module/hello.mod.o LD [M] /home/akshat/Documents/hello-module/hello.ko make[1]: Leaving directory `/usr/src/linux-headers-4.2.0-42-generic'Now we will use insmod to load the hello.ko object.
akshat@gfg:~$ sudo insmod hello.koTestando o módulo: You can get information about the module using the modinfo command which will identify the description author and any module parameters that are defined:
akshat@gfg:~$ modinfo hello.ko filename: /home/akshat/Documents/hello-module/hello.ko version: 0.1 description: A simple Hello world LKM author: Akshat Sinha license: GPL srcversion: 2F2B1B95DA1F08AC18B09BC depends: vermagic: 4.2.0-42-generic SMP mod_unload modversionsTo see the message we need to read the kern.log in /var/log directory.
akshat@gfg:~$ tail /var/log/kern.log ... ... Sep 10 17:43:39 akshat-gfg kernel: [26380.327886] Hello world To unload the module we run rmmod: akshat@gfg:~$ sudo rmmod hello Now run the tail command to get the exit message. akshat@gfg:~$ tail /var/log/kern.log ... Sep 10 17:43:39 akshat-gfg kernel: [26380.327886] Hello world Sep 10 17:45:42 akshat-gfg kernel: [26503.773982] Goodbye Mr.