SmbMount Class Reference

Inheritance diagram for SmbMount:

Static Public Member Functions
static bool	is_available (out string error_message)
static string	mount (SmbShare share, out string error_message)
static bool	unmount (SmbShare share)
static bool	unmount_path (string mount_point)
static bool	is_mounted_at (string mount_point)
static Gee.ArrayList< SmbShare >	list_active_mounts ()
static Gee.ArrayList< SmbShare >	load_saved_shares ()
static void	save_share (SmbShare share)
static void	forget_share (SmbShare share)

Properties
static string	mount_root [get]

Static Private Member Functions
static void	write_shares (Gee.ArrayList< SmbShare > list)

Static Private Attributes
const string	SHARES_CONF = "/etc/bastionguard-backup/smb-shares.json"

Detailed Description

Static helper: drives mount.cifs, tracks active mounts and persists the user's recently-used shares.

Definition at line 88 of file SmbMount.vala.

Member Function Documentation

forget_share()

void SmbMount.forget_share ( SmbShare share )

inlinestatic

Definition at line 371 of file SmbMount.vala.

                                                   {
        var list = load_saved_shares();
        var keep = new Gee.ArrayList<SmbShare>();
        foreach (var existing in list){
            if (existing.server == share.server
                && existing.share == share.share
                && existing.subpath == share.subpath){
                continue;
            }
            keep.add(existing);
        }
        write_shares(keep);
    }

References load_saved_shares(), and write_shares().

is_available()

bool SmbMount.is_available ( out string error_message )

inlinestatic

Returns true if both mount.cifs and cifs-utils look usable on this system. Sets error_message with a hint otherwise.

Definition at line 109 of file SmbMount.vala.

                                                             {
        error_message = "";
        if (!cmd_exists("mount.cifs")){
            error_message = _("Network shares (SMB/CIFS) are not available on this system.")
                + "\n\n"
                + _("Please install the 'cifs-utils' package and try again.");
            return false;
        }
        return true;
    }

References _.

Referenced by mount(), and BackupDeviceBox.on_add_smb_share_clicked().

is_mounted_at()

bool SmbMount.is_mounted_at ( string mount_point )

inlinestatic

Definition at line 261 of file SmbMount.vala.

                                                        {
        try {
            string contents;
            FileUtils.get_contents("/proc/mounts", out contents);
            foreach (string line in contents.split("\n")){
                var parts = line.split(" ");
                if (parts.length >= 3 && parts[1] == mount_point && parts[2] == "cifs"){
                    return true;
                }
            }
        }
        catch (Error e){
            log_debug(e.message);
        }
        return false;
    }

References Error, and TeeJee.Logging.log_debug().

Referenced by mount().

list_active_mounts()

Gee.ArrayList< SmbShare > SmbMount.list_active_mounts ( )

inlinestatic

Returns every CIFS mount currently visible in /proc/mounts as an SmbShare with the mount_point field populated. Username and credentials are NOT recoverable from the kernel.

Definition at line 283 of file SmbMount.vala.

                                                              {
        var list = new Gee.ArrayList<SmbShare>();
        try {
            string contents;
            FileUtils.get_contents("/proc/mounts", out contents);
            foreach (string line in contents.split("\n")){
                if (line.strip().length == 0){ continue; }
                var parts = line.split(" ");
                if (parts.length < 3){ continue; }
                if (parts[2] != "cifs" && parts[2] != "smb3"){ continue; }
 
                string source = parts[0]; // e.g. //server/share
                string mp     = parts[1];
 
                // /proc/mounts escapes spaces as \040 etc — decode.
                mp = mp.replace("\\040", " ");
 
                var share = new SmbShare();
                share.mount_point = mp;
                if (source.has_prefix("//")){
                    string rest = source.substring(2);
                    int slash = rest.index_of("/");
                    if (slash > 0){
                        share.server = rest.substring(0, slash);
                        share.share  = rest.substring(slash + 1);
                    }
                    else {
                        share.server = rest;
                    }
                }
                list.add(share);
            }
        }
        catch (Error e){
            log_debug(e.message);
        }
        return list;
    }

References Error, and TeeJee.Logging.log_debug().

Referenced by BackupDeviceBox.device_list_refresh().

load_saved_shares()

Gee.ArrayList< SmbShare > SmbMount.load_saved_shares ( )

