Close an IMAP SSH Tunnel

See more IMAP Examples

Demonstrates the Chilkat Imap.SshCloseTunnel method, which closes the SSH tunnel opened by SshOpenTunnel. It takes no arguments. Any IMAP connection that was using the tunnel must not be used after the tunnel is closed.

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

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

    // Demonstrates the Imap.SshCloseTunnel method, which closes the SSH tunnel opened by
    // SshOpenTunnel.  It takes no arguments.  Any IMAP connection using the tunnel must not be
    // used after the tunnel is closed.

    const imap = try chilkat.Imap.init();
    defer imap.deinit();

    const ssh_port = 22;
    imap.sshOpenTunnel("ssh.example.com", ssh_port) catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // The SSH password is not hard-coded in source.  Insert code here to obtain it from an
    // interactive prompt, environment variable, or a secrets vault.
    const ssh_password: [:0]const u8 = "";

    imap.sshAuthenticatePw("sshUser", ssh_password) catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // With the SSH tunnel in place, connect and log in to the IMAP server as usual.  The IMAP
    // traffic flows through the tunnel automatically.
    imap.setSsl(true);
    imap.setPort(993);
    imap.connect("imap.example.com") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    imap.login("user@example.com", "myPassword") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // ... use the IMAP connection ...

    imap.disconnect() catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // Close the SSH tunnel.  Do not use the IMAP connection after this point.
    imap.sshCloseTunnel() catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };
}