# Peios Learn

> Concepts, guides, and reference for the Peios operating system and every project around it — from the kernel to the toolchain that builds it.

Every page on this site is also available as markdown at the same URL with `.md` appended. Each section below links whole units as single markdown files. The full machine-readable structure is at /site.json.

## Peios

- [Peios overview](/peios.md): The operating system itself — identity, tokens, security descriptors, processes, and the kernel subsystems behind them.
- [All Peios docs in one file](/peios/print.md)
- [Peios Security Fundamentals](/peios/security-fundamentals/print.md): The Peios Security Model.
- [Using Peios](/peios/using-peios/print.md): Operating a Peios system — the registry, filesystems, and the everyday tools.
- [Peiosutils](/peios/using-peios/peiosutils/print.md): The Peios core utilities — the everyday commands, reworked for the Peios security model.
- [Peios Events Index](/peios/using-peios/events/print.md): Every event Peios emits, in one place — the KMES envelope, the shared subject and process records, and a field-by-field schema for each event from the kernel, the filesystem, the registry, peinit, peipkg and eventd.
- [Advanced Peios](/peios/advanced-peios/print.md): The deeper end of Peios — internals and behaviour beyond everyday operation.
- [Conventions for Specifications and TRMs](/peios/advanced-peios/conventions/print.md): How the documents of this anthology are written and read — normative language, required structure, citation and addressing, and the style rules for specifications and for technical reference manuals.
- [Peios Common Data Structures](/peios/advanced-peios/pcds/print.md): The common binary data structures shared across Peios subsystems: the GUID, LUID, and SID identifier types, and the security descriptor family.
- [Peios Generic System Standards](/peios/advanced-peios/pgss/print.md): The cross-platform standards a system must implement to be Peios — contracts between two roles, either of which a third party may replace.
- [Peios System Protocols Kernel](/peios/advanced-peios/pspk/print.md): The contracts spoken across the kernel boundary — the protocols a Peios kernel subsystem depends on a userspace process to fulfil, and the formats it exchanges with one.
- [Peios System Protocols Userspace](/peios/advanced-peios/pspu/print.md): The foundational userspace protocols — public, stable contracts between the components a Peios system is built from, which third parties may implement.
- [Peios Kernel](/peios/advanced-peios/peios-kernel/print.md): The Peios kernel as it is built: the KMES event subsystem, the KACS access control system, the stratafs layered filesystem, and the LCS registry.
- [peinit](/peios/advanced-peios/peinit/print.md): Technical Reference Manual — the init system and service manager: boot, the service model, identity, supervision, jobs and operations, and shutdown.
- [loregd](/peios/advanced-peios/loregd/print.md): Local Registry Daemon — the SQLite-backed RSI source that provides the Machine and Users hives: storage, concurrency, and request handling.
- [eventd](/peios/advanced-peios/eventd/print.md): Technical Reference Manual Proposal — the observability daemon as designed: event, log and metric ingestion, three storage engines, adaptive acceleration, and query execution.
- [peipkg](/peios/advanced-peios/peipkg/print.md): Technical Reference Manual — the package manager: repositories and trust, dependency resolution, installation, transactions and rollback, roles and claims, and package production.
- [Developing for Peios](/peios/developing-for-peios/print.md): How to build software for Peios.
- [SDK Reference](/peios/developing-for-peios/sdk-reference/print.md): Header-by-header reference for the Peios SDK — the conventions every call follows, then security descriptors, tokens, access checks, files, processes, the registry, events, msgpack, and the registry-source interface.
- [Peiso](/peios/peiso/print.md): The Peios image builder — from a declarative peiso.toml to a composed root, packed initramfs, UKI, and bootable live ISO.

## pekit

- [pekit overview](/pekit.md): The recipe-driven build and packaging tool — declarative recipes in; built, tested, packaged software out.
- [All pekit docs in one file](/pekit/print.md)
- [Getting started](/pekit/getting-started/print.md): 2 articles
- [Writing recipes](/pekit/recipes/print.md): 7 articles
- [Running pekit](/pekit/running/print.md): 4 articles
- [Reference](/pekit/reference/print.md): 3 articles

## Provium

- [Provium overview](/provium.md): A KVM-backed test harness — tests written in Lua, run inside real virtual machines against a real kernel.
- [All Provium docs in one file](/provium/print.md)
- [Getting started](/provium/getting-started/print.md): 3 articles
- [Writing tests](/provium/writing-tests/print.md): 8 articles
- [Running tests](/provium/running-tests/print.md): 4 articles
- [Configuration](/provium/configuration/print.md): 3 articles
- [Reference](/provium/reference/print.md): 19 articles

## Universal Directory

- [Universal Directory overview](/universal-directory.md): A self-hosted directory service in the Active Directory lineage.
- [All Universal Directory docs in one file](/universal-directory/print.md)
- [Getting started](/universal-directory/getting-started/print.md): 2 articles
- [Concepts](/universal-directory/concepts/print.md): 5 articles
- [The console](/universal-directory/the-console/print.md): 1 articles
- [Reference](/universal-directory/reference/print.md): 3 articles

## Trail

- [Trail overview](/trail.md): The static site builder behind Peios Learn.
- [All Trail docs in one file](/trail/print.md)
- [Getting started](/trail/getting-started/print.md): 3 articles
- [Structuring a site](/trail/structuring-a-site/print.md): 5 articles
- [Writing](/trail/writing/print.md): 6 articles
- [Building](/trail/building/print.md): 6 articles
- [Reference](/trail/reference/print.md): 4 articles

## Project

- [Project overview](/project.md): Project-level policy for Peios: how to report security vulnerabilities, what licences Peios ships under, and how to obtain the corresponding source for any published binary.
- [All Project docs in one file](/project/print.md)
- [Policies](/project/policies/print.md): 2 articles

## Wispist

- [Wispist overview](/wispist.md): Persistent JSON documents and live updates for simple browser sites — no connection step, no application server.
- [All Wispist docs in one file](/wispist/print.md)
- [Getting started](/wispist/getting-started/print.md): 2 articles
- [Using Wispist](/wispist/using-wispist/print.md): 3 articles
- [Reference](/wispist/reference/print.md): 4 articles
- [Problems](/wispist/problems/print.md): 15 articles