NAME

       gnunet-directory — display directories

SYNOPSIS

       gnunet-directory  [-c  FILENAME  |  --config=FILENAME]  [-h | --help] [-L LOGLEVEL | --loglevel=LOGLEVEL]
                        [-v | --version] ⟨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.  The options are as follows:

       -c FILENAME | --config=FILENAME
               Configuration file to use.  This option is useless, since gnunet-directory does not really depend
               on any configuration options.

       -h | --help
               Print the 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(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).

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⟩.

Debian                                          February 25, 2012                            GNUNET-DIRECTORY(1)