Struct SessionRecording 

pub struct SessionRecording { /* private fields */ }

A live session recording (Go’s recording plus its loggingWriter).

Implementations

impl SessionRecording

pub async fn start<D: RecorderDialer>( recorders: &[SocketAddr], on_failure: Option<&SshRecorderFailureAction>, header: &CastHeader, dialer: &D, ) -> Result<Option<Self>, RecordingRejected>

Start recording this session, or decide the session may proceed without a recording.

Port of Go sshSession.startNewRecording. The three outcomes are Go’s three:

• Ok(Some(rec)) — a recorder accepted the recording and the header is written.
• Ok(None) — recording could not start and the policy fails open; run the session unrecorded (Go’s return nil, nil).
• Err(_) — the session must be refused (Go’s userVisibleError, or a header that could not be written — Go exits the session in both cases).

pub fn recorder(&self) -> SocketAddr

The recorder this session is streamed to.

pub fn take_terminate(&mut self) -> Option<Receiver<String>>

Take the channel that fires with the message to show the client when the upload failed and the policy says terminate. Yields None after the first call.

pub async fn record_output(&mut self, data: &[u8]) -> Result<(), String>

Record one chunk of session output, then let the caller forward it to the client.

Port of Go loggingWriter.Write: the cast line is written first, and a failure to write it only stops the session when the policy is fail-closed. Only output is recorded — Go deliberately does not record input, which may contain passwords.

Err means the session must be terminated (the policy is fail-closed on a broken recording); the error is the message to show the client.

Trait Implementations

impl Debug for SessionRecording

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.