Rust

FTP Socket Buffer and Address Options

Demonstrates the SoRcvBuf, SoSndBuf, PreferIpv6, and ClientIpAddress properties.

Background: These are low-level knobs for specific situations. Larger send/receive buffers can improve throughput on high-bandwidth, high-latency links, though the defaults suit the common case. PreferIpv6 only matters when a hostname resolves to both address families, choosing which to try first. ClientIpAddress is normally left unset; set it on a multihomed host to bind the outgoing connection to a particular local interface. Change any of these only with a concrete reason.

Chilkat Rust Downloads

Download Chilkat for Rust

Rust


let ftp = chilkat::Ftp2::new();

ftp.set_hostname("ftp.example.com");
ftp.set_username("myFtpLogin");

// SoRcvBuf and SoSndBuf set the TCP socket receive/send buffer sizes.  The defaults are tuned for
// the common case; larger values can sometimes help throughput on high-latency links.
ftp.set_so_rcv_buf(4194304);
ftp.set_so_snd_buf(524288);

// PreferIpv6 (default false) chooses IPv6 over IPv4 when a hostname resolves to both.
ftp.set_prefer_ipv6(false);

// ClientIpAddress is normally left unset; set it on a multihomed host to bind the outgoing
// connection to a specific local interface.
ftp.set_client_ip_address("192.168.1.50");

// 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.
ftp.set_password("myPassword");

if ftp.connect().is_err() {
    println!("{}", ftp.last_error_text());
    return;
}

println!("Connected with custom socket options.");

if ftp.disconnect().is_err() {
    println!("{}", ftp.last_error_text());
    return;
}