Макрос MODULE_LICENSE
позволяет указать лицензию на право копирования модуля. Загрузка в память модуля, для которого лицензия не соответствует GPL, приведет к установке в ядре флага tainted
(буквально, испорченное). Этот флаг служит для информационных целей, кроме того, многие разработчики уделяют меньше внимания сообщениям об ошибках, в которых указан этот флаг. Более того, модули, у которых лицензия не соответствует GPL, не могут использовать символы, которые служат "только для GPL" (см. раздел "Экспортируемые символы" ниже в этой главе).
Наконец, макрос MODULE_AUTHOR
позволяет указать автора модуля. Значение этого макроса служит только для информационных целей.
Сборка модулей
Благодаря новой системе сборки "kbuild", в ядрах серии 2.6 сборка модулей выполняется значительно проще, чем в старых сериях. Первое, что нужно сделать при сборке модулей, — это решить, где будет находиться исходный код модуля. Исходный код модуля необходимо правильно объединить с деревом исходных кодов ядра. Это можно сделать в виде заплаты или путем добавления в официальное дерево исходного кода ядра. Кроме этого, можно компилировать исходный код модуля отдельно от исходных кодов ядра.
Использование дерева каталогов исходных кодов ядра
В идеале модуль является частью официального ядра и находится в каталоге исходных кодов ядра. Введение вашей разработки непосредственно в ядро может вначале потребовать больше работы, но обычно такое решение более предпочтительно.
На первом этапе необходимо решить, drivers/
, который находится в корне дерева исходных кодов ядра. Внутри этого каталога драйверы делятся на классы, типы и собственно на отдельные драйверы. Символьные устройства находятся в каталоге drivers/char/
, блочные — в каталоге drivers/block/
, устройства USB — в каталоге drivers/usb/
. Эти правила не есть жесткими, так как многие устройства USB также являются и символьными устройствами. Но такая организация является понятной и четкой.
Допустим, что вы хотите создать свой подкаталог и ваш воображаемый драйвер разработан для удочки с числовым программным управлением, которая имеет интерфейс Fish Master XL 2000 Titanium для подключения к компьютеру. Следовательно, необходимо создать подкаталог fishing
внутри каталога drivers/char/
.
После этого необходимо добавить новую строку в файл Makefile
, который находится в каталоге drivers/char/
. Для этого отредактируйте файл drivers/char/Makefile
и добавьте в него следующую запись.
obj-m += fishing/
Эта строка указывает системе компиляции, что необходимо войти в подкаталог fishing/
при компиляции модулей. Скорее всего, компиляция драйвера определяется отдельным конфигурационным параметром, например, CONFIG_FISHING_POLE
(как создавать новые конфигурационные параметры, рассмотрено ниже в этой главе в разделе "Управление конфигурационными параметрами"). В этом случае необходимо добавить строку следующего вида.
obj-$(CONFIG_FISHING_POLE) += fishing/
И наконец, в каталоге drivers/char/fishing
необходимо добавить новый файл Makefile, содержащий следующую строку.
obj-m += fishing.o
При таких настройках система компиляции перейдет в каталог fishing/
и скомпилирует модуль fishing.ko
из исходного файла fishing.c
. Да, расширение объектного файла указано как .o
, но в результате будет создан модуль с расширением .ko
.
И снова, скорее всего, факт компиляции модуля будет зависеть от конфигурационного параметра, в таком случае в Makefile
необходимо добавить следующую строку.
obj-$(CONFIG_FISHING_POLE) += fishing.o
Однажды драйвер удочки может стать очень сложным. Введение функции автодетектирования наличия лески может привести к тому, что модуль станет очень большим и теперь будет занимать больше одного файла исходного кода. Никаких проблем! Просто нужно внести в Makefile
следующую запись.
obj-$(CONFIG_FISHING_POLE) += fishing.o
fishing-objs := fishing-main.o fishing-line.o
В последнем случае будут скомпилированы файлы fishing-main.c
и fishing-line.c
и скомпонованы в файл модуля fishing.ko
.
Наконец, может потребоваться передать компилятору gcc дополнительные конфигурационные параметры. Для этого в файле Makefile
необходимо добавить следующую строку.
EXTRA_CFLAGS += -DTITANIUM_POLE