gnunet-directory - display directories and show or delete lists of encountered file identifiers

gnunet-directory [OPTIONS] FILENAMES

gnunet-directory lists the contents of a GNUnet directory. It also can be used to manipulate the file identifier database which is used by GNUnet for building directories.

gnunet-directory will always list the contents of the GNUnet directories that are passed as filenames.

Manipulating the file identifier database is done by passing additional options to gnunet-directory. Note that by default GNUnet does not build the file identifier database and the database will thus always be empty. You need to run gnunet-directory with the -t option to enable tracking of file identifiers. The reason is that storing file identifiers in plaintext in the database can compromise your privacy if your machine should fall under the control of an adversary.

-h, --help

print help page

-k, --kill

delete all entries from the file identifier database and stop tracking file identifiers

-l, --list

display entries from the file identifier database

-L LOGLEVEL, --loglevel=LOGLEVEL

change the loglevel. Possible values for LOGLEVEL are NOTHING, FATAL, ERROR, FAILURE, WARNING, MESSAGE, INFO, DEBUG, CRON and EVERYTHING.

-t, --track

start tracking file identifiers

The options are evaluated in the order -l, -k and then -t. Thus specifying -klt will first list all identifiers that were in the database previously, then delete all of those identifiers from the database and then continue (or start to) collect identifiers. The order in which the options are specified on the command line is not important.

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 difference to tar and zip is that GNUnet directory does not contain the actual files, just symbolic (links), similar to directories with symbolic links in UNIX filesystems. The benefit is that 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 (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.

At the moment, directories can be created by gnunet-gtk and gnunet-insert. They can point to content created by the user or content inserted by others. 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-gtk(1).

Report bugs by using mantis <https://gnunet.org/mantis/> or by sending electronic mail to <gnunet-developers@gnu.org>

gnunet-gtk(1), gnunet-insert(1), gnunet-search(1), gnunet-download(1), gnunetd(1)