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]

DESCRIPTION

       gnunet-fuse  is  a  tool  to  mount  directories  that  have  been  published  via  GNUnet's file-sharing
       applications.  With gnunet-fuse, directories that have been published on GNUnet can be mounted  as  read-
       only  file  systems  and  the  accessed  using  normal  file  operations.  In contrast to downloading the
       directory recursively via gnunet-download, this has the advantage that files  are  downloaded  on-demand.
       Only those files (or directories) that you access will be downloaded.  Furthermore, in the case of larger
       files, only those blocks that an application actually reads will be downloaded.  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.

       gnunet-fuse  will store all downloaded files in a temporary directory on disk.  This cache will be purged
       when gnunet-fuse exits normally (which happens when the file-system is unmounted).  As  mounting  a  file
       system  is  a  priviledged  operation,  gnunet-fuse  must be run by root.  If root is not in the 'gnunet'
       group, access to the shared directory will likely fail as the gnunet-service-fs will likely refuse access
       to root.  This can be solved either by adding root to the 'gnunet' group,  or  by  disabling  the  access
       control options for gnunet-service-fs.

       gnunet-fuse  currently only supports read-only operations on the file system.  All files will be owned by
       root and will be world-readable.

       -c FILENAME | --config=FILENAME
               Configuration file to use.

       -d PATH | --directory=PATH
               PATH specifies the mountpoint that gnunet-fuse should use as the  destination  for  mounting  the
               file system.

       -h | --help
               Print the help page

       -L LOGLEVEL | --loglevel=LOGLEVEL
               Change the loglevel.  Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.

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

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

       -v | --version
               Print the version number.

SEE ALSO

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

BUGS

       Report   bugs   by    using    https://bugs.gnunet.org    or    by    sending    electronic    mail    to
       ⟨gnunet-developers@gnu.org⟩.

Debian                                            June 6, 2012                                    GNUNET-FUSE(1)