# peinit (peinit)

> Technical Reference Manual — the init system and service manager: boot, the service model, identity, supervision, jobs and operations, and shutdown.

The whole book as one markdown file: [/peios/advanced-peios/peinit/print.md](/peios/advanced-peios/peinit/print.md)

Contents:

- 1 [Introduction](/peios/advanced-peios/peinit/introduction/overview.md)
    - 1.1 [Overview](/peios/advanced-peios/peinit/introduction/overview.md)
    - 1.2 [What This Manual Covers](/peios/advanced-peios/peinit/introduction/what-this-manual-covers.md)
    - 1.3 [Terminology](/peios/advanced-peios/peinit/introduction/terminology.md)
    - 1.4 [Compatibility and Prior Art](/peios/advanced-peios/peinit/introduction/compatibility.md)
- 2 [Boot](/peios/advanced-peios/peinit/boot/the-initramfs-contract.md)
    - 2.1 [The Initramfs Contract](/peios/advanced-peios/peinit/boot/the-initramfs-contract.md)
    - 2.2 [Bootstrap Identity](/peios/advanced-peios/peinit/boot/bootstrap-identity.md)
    - 2.3 [Phase 1](/peios/advanced-peios/peinit/boot/phase-1.md)
    - 2.4 [Path Provisioning](/peios/advanced-peios/peinit/boot/path-provisioning.md)
    - 2.5 [Phase 2](/peios/advanced-peios/peinit/boot/phase-2.md)
    - 2.6 [Boot Modes](/peios/advanced-peios/peinit/boot/boot-modes.md)
    - 2.7 [The Boot Attempt Counter](/peios/advanced-peios/peinit/boot/the-boot-attempt-counter.md)
    - 2.8 [Recovery Mode](/peios/advanced-peios/peinit/boot/recovery-mode.md)
- 3 [The Service Model](/peios/advanced-peios/peinit/the-service-model/services.md)
    - 3.1 [Services](/peios/advanced-peios/peinit/the-service-model/services.md)
    - 3.2 [The Definition Schema](/peios/advanced-peios/peinit/the-service-model/the-definition-schema.md)
    - 3.3 [Field Formats](/peios/advanced-peios/peinit/the-service-model/field-formats.md)
    - 3.4 [Triggers](/peios/advanced-peios/peinit/the-service-model/triggers.md)
    - 3.5 [Conditions and Asserts](/peios/advanced-peios/peinit/the-service-model/conditions-and-asserts.md)
    - 3.6 [Command Strings](/peios/advanced-peios/peinit/the-service-model/command-strings.md)
    - 3.7 [Configuration Generations](/peios/advanced-peios/peinit/the-service-model/configuration-generations.md)
    - 3.8 [Service Removal](/peios/advanced-peios/peinit/the-service-model/service-removal.md)
- 4 [Service Identity](/peios/advanced-peios/peinit/service-identity/token-materialisation.md)
    - 4.1 [Token Materialisation](/peios/advanced-peios/peinit/service-identity/token-materialisation.md)
    - 4.2 [The SYSTEM Path](/peios/advanced-peios/peinit/service-identity/the-system-path.md)
    - 4.3 [The authd Path](/peios/advanced-peios/peinit/service-identity/the-authd-path.md)
    - 4.4 [Per-Service SIDs](/peios/advanced-peios/peinit/service-identity/per-service-sids.md)
    - 4.5 [Privilege Restriction](/peios/advanced-peios/peinit/service-identity/privilege-restriction.md)
    - 4.6 [Service Security Descriptors](/peios/advanced-peios/peinit/service-identity/service-security-descriptors.md)
    - 4.7 [The Control Descriptor](/peios/advanced-peios/peinit/service-identity/the-control-descriptor.md)
- 5 [Starting a Service](/peios/advanced-peios/peinit/starting-a-service/the-cgroup-tree.md)
    - 5.1 [The Cgroup Tree](/peios/advanced-peios/peinit/starting-a-service/the-cgroup-tree.md)
    - 5.2 [Pre-Start Evaluation](/peios/advanced-peios/peinit/starting-a-service/pre-start-evaluation.md)
    - 5.3 [The Pre-Exec Sequence](/peios/advanced-peios/peinit/starting-a-service/the-pre-exec-sequence.md)
    - 5.4 [The Child Path](/peios/advanced-peios/peinit/starting-a-service/the-child-path.md)
    - 5.5 [The Base Environment](/peios/advanced-peios/peinit/starting-a-service/the-base-environment.md)
    - 5.6 [Health Checks](/peios/advanced-peios/peinit/starting-a-service/health-checks.md)
    - 5.7 [Leaked Sub-Cgroups](/peios/advanced-peios/peinit/starting-a-service/leaked-sub-cgroups.md)
- 6 [The State Machine](/peios/advanced-peios/peinit/the-state-machine/states.md)
    - 6.1 [States](/peios/advanced-peios/peinit/the-state-machine/states.md)
    - 6.2 [Transitions](/peios/advanced-peios/peinit/the-state-machine/transitions.md)
    - 6.3 [Transition Causes](/peios/advanced-peios/peinit/the-state-machine/causes.md)
    - 6.4 [Restart](/peios/advanced-peios/peinit/the-state-machine/restart.md)
    - 6.5 [Reload](/peios/advanced-peios/peinit/the-state-machine/reload.md)
    - 6.6 [The Watchdog and Timeout Extension](/peios/advanced-peios/peinit/the-state-machine/watchdog-and-timeout-extension.md)
