NAME¶
gnunet-directory - display directories
SYNOPSIS¶
gnunet-directory [
OPTIONS] (FILENAME)*
DESCRIPTION¶
gnunet-directory lists the contents of one or more GNUnet directories. A GNUnet
directory is a binary file that contains a list of GNUnet file-sharing URIs
and meta data. The names of the directory files must be passed as command-line
arguments to gnunet-directory.
- -c FILENAME, --config=FILENAME
- configuration file to use (useless option since
gnunet-directory does not really depend on any configuration options)
- -h, --help
- print help page
- -L LOGLEVEL, --loglevel=LOGLEVEL
- Change the loglevel. Possible values for LOGLEVEL are
ERROR, WARNING, INFO and DEBUG.
- -v, --version
- print 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 difference to
tar and zip is that GNUnet directory does not contain the actual files (except
if they are really small, in which case they may be inlined), 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.
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 and
gnunet-publish. 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).
REPORTING BUGS¶
Report bugs by using mantis <
https://gnunet.org/bugs/> or by sending
electronic mail to <gnunet-developers@gnu.org>
SEE ALSO¶
gnunet-fs-gtk(1),
gnunet-publish(1),
gnunet-search(1),
gnunet-download(1)