GNUNET-FUSE(1)

💖 GNUNET-FUSE — the manual page, bestie edition 💖

okay so you found gnunet-fuse(1), the General Commands Manual page, and honestly? it's giving "mount the internet but make it peer-to-peer" and I am obsessed. sit down, grab a strawberry 🍓, and let's go.

✨ NAME ✨

gnunet-fuse — mount directories shared on gnunet 🦋

✨ SYNOPSIS ✨

gnunet-fuse [-c FILENAME | --config=FILENAME]
            [-d PATH | --directory=PATH] [-h | --help]
            [-L LOGLEVEL | --loglevel=LOGLEVEL] [-s URI | --source=URI]
            [-t | --single-threaded] [-v | --version]

like... that's the whole summoning circle. periodt. 💅

✨ DESCRIPTION ✨

gnunet-fuse is the tool that mounts directories which have been published via GNUnet's file-sharing applications. the way that it works is: directories published on GNUnet get mounted as read-only file systems, and then you just... use them?? with normal file operations?? like a normal person?? iconic behaviour honestly.

and here's why that slaps compared to downloading the whole directory recursively via gnunet-download: with gnunet-fuse, files are downloaded on-demand. only the files (or directories) that you actually access get downloaded. no cap. and for larger files? only the blocks that an application actually reads get downloaded. your bandwidth is safe, your storage is safe, you're thriving. 🌸

⚠️ but bestie, listen. naturally, operations on the file system will block until the download has succeeded — which can theoretically mean that they never terminate and must be aborted. yeah. 😭 that's the tradeoff. noted.

gnunet-fuse will store all downloaded files in a temporary directory on disk. this cache gets purged when gnunet-fuse exits normally (which happens when the file-system is unmounted). so clean. so tidy. 🧚

and now the annoying part: mounting a file system is a privileged operation, so gnunet-fuse must be run by root. 🙈 and if root is not in the 'gnunet' group, access to the shared directory will likely fail, because the gnunet-service-fs will likely refuse access to root. rude, I know. you can fix this either by adding root to the 'gnunet' group, or by disabling the access control options for gnunet-service-fs. two options, pick your fighter. 👑

also gnunet-fuse currently only supports read-only operations on the file system. all files will be owned by root and will be world-readable. that's it, that's the whole vibe.

✨ OPTIONS ✨

• -c FILENAME, --config=FILENAME — the configuration file to use. ur settings, ur rules. 📝
• -d PATH, --directory=PATH — PATH is the mountpoint that gnunet-fuse should use as the destination for mounting the file system. like, where the magic happens. 📍
• -h, --help — print the help page. we love a helpful king. 🫶
• -L LOGLEVEL, --loglevel=LOGLEVEL — change the loglevel. possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. choose ur own adventure. 🔍
• -s URI, --source=URI — URI is the file-sharing URI of the directory that is to be mounted. it must be either of type CHK or of type LOC. no other types, don't even try it. 🚫
• -t, --single-threaded — in this mode, gnunet-fuse will run in "debug" mode and disable FUSE concurrency (and add some additional logging). normally, gnunet-fuse will download multiple files in parallel if multiple IO requests are queued with the file system at the same time. in debug mode, all requests are processed sequentially. note that gnunet-fuse will still fork a helper process to perform the actual interaction with the GNUnet file-sharing service. so like, single-threaded but not fully single-threaded, iykyk. 💀
• -v, --version — print the version number. flex the build. ⭐

✨ SEE ALSO ✨

• gnunet-publish(1)
• gnunet-fs-gtk(1)

go read those too, bestie, the lore is deep. 🌈

✨ BUGS ✨

found a bug? report it by using https://bugs.gnunet.org or by sending electronic mail to ⟨gnunet-developers@gnu.org⟩. they're nice, I promise. and like, constructive feedback is main character energy. 💜

okay and finally — this whole page is a Debian situation, dated June 6, 2012, and it lives in section GNUNET-FUSE(1) of the manual. that's the sign-off bestie, go mount something. 💖✨🎀🦋🌸💅