Zig

SFTP Get/Set File Permission

See more SFTP Examples

Demonstrates how to set the permissions of a file on the SFTP server. Zig

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

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

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

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

    // Connect to the SSH/SFTP server.
    const hostname = "sftp.example.com";
    const port = 22;
    sftp.connect(hostname, port) catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    // Authenticate with the SSH server.  Chilkat SFTP supports
    // both password-based authenication as well as public-key
    // authentication.  This example uses password authenication.
    sftp.authenticatePw("myLogin", "myPassword") catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    // After authenticating, the SFTP subsystem must be initialized:
    sftp.initializeSftp() catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    // Get the file permissions for the "hamlet.xml" file on the server.
    // The hamlet.xml file is located in the qa_data directory found under the HOME directory of the SSH user account.
    // We are passing the remote file path (we are not passing a file handle returned by a previous call to OpenFile).
    const is_handle = false;
    const follow_links = true;
    const perm_val = sftp.getFilePermissions("qa_data/hamlet.xml", follow_links, is_handle);
    if (perm_val < 0) {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    }

    // Note: Filesystem permissions on Linux/Unix/MacOSX are typically written in octal (POSIX file permissions).  For example 0644 is octal.
    // To convert to decimal: octal 644 = 6*8^2 + 4*8 + 4 = 420 (decimal)
    //
    // The server may return a permissions value (in octal) such as 100644.
    // The "100" indicates the file type, such as regular file or directory.

    // Show the decimal value of the permissions
    std.debug.print("decimal permissions value: {d}\n", .{perm_val});

    // To set the file permissions, pass the integer value.
    // Let's change the permissions to 0664, which is 6*8^2 + 6*8 + 4 = 436 (decimal)
    sftp.setPermissions("qa_data/hamlet.xml", is_handle, 436) catch {
        std.debug.print("{s}\n", .{try sftp.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Success.\n", .{});
}