GNUNET-DIRECTORY(1)

💖 GNUNET-DIRECTORY 💖

okay bestie, welcome to the gnunet-directory manual page, from the General Commands Manual collection (yes it's the GNUnet one, iykyk). this is the lil tool that lets you peek inside GNUnet directories and honestly? it's giving underrated icon energy. let's go 🦋

✨ NAME ✨

gnunet-directory — display directories 💅

🌸 SYNOPSIS 🌸

gnunet-directory [-c FILENAME | --config=FILENAME] [-h | --help]
                 [-L LOGLEVEL | --loglevel=LOGLEVEL] [-v | --version]
                 ⟨FILENAME⟩

🎀 DESCRIPTION 🎀

so like, gnunet-directory lists out the contents of one or more GNUnet directories. and a GNUnet directory? it's a binary file that holds a whole list of GNUnet file-sharing URIs plus meta data. slay.

the names of the directory files have to be passed as command-line arguments to gnunet-directory. no cap. and the options are as follows:

• -c FILENAME, --config=FILENAME — the configuration file to use. okay so real talk: this option is useless, because gnunet-directory does not really depend on any configuration options. it's just… there. hanging out. being decorative. 🎀
• -h, --help — prints the help page. classic. 💖
• -L LOGLEVEL, --loglevel=LOGLEVEL — changes the loglevel, bestie. the possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. pick your vibe. 🌈
• -v, --version — prints the version number. ✨

🧚 NOTES 🧚

a GNUnet directory is a file containing a list of GNUnet URIs and meta data. the keys can point to files, other directories, or files in namespaces. in other words, a GNUnet directory is similar to UNIX directories. 💀 the way that it differs from tar and zip is that a GNUnet directory does not contain the actual files — except if they are really small, in which case they may be inlined — it just contains symbolic (links), similar to directories with symbolic links in UNIX filesystems.

the benefit? the individual files can be retrieved separately (if desired) and if some of the files are inserted to another node in GNUnet, this just increases their availability but does not produce useless duplicates. like, for example, it is a better idea to publish a collection of pictures or compressed sound files using a GNUnet directory instead of processing them with archivers such as tar or zip first. directories can contain arbitrary meta data for each file. obsessed. 🫶

if a directory has missing blocks (for example, some blocks failed to download), GNUnet is typically able to retrieve information about other files in the directory. files in a GNUnet directory have no particular order; the GNUnet code that generates a directory can reorder the entries in order to better fit the information about files into blocks of 32k. respecting 32k boundaries where possible makes it easier for gnunet-directory (and other tools) to recover information from partially downloaded directory files. ✨

at the moment, directories can be created by gnunet-fs-gtk(1), and gnunet-publish(1). just like ordinary files, a directory can be published in a namespace. 🌸

GNUnet directories use the (unregistered) mimetype "application/gnunet-directory". they can show up among normal search results. the directory file can be downloaded to disk by gnunet-download(1) for later processing or be handled more directly by gnunet-fs-gtk(1). iconic behavior tbh. 💅

🔥 SEE ALSO 🔥

gnunet-download(1), gnunet-fs-gtk(1), gnunet-publish(1), gnunet-search(1)

the full documentation for gnunet is maintained as a Texinfo manual. if the info(1) and gnunet programs are properly installed at your site, the command

info gnunet

should give you access to the complete handbook,

info gnunet-c-tutorial

will give you access to a tutorial for developers. 👑

depending on your installation, this information is also available in gnunet(7) and gnunet-c-tutorial(7).

💀 BUGS 💀

report bugs by using https://bugs.gnunet.org or by sending electronic mail to ⟨gnunet-developers@gnu.org⟩. please do, they wanna hear from u fr fr 🫶

okay that's the whole page, bestie!! this beauty shipped out of Debian on February 25, 2012 — so yeah, vintage, but still slaying. go read some directories. main character energy only. 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