inlinestatic

Definition at line 324 of file SmbMount.vala.

                                                             {
        var list = new Gee.ArrayList<SmbShare>();
        var f = File.new_for_path(SHARES_CONF);
        if (!f.query_exists()){
            return list;
        }
        try {
            var parser = new Json.Parser();
            parser.load_from_file(SHARES_CONF);
            var root = parser.get_root();
            if (root == null){ return list; }
            var arr = root.get_array();
            if (arr == null){ return list; }
            arr.foreach_element((a, idx, node) => {
                var obj = node.get_object();
                if (obj != null){
                    list.add(SmbShare.from_json(obj));
                }
            });
        }
        catch (Error e){
            log_error("SmbMount.load_saved_shares(): " + e.message);
        }
        return list;
    }

References Error, SmbShare.from_json(), TeeJee.Logging.log_error(), and SHARES_CONF.

Referenced by forget_share(), and save_share().

mount()

string SmbMount.mount ( SmbShare share, out string error_message )

inlinestatic

Mount the SMB share described by share. On success the mount_point field of share is populated and the path is returned. On failure returns an empty string and error_message carries a translated explanation.

Definition at line 126 of file SmbMount.vala.

                                                                        {
        error_message = "";
 
        if (share.server.length == 0 || share.share.length == 0){
            error_message = _("Server and share name must both be provided.");
            return "";
        }
 
        string avail_err;
        if (!is_available(out avail_err)){
            error_message = avail_err;
            return "";
        }
 
        // Build a stable-but-readable mount point.
        string slug = "%s_%s".printf(
            share.server.replace("/", "_").replace(":", "_"),
            share.share.replace("/", "_"));
        string mp = path_combine(mount_root, slug);
        dir_create(mp);
 
        // Already mounted at our path? Reuse.
        if (is_mounted_at(mp)){
            share.mount_point = mp;
            log_msg(_("SMB share already mounted at") + ": %s".printf(mp));
            return mp;
        }
 
        // Build mount options. We deliberately keep them conservative
        // so most NASes "just work" while still allowing rsync to set
        // permissions and create hardlinks.
        var opts = new Gee.ArrayList<string>();
 
        // Credentials. Empty user => guest mount.
        if (share.username.length > 0){
            opts.add("username=" + share.username);
            if (share.password.length > 0){
                opts.add("password=" + share.password);
            }
            if (share.domain.length > 0){
                opts.add("domain=" + share.domain);
            }
        }
        else{
            opts.add("guest");
        }
 
        // Run as root inside the mount (rsync needs this to
        // preserve ownership of system files).
        opts.add("uid=0");
        opts.add("gid=0");
        opts.add("file_mode=0644");
        opts.add("dir_mode=0755");
 
        // Prefer the most modern dialect that is widely supported.
        opts.add("vers=3.0");
 
        // rsync uses unix sockets/temp files inside the share, so allow
        // "noperm" as a fallback if the server is overly strict. This
        // is safe because the device side already gates access.
        opts.add("noperm");
 
        string opt_str = string.joinv(",", opts.to_array());
 
        string unc = "//%s/%s".printf(share.server, share.share);
        // mount.cifs takes the share without the optional subpath; the
        // subpath is just appended to the resulting mount_point later.
 
        string cmd = "mount -t cifs -o %s \"%s\" \"%s\"".printf(
            Shell.quote(opt_str).replace("'", "'\\''"),
            unc,
            mp);
 
        // Avoid leaking the password into the log
        string safe_opt_str = opt_str;
        if (share.password.length > 0){
            safe_opt_str = safe_opt_str.replace(
                "password=" + share.password, "password=***");
        }
        log_debug("SmbMount.mount(): mount -t cifs -o %s %s %s".printf(
            safe_opt_str, unc, mp));
 
        string std_out, std_err;
        int ret_val = exec_sync(cmd, out std_out, out std_err);
 
        if (ret_val != 0){
            // Map a few common errors to friendlier messages.
            string err = (std_err ?? "").strip();
            if (err.length == 0){ err = (std_out ?? "").strip(); }
 
            if (err.down().contains("permission denied")
                || err.down().contains("logon failure")
                || err.down().contains("nt_status_logon_failure")){
                error_message = _("Authentication failed. Please check the username, password and domain.");
            }
            else if (err.down().contains("no route to host")
                || err.down().contains("connection refused")
                || err.down().contains("connection timed out")
                || err.down().contains("host is down")){
                error_message = _("Could not reach the server. Please check the address and that the share is online.");
            }
            else if (err.down().contains("no such file or directory")
                || err.down().contains("bad share name")){
                error_message = _("The share was not found on the server. Please check the share name.");
            }
            else{
                error_message = _("Failed to mount the network share.") + "\n\n" + err;
            }
            log_error(error_message);
            return "";
        }
 
        share.mount_point = mp;
        log_msg(_("Mounted network share") + ": %s → %s".printf(unc, mp));
        return mp;
    }

