Struct spurs::ssh::SshShell

pub struct SshShell { /* fields omitted */ }

Represents a connection via SSH to a particular source.

Methods

impl SshShell

pub fn with_default_key<A: ToSocketAddrs + Debug>(     username: &str,     remote: A ) -> Result<Self, Error>

Returns a shell connected via the default private key at $HOME/.ssh/id_rsa to the given SSH server as the given user.

SshShell::with_default_key("markm", "myhost:22")?;

pub fn with_key<A: ToSocketAddrs + Debug, P: AsRef<Path>>(     username: &str,     remote: A,     key: P ) -> Result<Self, Error>

Returns a shell connected via private key file key to the given SSH server as the given user.

SshShell::with_key("markm", "myhost:22", "/home/foo/.ssh/id_rsa")?;

pub fn toggle_dry_run(&mut self)

Toggles dry run mode. In dry run mode, commands are not executed remotely; we only print what commands we would execute. Note that we do connect remotely, though. This is off by default: we default to actually running the commands.

Trait Implementations

impl Execute for SshShell

type SshSpawnHandle = SshSpawnHandle

fn run(&self, cmd: SshCommand) -> Result<SshOutput, Error>

Run a command on the remote machine, blocking until the command completes.

Note that command using sudo will hang indefinitely if sudo asks for a password.

fn spawn(&self, cmd: SshCommand) -> Result<SshSpawnHandle, Error>

Run a command on the remote machine, without blocking until the command completes. A handle is returned, which one can join on to wait for process completion.

Note that command using sudo will hang indefinitely if sudo asks for a password.

fn reconnect(&mut self) -> Result<(), Error>

Attempt to reconnect to the remote until it reconnects (possibly indefinitely).