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)