Awesome
<div align="center"> <br> <img alt="Tux, the pinguin" src="./doc/tux.png" width=100px /> <h1>A Kconfig parser written in rust.</h1> </div>Kconfig is a language that describes configuration options for the Linux Kernel. The syntax looks like this:
# 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 namedEFI
. The next lines are the attributes of this entry. EFI
is a boolean config.EFI
depends on the configMMU
.- Its default value is
y
. - If
EFI
is equals totrue
then it enablesEFI_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 entries 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
cargo add nom-kconfig
use std::path::PathBuf;
use nom_kconfig::{parse_kconfig, 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<dyn std::error::Error>> {
let kconfig_file = KconfigFile::new(
PathBuf::from("/tmp/linux-6.4.9"),
PathBuf::from("/tmp/linux-6.4.9/Kconfig")
);
let input = kconfig_file.read_to_string()?;
let kconfig = parse_kconfig(KconfigInput::new_extra(&input, kconfig_file));
println!("{:?}", kconfig);
Ok(())
}