Использование командной строки ядра KasperskyOS

30 сентября 2026

ID kernel_command_line

Ядро KasperskyOS может принимать командную строку во время запуска, что позволяет, например, активировать отключенную по умолчанию функциональность ядра, настроить механизмы ядра, задать, какие аппаратные интерфейсы ввода-вывода будут использоваться ядром на конкретной аппаратной платформе.

Командная строка ядра представляет собой один или несколько разделенных пробелами параметров запуска ядра:

<имя_параметра1>[=<значение_параметра1>] [<имя_параметра2>[=<значение_параметра2>]]...

Параметры запуска ядра приведены в таблице ниже.

Чтобы командная строка была передана ядру при запуске решения на QEMU, нужно указать параметры запуска ядра в параметре KERNEL_CMDLINE CMake-команды generate_qemu_target ().

Пример использования параметра KERNEL_CMDLINE CMake-команды generate_qemu_target ():

generate_qemu_target (qemu

...

KERNEL_CMDLINE "gdbstub.connection.timeout=10 gdbstub")

Чтобы командная строка была передана ядру при запуске решения на аппаратной платформе, нужно указать параметры запуска ядра в параметре BOOTARGS CMake-команды build_sd_image ():

Пример использования параметра BOOTARGS CMake-команды build_sd_image ():

build_sd_image (sd-image

...

BOOTARGS "gdbstub.connection.timeout=10 gdbstub")

Параметры запуска ядра KasperskyOS

Параметр

Описание параметра

gdbstub

Запускает GDB-сервер ядра.

gdbstub.transport=uart:<идентификатор UART>[?baudrate=<символьная скорость>]

Задает UART, используемый GDB-сервером ядра.

По умолчанию GDB-сервер ядра использует UART5 на Raspberry Pi 4 B. Чтобы задать другой UART, нужно указать идентификатор UART в формате DTS (Device Tree Source). Например, чтобы GDB-сервер ядра использовал UART3, нужно указать следующий параметр:

gdbstub.transport=uart:/soc/serial@7e201600

Дополнительно для Raspberry Pi 4 B с начальным загрузчиком U-Boot нужно внести изменения в конфигурационный файл config.txt. Например, чтобы GDB-сервер ядра использовал UART3, нужно указать следующий параметр:

dtoverlay=uart3

Кроме того, нужно установить тактовую частоту для заданного UART. Для этого можно использовать команду начального загрузчика U-boot fdt set. Например, чтобы задать для UART3 тактовую частоту 48 МГц, нужно использовать следующую команду:

fdt set /soc/serial@7e201600 kos,clock-frequency <48000000>

На Raspberry Pi 4 B для UART, который используется GDB-сервером ядра, по умолчанию задается символьная скорость 115200 бод. При необходимости это значение можно изменить. Например, следующий параметр задает для UART3 символьную скорость 9600 бод:

gdbstub.transport=uart:/soc/serial@7e201600?baudrate=9600

При отладке на QEMU система сборки автоматически задает такое значение для этого параметра, чтобы GDB-сервер ядра использовал UART1. Это соответствует параметрам запуска QEMU (-serial), которые также автоматически генерируются системой сборки.

gdbstub.connection.timeout=<значение параметра>

Задает время, в течение которого GDB-сервер ожидает подключения отладчика GDB при запуске ядра.

При запуске ядра GDB-сервер может некоторое время или бесконечно ожидать подключения отладчика GDB в зависимости от значения параметра. Параметр может принимать следующие значения:

-1 – бесконечное ожидание;
0 – отсутствие ожидания;
1,2,...,1200 – время ожидания, в секундах.

Например, чтобы задать время ожидания 10 с, нужно указать в командной строке следующий параметр:

gdbstub.connection.timeout=10

Если параметр gdbstub.connection.timeout=<значение параметра> не указан в командной строке ядра, будет установлено значение этого параметра по умолчанию, которое можно узнать из диагностического вывода, выполняемого ядром. (Если параметр не указан в командной строке ядра, то диагностический вывод содержит значение параметра по умолчанию, в противном случае содержит заданное значение параметра.)

Примеры диагностического вывода со значением параметра:

[KDBG ] GDB connection timeout: 10 second(s).

[KDBG ] GDB connection timeout: infinite.

earlycon={<описание UART>|none}

Задает UART, используемый ядром для диагностического вывода.

