Struct dpdk_unix::android_linux::LinuxKernelCommandLineParameters

pub struct LinuxKernelCommandLineParameters(_);

Linux kernel command line parameters.

Some of these are interpreted as environment variables set just as init is executed (typically in upper case, eg TERM=vt100). Others are not claimed by the kernel, but by init, eg single.

A very small number can occur more than once, eg console.

See https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.html and https://www.kernel.org/doc/Documentation/x86/x86_64/boot-options.txt.

Methods

impl LinuxKernelCommandLineParameters

pub fn numa_balancing(&self) -> Option<bool>

numa_balancing.

pub fn noexec(&self) -> Option<bool>

noexec.

pub fn noexec32(&self) -> Option<bool>

noexec32.

pub fn skew_tick(&self) -> Option<bool>

skew_tick.

pub fn hpet_mmap(&self) -> Option<bool>

hpet_mmap.

pub fn vdso(&self) -> Option<bool>

vdso.

pub fn vdso32(&self) -> Option<bool>

vdso32.

pub fn isolcpus(&self) -> Option<(HashSet<&[u8]>, BTreeSet<u16>)>

CPUs isolated from the Linux scheduler.

eg "0-9,10-20:2/5" and "nohz,domain,0-9,10-20:2/5". Note in the latter example there isn't a separate delimiter separating the flags from the list, so one either has to be know all possible flags (unlikely and subject to change) or have some truly revolting parsing code, which is what we do below (Self::split_flags_and_cpu_list). For extra brownie points the Linux kernel treats the values as ASCII not UTF-8.

pub fn rcu_nocbs(&self) -> Option<BTreeSet<u16>>

CPUs isolated from the Linux scheduler.

Ordinarily should match isolcpus.

pub fn nohz_full(&self) -> Option<BTreeSet<u16>>

CPUs isolated from the Linux scheduler.

Ordinarily should match rcu_nocbs.

pub fn irqaffinity(&self) -> Option<BTreeSet<u16>>

CPUs in the default IRQ affinity mask.

This should probably not be set.

pub fn nosmp(&self) -> bool

nosmp.

Disables SMP support.

Rarely used in practice.

S/390 equivalent is nosmt.

pub fn maxcpus(&self) -> Option<u16>

maxcpus.

Limits the Linux kernel to making only this number of CPUs online at boot-time; CPUs can be brought online later.

May also be 0 (zero) in which case it behaves the same as nosmp.

Rarely used in practice.

S/390 equivalent is smt (altohugh the zero value is not supported in this case).

See https://www.kernel.org/doc/Documentation/core-api/cpu_hotplug.rst.

pub fn nr_cpus(&self) -> Option<u16>

nr_cpus.

Limits the Linux kernel to a maximum of this number of CPUs (expressed as HyperThread::kernel_maximum_cpu() + 1).

Rarely used in practice, except to increase a compile time limit.

See https://www.kernel.org/doc/Documentation/core-api/cpu_hotplug.rst.

pub fn possible_cpus(&self) -> Option<u16>

possible_cpus.

Limits the Linux kernel to a maximum of this number of CPUs (see HyperThread::possible()).

Rarely used in practice.

See https://www.kernel.org/doc/Documentation/core-api/cpu_hotplug.rst.

