ssh-rs 0.5.0

In addition to encryption library, pure RUST implementation of SSH-2.0 client protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use super::channel::Channel;
use crate::error::SshResult;
use crate::model::Data;
use crate::{
    constant::{ssh_connection_code, ssh_str},
    SshError,
};
use std::{
    io::{Read, Write},
    ops::{Deref, DerefMut},
};

pub struct ChannelExec<S: Read + Write> {
    channel: Channel<S>,
    command_send: bool,
}

impl<S> ChannelExec<S>
where
    S: Read + Write,
{
    pub(crate) fn open(channel: Channel<S>) -> Self {
        Self {
            channel,
            command_send: false,
        }
    }

    /// Send an executable command to the server
    ///
    pub fn exec_command(&mut self, command: &str) -> SshResult<()> {
        if self.command_send {
            return Err(SshError::GeneralError(
                "An exec channle can only send one command".to_owned(),
            ));
        }

        tracing::debug!("Send command {}", command);
        self.command_send = true;
        let mut data = Data::new();
        data.put_u8(ssh_connection_code::CHANNEL_REQUEST)
            .put_u32(self.server_channel_no)
            .put_str(ssh_str::EXEC)
            .put_u8(true as u8)
            .put_str(command);
        self.send(data)
    }

    /// Get the output of the previous command
    ///
    pub fn get_output(&mut self) -> SshResult<Vec<u8>> {
        let r: Vec<u8> = self.recv_to_end()?;
        Ok(r)
    }

    /// Send an executable command to the server
    /// and get the result
    ///
    /// This method also implicitly consume the channel object,
    /// since the exec channel can only execute one command
    ///
    pub fn send_command(mut self, command: &str) -> SshResult<Vec<u8>> {
        self.exec_command(command)?;

        self.get_output()
    }
}

impl<S> Deref for ChannelExec<S>
where
    S: Read + Write,
{
    type Target = Channel<S>;
    fn deref(&self) -> &Self::Target {
        &self.channel
    }
}

impl<S> DerefMut for ChannelExec<S>
where
    S: Read + Write,
{
    fn deref_mut(&mut self) -> &mut Self::Target {
        &mut self.channel
    }
}