[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r21792 - in gnunet-fuse: . doc
From: |
gnunet |
Subject: |
[GNUnet-SVN] r21792 - in gnunet-fuse: . doc |
Date: |
Wed, 6 Jun 2012 23:34:03 +0200 |
Author: grothoff
Date: 2012-06-06 23:34:03 +0200 (Wed, 06 Jun 2012)
New Revision: 21792
Added:
gnunet-fuse/doc/
gnunet-fuse/doc/Makefile.am
gnunet-fuse/doc/gnunet-fuse.1
Modified:
gnunet-fuse/Makefile.am
gnunet-fuse/configure.ac
Log:
adding a man page for gnunet-fuse
Modified: gnunet-fuse/Makefile.am
===================================================================
--- gnunet-fuse/Makefile.am 2012-06-06 21:15:27 UTC (rev 21791)
+++ gnunet-fuse/Makefile.am 2012-06-06 21:34:03 UTC (rev 21792)
@@ -1,6 +1,6 @@
## Process this file with automake to produce Makefile.in
-SUBDIRS = src po
+SUBDIRS = src doc po
EXTRA_DIST = config.rpath \
install-sh
Modified: gnunet-fuse/configure.ac
===================================================================
--- gnunet-fuse/configure.ac 2012-06-06 21:15:27 UTC (rev 21791)
+++ gnunet-fuse/configure.ac 2012-06-06 21:34:03 UTC (rev 21792)
@@ -183,6 +183,7 @@
AC_OUTPUT([ po/Makefile.in
Makefile
+doc/Makefile
src/Makefile
src/fuse/Makefile
])
Property changes on: gnunet-fuse/doc
___________________________________________________________________
Added: svn:ignore
+ Makefile.in
Makefile
Added: gnunet-fuse/doc/Makefile.am
===================================================================
--- gnunet-fuse/doc/Makefile.am (rev 0)
+++ gnunet-fuse/doc/Makefile.am 2012-06-06 21:34:03 UTC (rev 21792)
@@ -0,0 +1,5 @@
+man_MANS = \
+ gnunet-fuse.1
+
+EXTRA_DIST = ${man_MANS}
+
Added: gnunet-fuse/doc/gnunet-fuse.1
===================================================================
--- gnunet-fuse/doc/gnunet-fuse.1 (rev 0)
+++ gnunet-fuse/doc/gnunet-fuse.1 2012-06-06 21:34:03 UTC (rev 21792)
@@ -0,0 +1,43 @@
+.TH gnunet\-fuse "1" "6 Jun 2012" "GNUnet"
+.SH NAME
+gnunet\-fuse \- mount directories shared on gnunet
+
+.SH SYNOPSIS
+.B gnunet\-fuse
+[\fIOPTIONS\fR]
+.SH DESCRIPTION
+.PP
+
+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.
+
+.TP
+\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
+configuration file to use
+.TP
+\fB\-d \fPATH\fR, \fB\-\-directory=PATH\fR
+PATH specifies the mountpoint that gnunet\-fuse should use as the destination
for mounting the file system.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+print help page
+.TP
+\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR
+Change the loglevel. Possible values for LOGLEVEL are ERROR, WARNING, INFO
and DEBUG.
+.TP
+\fB\-s \fIURI\fR, \fB\-\-source=URI\fR
+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.
+.TP
+\fB\-t\fR, \fB\-\-single-threaded\fR
+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.
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+print the version number
+
+.SH 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.
+
+.SH "REPORTING BUGS"
+Report bugs by using mantis <https://gnunet.org/bugs/> or by sending
electronic mail to <address@hidden>
+.SH "SEE ALSO"
+\fBgnunet\-publish\fP(1), \fBgnunet\-fs\-gtk\fP(1)
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r21792 - in gnunet-fuse: . doc,
gnunet <=