Skip to content

README.md

Latest commit

 

History

History
27 lines (22 loc) · 1.54 KB

README.md

File metadata and controls

27 lines (22 loc) · 1.54 KB
Raw

Nyanpasu Utils

Shared utilities for Nyanpasu UI and Nyanpasu Service.

The repository contains a single nyanpasu-utils crate. Utilities are organized as feature-gated modules so the crate can be embedded in a larger monorepo without nested Cargo workspaces:

  • core — proxy-core process lifecycle management (core_manager feature)
  • dirs — platform-aware application directories (dirs feature)
  • io and runtime — shared IO and Tokio runtime helpers
  • network — platform-specific network configuration (network feature)
  • os — operating-system and process helpers (os feature)
  • process — supervised children and versioned per-epoch PID records. Orphan termination uses the same validated process handle on Windows and a pidfd on supported Linux kernels. Other Unix targets immediately revalidate before a PID signal, with a documented residual PID-reuse window. Reaping captures a live descendant tree before killing the root, then identity-validates and confirms every captured descendant independently. A descendant that reparents before either capture snapshot observes it cannot be safely attributed and may remain.

Epoch record staging files are swept on the next manager startup. A narrow gap remains between process creation and identity-record publication; an orphan from that interval is deliberately not killed without authoritative identity.

Default features preserve the existing public API. Consumers that need a smaller dependency surface can disable default features and enable only the modules they use.