mount-fstab 0.1.1

Type-safe /etc/fstab parsing, editing, and validation library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

//! # mount-fstab
//!
//! A 100% type-safe, memory-safe, thread-safe Rust library for parsing,
//! editing, validating, and writing `/etc/fstab` files.
//!
//! Implements the official fstab(5) semantics from util-linux, aligned with
//! libmount and glibc parsing behavior.
//!
//! ## Quick start
//!
//! ```rust
//! use mount_fstab::Fstab;
//!
//! let input = "UUID=root / ext4 defaults 0 1\n";
//! let fstab = Fstab::parse_str(input).unwrap();
//! assert_eq!(fstab.entries.len(), 1);
//! ```
//!
//! ## Modules
//!
//! | Module | Description |
//! |--------|-------------|
//! | [`error`] | Error types for all parsing and validation operations |
//! | [`escape`] | fstab escape sequence encoding and decoding |
//! | [`fstype`] | Filesystem type (fstab field 3) |
//! | [`options`] | Mount options (fstab field 4) with parsing and classification |
//! | [`parse`] | fstab string and file parsing |
//! | [`spec`] | Spec/source identifiers (fstab field 1) |
//! | [`types`] | Core types: `Entry`, `Fstab`, `MountPoint`, `EntryBuilder` |
//! | [`validate`] | Semantic validation of fstab entries |
//! | [`mod@write`] | Display formatting and atomic file writing |
//!
//! ## Features
//!
//! - **Parse**: Full fstab(5) format including all tag types (`LABEL`, `UUID`,
//!   `PARTLABEL`, `PARTUUID`, `ID`), NFS mounts, escape sequences
//! - **Edit**: Add, remove, replace entries with CRUD API
//! - **Validate**: Semantic checks matching `findmnt --verify`
//! - **Serialize**: Display formatting with proper escape encoding
//! - **Atomic write**: tempfile -> fsync -> rename for safe file updates

#![forbid(unsafe_code)]
#![deny(missing_docs)]
#![cfg_attr(docsrs, feature(doc_cfg))]

pub mod error;
pub mod escape;
pub mod fstype;
pub mod options;
pub mod parse;
pub mod spec;
pub mod types;
pub mod validate;
pub mod write;

pub use error::{
    EntryBuilderError, FsTypeError, FstabError, MountPointError, OptItemError, OptionsError,
    ParseErrorKind, SpecError,
};
pub use fstype::FsType;
pub use options::{MountPermission, OptItem, OptionClass, Options};
pub use spec::Spec;
pub use types::{Entry, EntryBuilder, Fstab, MountPoint};
pub use validate::{Diagnostic, Severity};