По умолчанию ядро использует UART0 для диагностического вывода на Raspberry Pi 4 B.

Описание UART имеет такой же синтаксис, как и в параметре earlycon=<описание UART> ядра Linux. Поддерживаются следующие UART: 16550, PL011. Например, чтобы ядро использовало UART3 для диагностического вывода на Raspberry Pi 4 B, нужно указать следующий параметр:

earlycon=pl011,mmio32,0xfe201600

dtoverlay=uart3

На Raspberry Pi 4 B для UART, который используется ядром для диагностического вывода, по умолчанию задается символьная скорость 115200 бод. Для UART 16550 можно изменить символьную скорость, используя параметр options в следующей конструкции:

earlycon=uart,<...><addr>[,<options>[,<*>]]

Например, следующий параметр задает для UART1 на Raspberry Pi 4 B символьную скорость 9600 бод:

earlycon=uart,mmio32,0xfe215040,9600n8

Если ни один из UART на Raspberry Pi 4 B не требуется использовать для диагностического вывода, то нужно указать следующий параметр:

earlycon=none

При запуске решения на QEMU система сборки автоматически задает такое значение для этого параметра, чтобы ядро использовало UART0 для диагностического вывода. Это соответствует параметрам запуска QEMU (-serial), которые также автоматически генерируются системой сборки.

В решении может использоваться системная программа LogRR, которая получает диагностические данные от других программ решения и ядра для последующего вывода, например, через UART или сохранения в файл. Программы решения передают диагностические данные программе LogRR, используя клиентскую библиотеку этой программы. В то же время программы решения могут передавать диагностические данные ядру, используя, например, API trace.h. Программа LogRR обращается к ядру, чтобы ядро прекратило выполнять диагностический вывод, и затем считывает диагностические данные из ядра, включающие сообщения как самого ядра, так и программ решения. Для программы LogRR одним из возможных вариантов диагностического вывода является вывод через UART с использованием драйвера UART, работающего в пользовательском режиме. При использовании такого варианта, даже если передать ядру параметр earlycon=none, диагностический вывод будет выполняться, но только после запуска программы LogRR и драйвера UART. Однако если требуется получать диагностические данные до этого момента, нужно передать ядру параметр earlycon=<описание UART>. В этом случае до запуска программы LogRR и драйвера UART диагностический вывод выполняет ядро, а затем сама программа LogRR. При этом драйвер UART может использовать тот же UART, который сначала использовался ядром для диагностического вывода.

nokaslr

Отключает поддержку KASLR.

handle.disable_detect_invalid_access

Отключает функциональность санитайзера дескрипторов для обнаружения использования недействительных дескрипторов.

vmm.overcommit={disabled|exception}

Настраивает, как выполняется фиксация динамически выделяемой виртуальной памяти.

О фиксации виртуальной памяти см. "Выделение и освобождение памяти".

Параметр принимает следующие значения:

disabled – запретить фиксацию виртуальной памяти в "ленивом" режиме.
Вызовы функций, которые должны установить "ленивый" режим фиксации для региона виртуальной памяти, либо выполняют фиксацию этого региона с выделением всего требуемого объема физической памяти, либо завершаются с ошибкой, если требуемый объем физической памяти не может быть выделен. По умолчанию фиксация виртуальной памяти в "ленивом" режиме разрешена.
exception – генерировать исключение в случае нехватки физической памяти при фиксации виртуальной памяти в "ленивом" режиме.
Если при недостатке физической памяти поток исполнения обращается к виртуальной памяти, которая должна быть зафиксирована в "ленивом" режиме, то в этом потоке возникает исключение типа EXCEPTION_OVERCOMMIT. (Константа EXCEPTION_OVERCOMMIT определена в заголовочном файле sysroot-*-kos/include/hal/exc_codes.h из состава KasperskyOS Community Edition SDK.) По умолчанию исключения не возникает, а поток исполнения блокируется в ожидании освобождения недостающей физической памяти.

vmm.zero_dedup=0

Отключает дедупликацию нулевых страниц физической памяти, выделенных для фиксации виртуальной памяти в "ленивом" режиме.

vmm.zero_dedup.period=<период дедупликации>

Задает период дедупликации нулевых страниц физической памяти, выделенных для фиксации виртуальной памяти в "ленивом" режиме, в секундах. По умолчанию этот период составляет 10 с. Нельзя указывать 0.

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!