pub fn get_value_parsed<F: FromStr>(&self, name: &'static [u8]) -> Option<F> where     F::Err: Debug,

Gets a value and parses it.

pub fn hashdist(&self) -> Option<bool>

NUMA hashdist.

pub fn pci(&self) -> Option<HashSet<&[u8]>>

pci.

pub fn acpi(&self) -> Option<&[u8]>

acpi.

Do not confuse this with noapic, which is something different entirely.

pub fn iommu(&self) -> Option<&[u8]>

iommu.

pub fn intel_iommu(&self) -> Option<&[u8]>

intel_iommu.

pub fn numa_zonelist_order(&self) -> Option<&[u8]>

numa_zonelist_order.

Deprecated according to Linux source code.

pub fn numa(&self) -> Option<(&[u8], Option<&[u8]>)>

numa.

Returns setting and optional fake size or number.

• numa=off
• numa=noacpi
• numa=fake=SIZE where size if suffixed with M or G
• numa=fake=N where N is a number of fake NUMA nodes to create.

See https://www.kernel.org/doc/Documentation/x86/x86_64/boot-options.txt.

pub fn idle(&self) -> Option<&[u8]>

idle.

See https://www.kernel.org/doc/Documentation/x86/x86_64/boot-options.txt.

pub fn nopcid(&self) -> bool

nopcid.

Rarely used in practice.

pub fn noinvpcid(&self) -> bool

noinvpcid.

Rarely used in practice.

pub fn norandmaps(&self) -> bool

norandmaps.

Rarely used in practice.

pub fn noapic(&self) -> bool

noapic.

Note the confusion with acpi, which is something else entirely.

Rarely used in practice.

pub fn disableapic(&self) -> bool

disableapic.

Rarely used in practice.

pub fn nolapic(&self) -> bool

nolapic.

Rarely used in practice.

pub fn noapictimer(&self) -> bool

noapictimer.

Rarely used in practice.

pub fn nox2apic(&self) -> bool

nox2apic.

Note the confusion with acpi, which is something else entirely.

Rarely used in practice.

pub fn nopat(&self) -> bool

nopat.

Rarely used in practice.

pub fn noxsaveopt(&self) -> bool

noxsaveopt.

Rarely used in practice.

pub fn noaliencache(&self) -> bool

NUMA noaliencache.

Rarely used in practice.

pub fn movable_node(&self) -> bool

NUMA movable_node.

Rarely used in practice.

pub fn nokaslr(&self) -> bool

nokaslr.

Rarely used in practice.

pub fn nospectre_v2(&self) -> bool

nospectre_v2.

Stupid command line option so that benchmarkers can game results and idiots 'apparently' increase performance.

Rarely used in practice.

pub fn spectre_v2(&self) -> Option<&[u8]>

spectre_v2.

pub fn nopti(&self) -> bool

nopti.

Stupid command line option so that benchmarkers can game results and idiots 'apparently' increase performance.

Rarely used in practice.

pub fn pti(&self) -> Option<&[u8]>

pti.

pub fn vsyscall(&self) -> Option<&[u8]>

vsyscall.

pub fn nohugeiomap(&self) -> bool

nohugeiomap.

Disables Huge Pages for IO support.

Rarely used in practice.

pub fn notsc(&self) -> bool

notsc.

Disables Time Stamp Counter (TSC) support.

Rarely used in practice.

pub fn nohpet(&self) -> bool

notsc.

Disables High Precision Event Timer (HPET) support.

Rarely used in practice.

pub fn panic(&self) -> Option<i64>

panic in seconds.

Rarely used in practice.

pub fn locale(&self) -> Option<&[u8]>

Default locale.

Typically passed to init.

pub fn root(&self) -> Option<(Option<&[u8]>, &[u8])>

Parses root:-

• If it is of the form root=/dev/sda, returns (None, "/dev/sda").
• If it is of the form root=UUID=59ca0b21-9bf6-4ccc-a06b-fdecc91bf2aa, returns (Some("UUID"), "59ca0b21-9bf6-4ccc-a06b-fdecc91bf2aa").

pub fn default_hugepagesz(&self) -> Option<&[u8]>

default_hugepagesz.

pub fn hugepagesz(&self) -> Option<Vec<&[u8]>>

hugepagesz.

pub fn hugepages(&self) -> Option<Vec<&[u8]>>

hugepages.

pub fn selinux(&self) -> Option<bool>

Detects if SELinux is enabled or disabled.

pub fn modules(&self) -> Option<Vec<&[u8]>>

Parses modules.

Returns a list of modules.

pub fn nomodeset(&self) -> bool

nomodeset.

pub fn quiet(&self) -> bool

quiet.

pub fn S(&self) -> bool

Single-user mode.

pub fn single(&self) -> bool

Single-user mode.

Not a kernel parameter, but passed through to init.

pub fn debug(&self) -> bool

Kernel debugging is enabled.

pub fn ro(&self) -> bool

Mount root file system read only, ro.

pub fn rw(&self) -> bool

Mount root file system read write, rw.

pub fn nogbpages(&self) -> bool

nogbpages.

See https://www.kernel.org/doc/Documentation/x86/x86_64/boot-options.txt.

pub fn gbpages(&self) -> bool

gbpages.

pub fn initrd(&self) -> Option<&[u8]>

initrd.

Returns eg initramfs-hardened.

pub fn init(&self) -> Option<PathBuf>

init.

Returns eg /sbin/init.

pub fn rootfstype(&self) -> Option<FileSystemType>

rootfstype.

Returns eg ext4.

pub fn console(&self) -> Option<Vec<&[u8]>>

console.

pub fn is_present_with_no_value<'a>(&self, parameter_name: &'a [u8]) -> bool

Is this 'boolean' parameter present?

Panics if present with a value.

pub fn get_value<'a>(&self, parameter_name: &'a [u8]) -> Option<&[u8]>

Gets the value of this parameter.

Panics if present without a value or if multiple values are present.

pub fn get_values<'a>(&self, parameter_name: &'a [u8]) -> Option<Vec<&[u8]>>

Gets the values of this parameter.

Trait Implementations

impl Default for LinuxKernelCommandLineParameters

fn default() -> LinuxKernelCommandLineParameters

Returns the "default value" for a type.

impl Clone for LinuxKernelCommandLineParameters

fn clone(&self) -> LinuxKernelCommandLineParameters

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LinuxKernelCommandLineParameters

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.