Rust

SSH Tunnel Thread Activity Log

Demonstrates the tunnel-log properties KeepTunnelLog, TunnelLog, and TunnelLogPath, which record the activity of the SSH tunnel and client-manager threads.

Note: The log paths are relative to the application's current working directory. Absolute paths may also be used.

Background: This is the counterpart to the accept log, covering the SSH side rather than the listener: the tunnel and client-manager threads that actually move data. As with the accept log, KeepTunnelLog enables the in-memory TunnelLog while TunnelLogPath writes a separate file. Together the two logs let you localize a problem to either the accepting side or the forwarding side.

Chilkat Rust Downloads

Download Chilkat for Rust

Rust


// Demonstrates the SshTunnel tunnel-log properties KeepTunnelLog, TunnelLog, and TunnelLogPath.
// 
// These log the activity of the SSH tunnel and client-manager threads.

let tunnel = chilkat::SshTunnel::new();

// Retain the SSH tunnel-thread activity in memory so it can be read from the TunnelLog property.
tunnel.set_keep_tunnel_log(true);

// Optionally also write the tunnel-thread activity to a file (separate from the in-memory log).
tunnel.set_tunnel_log_path("qa_output/tunnel.log");

tunnel.set_dest_hostname("db.internal.example.com");
tunnel.set_dest_port(5432);

let ssh_port = 22;
if tunnel.connect("ssh.example.com", ssh_port).is_err() {
    println!("{}", tunnel.last_error_text());
    return;
}

// Normally you would not hard-code the password in source.  You should instead obtain it
// from an interactive prompt, environment variable, or a secrets vault.
let password = "mySshPassword".to_string();

if tunnel.authenticate_pw("mySshLogin", &password).is_err() {
    println!("{}", tunnel.last_error_text());
    return;
}

let listen_port = 1080;
if tunnel.begin_accepting(listen_port).is_err() {
    println!("{}", tunnel.last_error_text());
    return;
}

// ... clients transfer data through the tunnel ...

// Read the accumulated in-memory tunnel log.
println!("{}", tunnel.tunnel_log());

let wait_for_thread_exit = true;
if tunnel.close_tunnel(wait_for_thread_exit).is_err() {
    println!("{}", tunnel.last_error_text());
    return;
}