GOCRYPTFS-XRAY(1)

💅 NAME 💅

okay bestie, welcome to the GOCRYPTFS-XRAY(1) manual page — this is all about gocryptfs-xray, the icon whose whole job is to examine gocryptfs-related data. 🕵️‍♀️✨ no cap.

🌸 SYNOPSIS 🌸

okay so there are three main-character ways to run this thing, and they are literally:

🔍 Examine encrypted file/directory

gocryptfs-xray CIPHERDIR/ENCRYPTED-FILE-OR-DIR

🔑 Decrypt and show master key

gocryptfs-xray -dumpmasterkey CIPHERDIR/gocryptfs.conf

🔒 Encrypt paths

gocryptfs-xray -encrypt-paths SOCKET

✨ DESCRIPTION ✨

Available options are listed below — yes, all of them, bestie, no skipping. 💖

• -0 — use \0 instead of \n as the separator for -decrypt-paths and -encrypt-paths. separator slay. 🎀
• -aessiv — assume AES-SIV mode instead of AES-GCM when examining an encrypted file. This is not needed and has no effect in -dumpmasterkey mode. iykyk 🦋
• -decrypt-paths — decrypt file paths using the gocryptfs control socket. Reads from stdin. See -ctlsock in gocryptfs(1). 🫶
• -dumpmasterkey — decrypts and shows the master key. 🔑
• -encrypt-paths — encrypt file paths using the gocryptfs control socket. Reads from stdin. See -ctlsock in gocryptfs(1). 🔥

🎀 EXAMPLES 🎀

okay these examples are genuinely useful, bestie:

Examine an encrypted file:

gocryptfs-xray myfs/mCXnISiv7nEmyc0glGuhTQ

Print the master key:

gocryptfs-xray -dumpmasterkey myfs/gocryptfs.conf

Mount gocryptfs with control socket and use gocryptfs-xray to encrypt some paths:

gocryptfs -ctlsock myfs.sock myfs myfs.mnt
echo -e "foo\nbar" | gocryptfs-xray -encrypt-paths myfs.sock

👀 SEE ALSO 👀

go give some love to gocryptfs(1) and fuse(8) — they're right there in the friend group. 💜

🫶 AUTHORS 🫶

github.com/rfjakob. — yes, with the dot, bestie. periodt. 🌟

---

that's the whole page, bestie! cute little sign-off from the Jan 2018 edition of GOCRYPTFS-XRAY(1) — mwah 💋💖✨