GS-MOUNT(1)

💅 GS-MOUNT(1) — the secure filesystem client, but make it a group chat

okay so bestie, welcome to the General Commands Manual page for gs-mount, and I'm gonna hold your hand through every single line of it, no cap. 💖

---

✨ NAME ✨

gs-mount — secure filesystem client through via Global Socket.

(yes, "through via", that's the actual wording, I'm not touching it, it's iconic 💀)

---

🌸 SYNOPSIS 🌸

gs-mount [-lTR] [-s secret] [-k keyfile] [mountpoint]

look at that little synopsis, it's giving minimal, it's giving effortless 🫶

---

🦋 DESCRIPTION 🦋

so the tea is: gs-mount is a wrapper script for gs-netcat. that's the whole vibe. it lets a user mount and access a filesystem from another user via the Global Socket Relay Network (GSRN). 🌐

and when is that useful? literally when both of y'all are behind NAT/Firewall and physically cannot connect to each other directly. like, the direct line is blocked, so the GSRN plays matchmaker. no cap, it's the bestie that introduces you two. 🎀

---

👑 OPTIONS 👑

here's the whole menu, every single one, I'm not skipping a thing:

• -s secret — a password chosen by the user. both users need to use the same password to connect. so like, pick one and both of you commit, okay? 🤝
• -k FILE — a file containing the password. for when you'd rather keep it in a file than type it out. 💌
• -l — server mode. the default mode is client. so if you're the one sharing, you need this flag, periodt.
• -R — places server (-l) into a read-only mode. attempts to open files for writing, as well as other operations that change the state of the filesystem, will be denied. 🚫 so like, look but don't touch energy.
• -T — use TOR. gs-mount will connect via TOR to the GSRN. this requires TOR to be installed and running. the IP and PORT of the TOR server can be set using environment variables. 🧅✨

see gs-netcat(1) for more options. there's more where that came from, iykyk.

---

💜 EXAMPLES 💜

Example 1 — Alice sharing her current directory:

$ gs-mount -s MySecret -l

Bob mounting Alice's directory to ~/gs-alice:

$ gs-mount -s MySecret ~/gs-alice

see how they both used MySecret? that's the whole "same password" thing in action. slay. 🔥

---

🌈 ENVIRONMENT 🌈

see gs-netcat(1) for a list of supported environment variables. 📋

---

⭐ SEE ALSO ⭐

gsocket(1), gs-netcat(1), gs-sftp(1), blitz(1), sshfs(1)

go read those too, they're the extended universe. 🍓

---

💀 BUGS 💀

efforts have been made to have gs-mount "do the right thing" in all its various modes. if you believe that it is doing the wrong thing under whatever circumstances, please notify me (skyper@thc.org) and tell me how you think it should behave. 🙈

like, genuinely, tell them. they want to know. constructive vibes only, bestie. 💖

---

this page is from the Debian manual set, dated October 12, 2020, and it's the GS-MOUNT(1) page. 🎀 mwah, go mount something safely, love u, bye! 🦋✨