A Kconfig parser written in rust.

Kconfig is a language that describes configuration options for the linux Kernel. The syntax looks like this: ```bash

https://github.com/torvalds/linux/blob/master/arch/riscv/Kconfig#L771

config EFI bool "UEFI runtime support" depends on MMU default y select EFI_STUB help This option provides support for runtime services provided by UEFI firmware. ```

• The file starts with a config entry: We define a config named EFI. The next lines are the attributes of this entry.
• EFI is a boolean config.
• EFI depends on the config MMU.
• Its default value is y.
• If EFI is equals to true then it enables EFI_STUB.
• The help attribute defines a help text for the end user.

There are plenty of other keywords in the Kconfig language, check out the official documentation for more details.

Features

• This is a parser.
• There is no semantic analysis in this library.
• This library only supports UTF-8 encoded files.
• List of supported entris can be found here.
• List of supported attributes can be found here.
• When source is met, it reads and parses the specified configuration file.
• This library uses clone() a lot. Do not expect amazing performances.
• This parser has been tested on the linux kernel repository from 2.6.11 to 6.4.9 (3733 versions).

Getting started

bash cargo add nom-kconfig

```rust use std::path::PathBuf; use nomkconfig::{kconfig::parsekconfig, KconfigInput, KconfigFile};

// curl https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.4.9.tar.xz | tar -xJ -C /tmp/ fn main() -> Result<(), Box> { let kconfigfile = KconfigFile::new( PathBuf::from("/tmp/linux-6.4.9"), PathBuf::from("/tmp/linux-6.4.9/Kconfig") ); let input = kconfigfile.readtostring().unwrap(); let kconfig = parsekconfig(KconfigInput::newextra(&input, kconfig_file)); println!("{:?}", kconfig); Ok(()) } ```

Resources

• https://www.kernel.org/doc/html/next/kbuild/kconfig-language.html
• https://doc.coreboot.org/getting_started/kconfig.html
• https://build2.org/libbuild2-kconfig/doc/build2-kconfig-manual.xhtml#lang