Crate cluproccmdline 

Fast secure parsing /proc/cmdline“.

Use:

DefaultIter

use cluproccmdline::Cmdline;

let mut cmdline = cluproccmdline::this_machine().unwrap();
for (name, value) in cmdline.iter() {
	if let Some(name) = name {
		println!(
			"Cmdline_str: {} {}", 
			String::from_utf8(name.to_vec()).unwrap(), 
			String::from_utf8(value.to_vec()).unwrap()
		);
	}
	// OUTPUT: 
	// IF /proc/cmdline = "BOOT_IMAGE=/boot/vmlinuz-linux-zen nmi_watchdog=0"
	// TO -> "Cmdline_str: BOOT_IMAGE /boot/vmlinuz-linux-zen"
	// TO -> "Cmdline_str: nmi_watchdog 0"
}	

use cluproccmdline::Cmdline;

let mut cmdline = cluproccmdline::array_slice(b"test=all rw");
let mut iter = cmdline.iter();

while let Some((Some(name), value)) = iter.next() {
	println!("{} {}", 
		String::from_utf8(name.to_vec()).unwrap(), 
		String::from_utf8(value.to_vec()).unwrap()
	);
	// OUTPUT:
	// rw
}

OneIter

use cluproccmdline::Cmdline;

let mut cmdline = cluproccmdline::array_slice(b"test=all rw");
for value in cmdline.iter_one() {
	println!("{}", 
		String::from_utf8(value.to_vec()).unwrap()
	);
	// OUTPUT: 
	// rw
}

use cluproccmdline::Cmdline;

let mut cmdline = cluproccmdline::array_slice(b"test=all rw");
let mut iter = cmdline.iter_one();

while let Some(value) = iter.next() {
	println!("{}", 
		String::from_utf8(value.to_vec()).unwrap()
	);
	// OUTPUT:
	// rw
}

TwoIter

use cluproccmdline::Cmdline;

let mut cmdline = cluproccmdline::array_slice(b"test=all rw");
for (value, name) in cmdline.iter_two() {
	println!("{} {}", 
		String::from_utf8(name.to_vec()).unwrap(),
		String::from_utf8(value.to_vec()).unwrap()
	);
	// OUTPUT: 
	// test all
}

Hash proc cmdline

use cluproccmdline::Cmdline;

let mut cmdline = cluproccmdline::array_slice(b"test=all rw");
assert_eq!(cmdline.cmdline_hash(), 1877887864476248772);

Benchmark

Machine: Intel Core 2 Duo (2000 MHz), 2 Gb DDR2

test tests::bench_oneslice_new ... bench:         101 ns/iter (+/- 14)
test tests::bench_slice_new    ... bench:         105 ns/iter (+/- 23)

Modules

iter

structs

Data structures

Enums

CmdlineErr

Description of errors

Traits

Cmdline

Main functions of Cmdline.

Functions

array_buf

Creates cmdline from Vec. Equivalent CmdlineBuf::array(array).

array_slice

Creates cmdline from &[u8]. Equivalent CmdlineSlice::array(array).

open_file

Opens the cmdline from the file.

this_machine

Opens the cmdline of the current machine. Equivalent open_file("/proc/cmdline").