- 7 [Dependencies](/peios/advanced-peios/peinit/dependencies/relationships.md)
    - 7.1 [Relationships](/peios/advanced-peios/peinit/dependencies/relationships.md)
    - 7.2 [Graph Validation](/peios/advanced-peios/peinit/dependencies/graph-validation.md)
    - 7.3 [Graph Execution](/peios/advanced-peios/peinit/dependencies/graph-execution.md)
    - 7.4 [The Boot and On-Demand Paths](/peios/advanced-peios/peinit/dependencies/the-boot-and-on-demand-paths.md)
- 8 [Jobs and Operations](/peios/advanced-peios/peinit/jobs-and-operations/jobs.md)
    - 8.1 [Jobs](/peios/advanced-peios/peinit/jobs-and-operations/jobs.md)
    - 8.2 [Operations](/peios/advanced-peios/peinit/jobs-and-operations/operations.md)
    - 8.3 [Conflict Resolution](/peios/advanced-peios/peinit/jobs-and-operations/conflict-resolution.md)
    - 8.4 [Event Emission](/peios/advanced-peios/peinit/jobs-and-operations/event-emission.md)
    - 8.5 [Ad-Hoc Jobs](/peios/advanced-peios/peinit/jobs-and-operations/ad-hoc-jobs.md)
    - 8.6 [What a Caller Sees](/peios/advanced-peios/peinit/jobs-and-operations/the-control-protocol-view.md)
- 9 [Timers](/peios/advanced-peios/peinit/timers/calendar-expressions.md)
    - 9.1 [Calendar Expressions](/peios/advanced-peios/peinit/timers/calendar-expressions.md)
    - 9.2 [Evaluation and Arming](/peios/advanced-peios/peinit/timers/evaluation.md)
    - 9.3 [Persistence](/peios/advanced-peios/peinit/timers/persistence.md)
    - 9.4 [Jitter and Clocks](/peios/advanced-peios/peinit/timers/jitter-and-clocks.md)
- 10 [The Control Interface](/peios/advanced-peios/peinit/the-control-interface/the-control-socket.md)
    - 10.1 [The Control Socket](/peios/advanced-peios/peinit/the-control-interface/the-control-socket.md)
    - 10.2 [Dispatch and Authorisation](/peios/advanced-peios/peinit/the-control-interface/dispatch-and-authorisation.md)
    - 10.3 [The Command × State Matrix](/peios/advanced-peios/peinit/the-control-interface/the-command-state-matrix.md)
    - 10.4 [reload-config](/peios/advanced-peios/peinit/the-control-interface/reload-config.md)
    - 10.5 [The Notification Socket](/peios/advanced-peios/peinit/the-control-interface/the-notification-socket.md)
    - 10.6 [The Fd Store](/peios/advanced-peios/peinit/the-control-interface/the-fd-store.md)
- 11 [Output Handling](/peios/advanced-peios/peinit/output-handling/wiring.md)
    - 11.1 [Wiring](/peios/advanced-peios/peinit/output-handling/wiring.md)
    - 11.2 [The Pre-Eventd Buffer](/peios/advanced-peios/peinit/output-handling/the-pre-eventd-buffer.md)
    - 11.3 [Flood Protection](/peios/advanced-peios/peinit/output-handling/flood-protection.md)
    - 11.4 [The eventd Handoff](/peios/advanced-peios/peinit/output-handling/the-eventd-handoff.md)
    - 11.5 [Console Output](/peios/advanced-peios/peinit/output-handling/console-output.md)
- 12 [Shutdown](/peios/advanced-peios/peinit/shutdown/triggers.md)
    - 12.1 [Triggers](/peios/advanced-peios/peinit/shutdown/triggers.md)
    - 12.2 [The Graceful Sequence](/peios/advanced-peios/peinit/shutdown/the-graceful-sequence.md)
    - 12.3 [Signals](/peios/advanced-peios/peinit/shutdown/signals.md)
    - 12.4 [Finalisation](/peios/advanced-peios/peinit/shutdown/finalisation.md)
- 13 [Security](/peios/advanced-peios/peinit/security/trust-boundaries.md)
    - 13.1 [Trust Boundaries](/peios/advanced-peios/peinit/security/trust-boundaries.md)
    - 13.2 [peinit's Privileges](/peios/advanced-peios/peinit/security/privileges.md)
    - 13.3 [The Attack Surface](/peios/advanced-peios/peinit/security/the-attack-surface.md)
    - 13.4 [Security Invariants](/peios/advanced-peios/peinit/security/invariants.md)
- 14 [Failure Modes](/peios/advanced-peios/peinit/failure-modes/losing-the-registry.md)
    - 14.1 [Losing the Registry](/peios/advanced-peios/peinit/failure-modes/losing-the-registry.md)
    - 14.2 [Losing a Dependency](/peios/advanced-peios/peinit/failure-modes/losing-a-dependency.md)
    - 14.3 [Unkillable Processes](/peios/advanced-peios/peinit/failure-modes/unkillable-processes.md)
    - 14.4 [Resource Exhaustion](/peios/advanced-peios/peinit/failure-modes/resource-exhaustion.md)
    - 14.5 [Power Loss and Corruption](/peios/advanced-peios/peinit/failure-modes/power-loss-and-corruption.md)
- Appendix A [Registry Key Reference](/peios/advanced-peios/peinit/registry-keys.md)
- Appendix B [Constants and Paths](/peios/advanced-peios/peinit/constants-and-paths.md)
