Zig

SCP Download/Upload Binary Files as Encoded Strings

See more SCP Examples

Demonstrates how to upload and download binary files as encoded strings (base64, hex, etc.) using the SCP protocol (Secure Copy Protocol over SSH). Zig

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

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

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

    const ssh = try chilkat.Ssh.init();
    defer ssh.deinit();

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

    // Connect to an SSH server:
    ssh.connect(hostname, port) catch {
        std.debug.print("{s}\n", .{try ssh.getLastErrorText(alloc)});
        return;
    };

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

    // Authenticate using login/password:
    ssh.authenticatePw("myLogin", "myPassword") catch {
        std.debug.print("{s}\n", .{try ssh.getLastErrorText(alloc)});
        return;
    };

    // Once the SSH object is connected and authenticated, we use it
    // in our SCP object.
    const scp = try chilkat.Scp.init();
    defer scp.deinit();

    scp.useSsh(ssh) catch {
        std.debug.print("{s}\n", .{try scp.getLastErrorText(alloc)});
        return;
    };

    var remote_path: [:0]const u8 = "images/starfish.jpg";

    // Download the binary file and return as a base64 string.
    // See <a href="http://www.cknotes.com/chilkat-binary-encoding-list/">List of Encodings</a> for a list of possible encodings.
    const encoded_jpg = scp.downloadBinaryEncoded(alloc, remote_path, "base64") catch {
        std.debug.print("{s}\n", .{try scp.getLastErrorText(alloc)});
        return;
    };

    remote_path = "images/starfish2.jpg";

    // Now upload from the base64 string to the SSH server.
    // Insided the call to UploadBinaryEncoded, the base64 string is decoded,
    // and the decoded bytes are uploaded.  The resulting starfish2.jpg on the
    // server will be identical to the original starfish.jpg
    scp.uploadBinaryEncoded(remote_path, encoded_jpg, "base64") catch {
        std.debug.print("{s}\n", .{try scp.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("SCP download/upload binary encoded success.\n", .{});

    // Disconnect
    ssh.disconnect();
}