Expand description
Native-byte remote file identity and owned, read-only SSH/SFTP transport.
read belongs on a worker: it accepts that worker’s cancellation token and
returns an in-memory buffer or typed failure. Authentication and encryption
stay in system OpenSSH; no editor, CLI, view or rendering state lives here.
Structs§
- Remote
File - A validated
ssh://[user@]host[:port]/absolute/pathlocation. - Remote
Read Error - A fully diagnosed remote read failure. Carries everything a user needs to act: stage, classification, detail, bounded ssh stderr, the child’s exit line when observed, and a hint for fixable causes.
Enums§
- Address
Error - Why a textual remote location was refused. Every variant is a pure admission failure; none implies a subprocess was ever started.
- Read
Failure Kind - What went wrong, classified far enough to act on. Auth, trust and install problems carry hints; the rest are honest transport facts.
- Read
Stage - Where a remote read stopped. Retained so diagnostics name the phase instead of a bare transport error.
Functions§
- read
- Read one remote file into an in-memory read-only buffer.