Как узнать версию ядра Linux для изменения API?

Вопрос или проблема

#if LINUX_VERSION_CODE >= KERNEL_VERSION(...)
/*Версия-специфическая реализация*/
#endif

Ответ или решение

Определение, с какой версии Linux доступен API ядра, или выяснение изменения в таком API требует систематического подхода. Это важно для разработчиков ядра и модулей, поскольку позволяет адаптировать их программное обеспечение к разным версиям ядра Linux, избегая проблем несовместимости. Давайте разберёмся в этом вопросе более подробно, опираясь на ситуацию с функцией sg_alloc_table_from_pages_segment.

Теория

Поддержка совместимости с ядром Linux разных версий является важной задачей для каждого разработчика модулей или драйверов. В ядре Linux регулярно происходят изменения, которые могут включать добавление новых функций, изменение существующих или их удаление. Эти изменения часто фиксируются в системе контроля версий Git, которой управляется развитие ядра.

Часто возникает проблема, когда основная функция или макрос, essential для вашего модуля, была добавлена в более новых версиях ядра или подверглась изменениям. В этой связи становится критически важным определить, начиная с какой версии ядра данная функция доступна, чтобы адекватно адаптировать код.

Пример

В рассмотренном вами случае, функция sg_alloc_table_from_pages_segment отсутствует в версии ядра 5.10, но она необходима для вашего драйвера. Вы обнаружили, что функция была добавлена в ядро в версии 5.15. Давайте рассмотрим шаги, которые вам помогли это выяснить:

1. Git Blame:
   Этот инструмент позволяет определить, какой коммит и кто ввёл изменение в указанный файл. Использование команды git blame на файле scatterlist.c помогло выяснить, что функция была добавлена в коммите 90e7a6d. Это предоставило точку отсчета для дальнейшего анализа.

2. Git Tag:
   Использование команды git tag --contains <коммит> позволило определить, в какой версии ядра эти изменения появились. Таким образом, было определено, что функция была включена в релиз-кандидат v5.15-rc1.

3. Электронные ресурсы:
   Дополнительное подтверждение было получено через использование сервисов, таких как Elixir Cross Referencer, для просмотра исходного кода предыдущих релизов ядра.

Применение

Теперь, зная версию ядра, начиная с которой функция доступна (v5.15-rc1), вы можете адаптировать ваш код следующим образом:

1. Управление версии с помощью препроцессора:
   Используйте конструкции препроцессора, чтобы описать разную логику для разных версий ядра. Например:

   #if LINUX_VERSION_CODE >= KERNEL_VERSION(5, 15, 0)
   /* Реализация для версии ядра начиная с 5.15 */
   #else
   /* Альтернативная реализация или решение для более старой версии */
   #endif

2. Поддержка разных версий ядра:
   Убедитесь, что в вашем модуле используются только те функции, которые доступны для всех поддерживаемых вами версий ядра. Если функция отсутствует в более старых версиях, необходимо разработать обходные решения.

3. Отслеживание изменений:
   Рекомендуется регулярно отслеживать изменения в основных файлах ядра и вести журнал изменений вашего кода, чтобы быть готовым к возможным будущим обновлениям ядра.

Также важно помнить, что могут существовать дистрибутивы ядра Linux с backport-ами функций в более старые версии. Например, в вашем случае функция была backport-интегрирована в RHEL-базированный ядро версии 4.18.0-553.33.1.el8_10.x86_64. Это обязывает вас учитывать поведение отдельных дистрибутивов и предоставлять адекватную поддержку для них, если они находятся в области вашего интереса.

Таким образом, даже если поддержка специфических версий ядра может показаться излишне сложной задачей, стратегическое использование инструментов, таких как Git и специализированные ресурсы, существенно упрощает вашу работу. Навигация по изменениям ядра становится легче, если вы систематически отслеживаете изменения и используете соответствующие инструменты и методы.