Rust

SCP Upload Contents of String to Remote File

See more SCP Examples

Demonstrates how to upload the contents of a string variable using the SCP protocol (Secure Copy Protocol over SSH). The text is uploaded to a file in specific remote directory. If the file did not already exist, it is created. If it already existed, it is overwritten. Rust

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

let ssh = chilkat::Ssh::new();

// Connect to an SSH server:

// Hostname may be an IP address or hostname:
let hostname = "www.some-ssh-server.com".to_string();
let port = 22;

if ssh.connect(&hostname, port).is_err() {
    println!("{}", ssh.last_error_text());
    return;
}

// Wait a max of 5 seconds when reading responses..
ssh.set_idle_timeout_ms(5000);

// Authenticate using login/password:
if ssh.authenticate_pw("myLogin", "myPassword").is_err() {
    println!("{}", ssh.last_error_text());
    return;
}

// Once the SSH object is connected and authenticated, we use it
// as the underlying transport in our SCP object.
let scp = chilkat::Scp::new();

if scp.use_ssh(&ssh).is_err() {
    println!("{}", scp.last_error_text());
    return;
}

let content = "This string will be the contents of the remote file.".to_string();
let mut remote_path = "uploads/text/testUtf8.txt".to_string();

// The utf-8 byte representation of the string will be uploaded.
// See https://www.chilkatsoft.com/p/p_463.asp for a list of valid charsets.
let mut charset = "utf-8".to_string();

// This uploads to the "uploads/text" directory relative to the HOME
// directory of the SSH user account.  
// Note: The remote target directory must already exist on the SSH server.
if scp.upload_string(&remote_path, &content, &charset).is_err() {
    println!("{}", scp.last_error_text());
    return;
}

remote_path = "uploads/text/testUtf8_withBOM.txt".to_string();

// To include the utf-8 preamble (also known as the BOM),
// prefix the charset name with "bom:".  Any charset that can 
// optionally include a BOM can be specified in this way.
charset = "bom:utf-8".to_string();

// Uploads to a remote file that contains text in the 
// utf-8 representation, including the BOM at the start of the file.
if scp.upload_string(&remote_path, &content, &charset).is_err() {
    println!("{}", scp.last_error_text());
    return;
}

println!("SCP upload string success.");

// Disconnect
ssh.disconnect();