Struct ClienteSsh 

pub struct ClienteSsh {
    pub sessao: Handle<ManipuladorCliente>,
    /* private fields */
}

Available on crate feature ssh-real only.

Cliente SSH ativo com sessão autenticada.

Fields

sessao: Handle<ManipuladorCliente>

Sessão SSH autenticada para operações de baixo nível.

Implementations

impl ClienteSsh

pub async fn conectar(cfg: ConfiguracaoConexao) -> ResultadoSshCli<Self>

Conecta e autentica. Todo o fluxo (TCP + handshake + auth) respeita o timeout_ms da configuração.

Erros

• ErroSshCli::ArgumentoInvalido se a configuração for inválida.
• ErroSshCli::TimeoutSsh se exceder o timeout total.
• ErroSshCli::ConexaoFalhou em falhas TCP/handshake.
• ErroSshCli::AutenticacaoFalhou se o servidor rejeitar senha/chave (tente --key, --password-stdin ou --key-passphrase-stdin).

pub async fn executar_comando( &mut self, comando: &str, max_chars: usize, stdin_data: Option<Vec<u8>>, ) -> ResultadoSshCli<SaidaExecucao>

Executa um comando shell remoto e captura stdout/stderr em paralelo.

Trunca cada stream em max_chars codepoints UTF-8. Respeita o timeout_ms da configuração para a execução inteira.

Erros

• ErroSshCli::CanalFalhou em falha ao abrir canal ou enviar exec.
• ErroSshCli::TimeoutSsh se exceder o timeout.

pub async fn upload( &mut self, local: &Path, remote: &Path, ) -> ResultadoSshCli<TransferenciaResultado>

Upload de arquivo local para remote via SCP (protocolo OpenSSH sink).

One-shot: stream em chunks (sem carregar o arquivo inteiro em RAM).

Erros

• ErroSshCli::ArquivoNaoEncontrado se o arquivo local não existir.
• ErroSshCli::ArgumentoInvalido se o path local não for arquivo regular.
• ErroSshCli::CanalFalhou em falha ao abrir canal SCP / status remoto.
• ErroSshCli::TimeoutSsh se exceder o timeout.

pub async fn download( &mut self, remote: &Path, local: &Path, ) -> ResultadoSshCli<TransferenciaResultado>

Download de arquivo remote para local via SCP (protocolo OpenSSH source).

Escreve em {local}.ssh-cli.partial e faz rename atômico (SCP-022).

Erros

• ErroSshCli::Io se não conseguir escrever o arquivo local.
• ErroSshCli::CanalFalhou em falha ao abrir canal SCP / status remoto.
• ErroSshCli::TimeoutSsh se exceder o timeout.

pub async fn desconectar(&self) -> ResultadoSshCli<()>

Encerra a sessão SSH de forma limpa.

Erros

Propaga falha se disconnect retornar erro do transporte.

pub async fn abrir_canal_tunel( &self, host_remoto: &str, porta_remota: u16, endereco_origem: &str, porta_origem: u16, ) -> ResultadoSshCli<Box<dyn CanalTunel>>

Abre canal direct-tcpip para forwarding SSH.

Trait Implementations

impl ClienteSshTrait for ClienteSsh

fn conectar<'async_trait>( cfg: ConfiguracaoConexao, ) -> Pin<Box<dyn Future<Output = Result<Box<Self>, ErroSshCli>> + Send + 'async_trait>>

where Self: 'async_trait,

Conecta a um servidor SSH e autentica com as credenciais fornecidas.

fn executar_comando<'life0, 'life1, 'async_trait>( &'life0 mut self, cmd: &'life1 str, max_chars: usize, stdin_data: Option<Vec<u8>>, ) -> Pin<Box<dyn Future<Output = Result<SaidaExecucao, ErroSshCli>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Executa um comando shell remoto e retorna a saída capturada.

fn upload<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, local: &'life1 Path, remote: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<TransferenciaResultado, ErroSshCli>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Faz upload de um arquivo local para o servidor remoto via SCP.

fn download<'life0, 'life1, 'life2, 'async_trait>( &'life0 mut self, remote: &'life1 Path, local: &'life2 Path, ) -> Pin<Box<dyn Future<Output = Result<TransferenciaResultado, ErroSshCli>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Faz download de um arquivo remoto para o sistema local via SCP.

fn abrir_canal_tunel<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, host_remoto: &'life1 str, porta_remota: u16, endereco_origem: &'life2 str, porta_origem: u16, ) -> Pin<Box<dyn Future<Output = Result<Box<dyn CanalTunel>, ErroSshCli>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Abre um canal direct-tcpip para forwarding de tunnel.

fn desconectar<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), ErroSshCli>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Encerra a conexão SSH de forma limpa.

impl Debug for ClienteSsh

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

Formats the value using the given formatter.