NAME

       gnunet-fuse - mount directories shared on gnunet

SYNOPSIS

       gnunet-fuse [OPTIONS]

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.

       -c FILENAME, --config=FILENAME
              configuration file to use

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

       -h, --help
              print 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

NOTES

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

REPORTING BUGS

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

SEE ALSO

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