x2gomountdirs(8)

💅 x2gomountdirs(8) — X2Go Server Tool

okay bestie, gather round, because this is the page about x2gomountdirs from the X2Go Server Tool family, and honestly? it's giving "let me share my folder with you, platonically, over SSH". 🫶

---

✨ NAME ✨

x2gomountdirs — Share Client-Side Folder with X2Go Session

like. it mounts your stuff. from your laptop. into your session. iconic behavior. 💖

---

🌸 SYNOPSIS 🌸

x2gomountdirs <mount_type> <session_id> <username> <key_file> <dir1>
[<dir2> [<dir3> [...]]]

see all those <angle bracket> things? yeah you gotta fill those in, they're not decorative. 😌

---

🦋 DESCRIPTION 🦋

x2gomountdirs mounts client-side folders or devices onto mountpoints that are accessible from within your remote X2Go session.

so basically: your local folder walks into the remote session like "hi, I live here now" and everyone just accepts it. no cap. 🔥

x2gomountdirs is run with X2Go user privileges and normally issued by an X2Go client application.

heads up: it's the client app that calls this, not usually you personally. you can, but it's very much a "the app does this for you" situation. iykyk. 🙈

---

🎀 ARGUMENTS 🎀

• <mount_type> — if this is set to ,,dir'' then the client-side mount target gets interpreted as a folder. if it's anything else, it gets interpreted as a device. that's it, that's the whole vibe check. ✨
• <session_id> — the unique identifier of the X2Go session that this command is run for. every session has its own lil name-tag, and this is it. 🏷️
• <username> — the owner of session <session_id> is given as the <username> argument. yes, the session has an owner. main character energy only. 👑
• <key_file> — location of a temporary private SSH key file (only valid for this command execution). so like, it exists for one moment, does its job, and dips. respect. 💀
• <dir1> [<dir2> [<dir3> [...]]] — a list of client-side folders or device mount points that shall be mounted for X2Go session <session_id>. you can bring one, or you can bring the whole friend group. the more the merrier fr fr. 🌈

---

🧚 PERMISSIONS 🧚

X2Go uses the fuse-based SSH filesystem (SSHFS) for sharing client-side file resources with X2Go sessions.

Users that shall use X2Go folder sharing must be members of the X2Go server's ,,fuse'' POSIX group.

bestie please listen: if you are not in that ,,fuse'' group, folder sharing is simply not happening. no amount of manifesting will fix it. add yourself to the group. periodt. 💅

---

⭐ RETURN VALUES ⭐

x2gomountdirs returns some mount point information to stdout if the mounting process has been successful. the mount results are printed line-by-line. the individual lines must be interpreted as shown below:

line 01: dirs:<local_path>__REVERSESSH_PORT__<sshfs_port>
line 02: ssh port:<sshfs_port>
line 03: Host:<client_ip>
line 04: User:<user>
line 05: inserted, sshfs  -o <options> \
            "<user">@<client_ip>:"<local_path>" \
            "<server_path>" -p <sshfs_port>
line 06: mount <local_path> ok
line 07: fname: <desktop_icon_name>

seven lines of pure output slay. read them carefully, they're literally telling you where everything landed. 🔍

If mounting of a client folder fails, either of the errors is returned (on stdout):

error 01: mounting of <local_path> failed
error 02: insertion of <local_path> failed (already mounted?), not
mounting

not the error 02!! "already mounted?" is the classic "girl you're already here" moment. 🫠

As exitcode x2gomoundirs always returns 0.

yes, always.</> even when it failed.</> even when it's screaming error 01 at you.</> the exit code is just out here living its best life at 0. so don't rely on it to tell you if things went well — read the stdout lines instead. 😭

---

🔥 SEE ALSO 🔥

• x2goumount-session(8) — for when you want to undo all of this. the breakup page. 💔

---

💜 AUTHOR 💜

This manual has been written by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project (https://www.x2go.org).

shoutout to Mike, absolute legend, wrote the docs so we didn't have to. 🫶

---

and that's the whole page bestie!! 🌟 this was Version 4.1.0.6, dated Aug 2023, and it lives in the X2Go Server Tool corner of the manual-verse. go forth and mount your folders responsibly. mwah. 💋✨🎀