Tip

This is the documentation for the 23.02 version. Looking for the documentation of the latest version? Have a look here.

Kernel Command Line Arguments

TNSR is capable of managing boot-time kernel command line arguments so that they do not need to be maintained by hand.

Kernel command line arguments encompass a wide range of purposes such as enabling alternate consoles, isolating CPUs, changing hugepage size and allocation, blacklisting drivers/modules, and increasing logging and debug information. There are far too many different arguments to document them all and why they are useful, so refer to documentation on the Linux kernel for additional information.

When TNSR manages these entries, TNSR handles updating the kernel command line arguments in the boot configuration, there no no need for the user to make any other changes outside of the TNSR CLI.

Automatic CPU Isolation

When configuring CPU workers for TNSR via corelist-workers (CPU Workers and Affinity), it can be beneficial to also have the kernel treat those CPU cores as isolated CPUs which are untouched by the OS scheduler. This ensures that the CPU cores in question are always free to operate only for TNSR.

This automatic mode configures CPU isolation for the same cores defined in dataplane cpu corelist-workers so the user does not have to manually maintain the same core list in multiple places:

tnsr(config)# system kernel arguments auto isolcpus
Changes to kernel command line arguments will take effect after system is rebooted.

Manual

Arbitrary kernel command line arguments can be entered using the manual method. These custom manual directives are added to the end of the existing kernel command line.

Note

The default kernel command line on current installations includes definitions for both video and serial consoles. The kernel uses the first matching directive per console type (one video, one serial), so this manual method cannot be used to override the default console behavior. See Enabling the Serial Console for an alternative method.

To manually define a list of isolated CPUs:

tnsr(config)# system kernel arguments manual isolcpus=1-3
Changes to kernel command line arguments will take effect after system is rebooted.

To enable IOMMU:

tnsr(config)# system kernel arguments manual intel_iommu=on iommu=pt
Changes to kernel command line arguments will take effect after system is rebooted.

See also

See Setup QAT Compatible Hardware for a more complete look at when this setting may be appropriate.

Checking the Current Kernel Command Line

To see the current arguments passed to the kernel at boot time, check the kernel message buffer and/or boot log. For example:

$ sudo dmesg | grep Command
[    0.000000] Command line: BOOT_IMAGE=/vmlinuz-5.15.0-58-generic
root=/dev/mapper/ubuntu--vg-ubuntu--lv ro console=ttyS0,115200n8 console=tty0