docs(sftp): document server operations (#3391)

Adds an operator guide for the SFTP server: recommended
configuration, the path model, host keys on Unix and Windows, the
environment variable reference, session cleanup behaviour, IAM
policy requirements per SFTP operation, client compatibility
notes, multipart upload sizing and cleanup, and the log lines
worth alerting on.

Corrects documentation the platform change left stale. The module
overview and the UnsupportedPlatform error text still described
Windows as unsupported. A source comment referenced a document
that does not exist in the repository and now points at the new
guide. The changelog adds the two host-key reload variables
missing from its environment list, describes the banner variable
as the SSH identification string, and corrects the upload size
cap and compliance case count.
This commit is contained in:
escapecode
2026-06-12 15:52:00 +01:00
committed by GitHub
parent f1a35bb9e2
commit b6973636b6
5 changed files with 334 additions and 16 deletions
+4 -2
View File
@@ -81,8 +81,10 @@
//! handler dispatch type. SftpError is the error type returned by SFTP
//! operations.
//!
//! Platform support. Host-key permission enforcement uses Unix mode bits.
//! On non-Unix targets SftpConfig::load_host_keys returns
//! Platform support. On Unix the host-key loader enforces owner-only mode
//! bits. On Windows it loads host keys without a mode check and trusts the
//! operator-managed NTFS ACLs on the key directory. On targets that are
//! neither Unix nor Windows, SftpConfig::load_host_keys returns
//! SftpInitError::UnsupportedPlatform and the SFTP listener does not start.
//!
//! Peer-initiated signal requests on an open SFTP channel are intercepted