Connect to an SFTP Server

See more SFTP Examples

Demonstrates the Chilkat SFtp.Connect method, which establishes the SSH connection to an SFTP server. The first argument is the hostname (a DNS name or numeric IPv4/IPv6 address) and the second is the TCP port, usually 22. Connecting is the first of three setup steps.

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

    // Demonstrates the SFtp.Connect method, which establishes the SSH connection to an SFTP server.
    // The 1st argument is the hostname (a DNS name or numeric IP) and the 2nd is the TCP port.
    //
    // Connecting is only the first of three steps.  The full sequence is:
    //   1. Connect
    //   2. AuthenticatePw (or another authentication method)
    //   3. InitializeSftp

    const sftp = try chilkat.SFtp.init();
    defer sftp.deinit();

    // Step 1: Connect the SSH transport.  Port 22 is the usual port.
    const port = 22;
    sftp.connect("sftp.example.com", port) catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        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.
    const password = "mySshPassword";

    sftp.authenticatePw("mySshLogin", password) catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    // Step 3: Open the SFTP subsystem.  This must be done after authentication and before any
    // file or directory operations.
    sftp.initializeSftp() catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Connected, authenticated, and SFTP subsystem initialized.\n", .{});

    sftp.disconnect();
}