/usr/share/doc/psh
Documentation_
Setup guides, command reference, and protocol specifications.
Make your first connection.
Build in a disposable VM, create paired identities, verify your host, and connect.
Getting startedStart here
Getting started
Connect inside the disposable guest: identities, authorization, host trust, and a first session.
Build & install
VM builds, pinned dependencies, installation paths, and staged packaging.
Disposable VM
Guest prerequisites, lifecycle, source sync, and troubleshooting with the QEMU helper.
Configuration examples
The project’s commented client and server YAML templates, ready to inspect or download.
Command reference
psh(1) — Client
Connection options, identities, host trust, signals, and exit status.
pshd(8) — Daemon
Daemon startup, runtime requirements, configuration checks, reloads, and shutdown.
psh_config(5) — Configuration
Client and server YAML schemas, path rules, permissions, defaults, and resource limits.
Under the hood
Protocol & security boundaries
Admission, encrypted datagrams, reliable delivery, sessions, and process isolation.
Paired authentication
The exact psh/3 identity encodings, transcripts, connection binding, and broker state rules.
Cryptography & key storage
The mandatory algorithm profile, private-key protection, fingerprints, and host pins.
Design paper
The extended rationale, threat model, architecture, and recorded experimental evidence.
Development
Testing & validation
Run the current VM test suites and understand the limits of their evidence.
Historical validation records
Dated November 2026 test results and review findings, each tied to its recorded candidate.
Vendored dependencies
Pinned OpenSSL and libyaml sources, checksums, provenance, and build policy.
Contributing
Read the implementation, reproduce behavior in the disposable guest, and make focused changes with evidence.
Experimental software. Read security & scope before evaluating psh. These guides describe the source snapshot recorded on each page.