gnitz-foundation 0.1.1

Process and OS primitives shared by the gnitz crates: logging, environment overrides, fault injection and syscall helpers
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

//! The process and the OS under it. Sibling leaves, NOT a unifying facade: each
//! keeps its own narrow surface.
//!   - `log`        — level/tag state. The `gnitz_*!` macros it backs are
//!     `#[macro_export]`ed, so they land at this crate's root, not in `log`
//!   - `env`        — `GNITZ_*` environment-variable overrides
//!   - `fault`      — debug-only `GNITZ_INJECT_*` fault-injection seams
//!   - `host`       — what the machine or container will give us (RAM budget)
//!   - `posix_io`   — the syscall idioms `std` lacks: an EINTR retry and an integer
//!     socket option
//!   - `perf`       — cost probes: instructions retired, context switches and
//!     resident-set bytes, for benchmarks and cost-claim tests
//!
//! This crate names no other gnitz crate, which is what lets any of them name
//! it. Hashing is deliberately not here: it is one owner in `gnitz-wire`,
//! because a client computes some of the same digests.
//!
//! Unit tests live in `tests/<module>.rs`, attached with `#[path]` to the module
//! they cover, so each stays that module's own `tests` child and reaches its
//! private items.

pub mod env;
pub mod fault;
pub mod host;
pub mod log;
pub mod perf;
pub mod posix_io;