liboverdrop

Crates.ioliboverdrop
lib.rsliboverdrop
version0.1.0
sourcesrc
created_at2019-06-14 13:40:13.21331
updated_at2023-02-03 18:45:06.296593
descriptionConfiguration library, with directory overlaying and fragments dropins
homepage
repositoryhttps://github.com/coreos/liboverdrop-rs
max_upload_size
id141111
size26,542
Jonathan Lebon (jlebon)

documentation

README

liboverdrop

crates.io Documentation Rust 1.56+

A simple Rust library to handle configuration fragments.

This crate provides helpers to scan configuration fragments on disk. The goal is to help in writing Linux services which are shipped as part of a Reproducible OS. Its name derives from overlays and dropins (base directories and configuration fragments).

The main entrypoint is scan. It scans for configuration fragments across multiple directories (with increasing priority), following these rules:

  • fragments are identified by unique filenames, lexicographically (e.g. 50-default-limits.conf).
  • in case of name duplication, last directory wins (e.g. /etc/svc/custom.conf can override /usr/lib/svc/custom.conf).
  • a fragment symlinked to /dev/null is used to ignore any previous fragment with the same filename.

License

Licensed under either of

at your option.

Commit count: 61

cargo fmt