References _, TeeJee.FileSystem.dir_create(), SmbShare.domain, TeeJee.ProcessHelper.exec_sync(), is_available(), is_mounted_at(), TeeJee.Logging.log_debug(), TeeJee.Logging.log_error(), TeeJee.Logging.log_msg(), mount_root, SmbShare.password, TeeJee.FileSystem.path_combine(), SmbShare.server, SmbShare.share, and SmbShare.username.

Referenced by SmbShareDialog.on_connect_clicked().

save_share()

void SmbMount.save_share ( SmbShare share )

inlinestatic

Definition at line 350 of file SmbMount.vala.

                                                 {
        // merge: replace if the same server+share+subpath already exists,
        // otherwise append.
        var list = load_saved_shares();
        bool replaced = false;
        for (int i = 0; i < list.size; i++){
            var existing = list[i];
            if (existing.server == share.server
                && existing.share == share.share
                && existing.subpath == share.subpath){
                list[i] = share;
                replaced = true;
                break;
            }
        }
        if (!replaced){
            list.add(share);
        }
        write_shares(list);
    }

References load_saved_shares(), SmbShare.server, SmbShare.share, SmbShare.subpath, and write_shares().

Referenced by SmbShareDialog.on_connect_clicked().

unmount()

bool SmbMount.unmount ( SmbShare share )

inlinestatic

Definition at line 243 of file SmbMount.vala.

                                              {
        if (share.mount_point.length == 0){
            return true;
        }
        bool ok = Device.unmount(share.mount_point);
        if (ok){
            share.mount_point = "";
        }
        return ok;
    }

References SmbShare.mount_point, and Device.unmount().

unmount_path()

bool SmbMount.unmount_path ( string mount_point )

inlinestatic

Definition at line 254 of file SmbMount.vala.

                                                       {
        if (mount_point.length == 0){
            return true;
        }
        return Device.unmount(mount_point);
    }

References Device.unmount().

write_shares()

void SmbMount.write_shares ( Gee.ArrayList< SmbShare > list )

inlinestaticprivate

Definition at line 385 of file SmbMount.vala.

                                                                  {
        try {
            dir_create(GLib.Path.get_dirname(SHARES_CONF));
            var arr = new Json.Array();
            foreach (var s in list){
                arr.add_object_element(s.to_json());
            }
            var node = new Json.Node(Json.NodeType.ARRAY);
            node.set_array(arr);
 
            var generator = new Json.Generator();
            generator.pretty = true;
            generator.set_root(node);
            generator.to_file(SHARES_CONF);
 
            // Best effort: lock down the file because it contains
            // usernames (no passwords, but still).
            Posix.chmod(SHARES_CONF, 0600);
        }
        catch (Error e){
            log_error("SmbMount.write_shares(): " + e.message);
        }
    }

References TeeJee.FileSystem.dir_create(), Error, TeeJee.Logging.log_error(), and SHARES_CONF.

Referenced by forget_share(), and save_share().

Member Data Documentation

SHARES_CONF

const string SmbMount.SHARES_CONF = "/etc/bastionguard-backup/smb-shares.json"

staticprivate

Definition at line 103 of file SmbMount.vala.

Referenced by load_saved_shares(), and write_shares().

Property Documentation

mount_root

string SmbMount.mount_root

staticget

Definition at line 93 of file SmbMount.vala.

                                    {
        owned get {
            return (App != null && App.mount_point_app.length > 0)
                ? App.mount_point_app + "/smb"
                : "/run/bastionguard-backup/smb";
        }
    }

Referenced by mount().

---

The documentation for this class was generated from the following file:

• BastionGuard/thirdparty/bastionguard-backup/src/Utility/SmbMount.vala