Struct RemoteCommand 

pub struct RemoteCommand(/* private fields */);

A command string for the remote shell whose only constructors produce injection-safe text. ssh hands its trailing argument to the remote login shell, so a caller-built string would be a shell-injection sink; this type is the only thing RemoteShell::ssh_argv accepts. The inner string is private.

Implementations

impl RemoteCommand

pub fn powershell_encoded(script: &str) -> RemoteCommand

powershell -NoProfile -NonInteractive -EncodedCommand <base64>, where the payload is script as UTF-16LE. Base64 (A-Za-z0-9+/=) has no character any shell, cmd.exe or PowerShell treats specially, so the script cannot break out whatever the host’s default shell is.

pub fn posix(argv: &[&str]) -> Result<RemoteCommand, String>

A POSIX sh command line for argv: each argument single-quoted with every ' written '\'', joined by spaces. Inside single quotes a POSIX shell interprets nothing, so $(..), backticks, ;, !, * and the rest reach the program as literal text. Refused: an empty argv, and NUL or any other control character in any argument (a newline or tab would otherwise survive quoting and still be a hazard to every log and terminal it reaches).

pub fn as_str(&self) -> &str

The command text, exactly as it is sent.

Trait Implementations

impl Clone for RemoteCommand

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RemoteCommand

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

Formats the value using the given formatter.

impl Eq for RemoteCommand

impl PartialEq for RemoteCommand

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RemoteCommand