diff options
author | ng0 <ng0@n0.is> | 2019-04-08 20:35:48 +0000 |
---|---|---|
committer | ng0 <ng0@n0.is> | 2019-04-08 20:35:48 +0000 |
commit | 346b1fc78569d860e6e832b43ef1e3f0a40c074b (patch) | |
tree | 7d388d03cfc75f8aa6508bb6398b6d27ed4447ad | |
parent | fc40c72a9d125f2222b9420f0c061c4a41babf92 (diff) | |
download | gnunet-fuse-346b1fc78569d860e6e832b43ef1e3f0a40c074b.tar.gz gnunet-fuse-346b1fc78569d860e6e832b43ef1e3f0a40c074b.zip |
refactor manpage
-rw-r--r-- | doc/gnunet-fuse.1 | 106 |
1 files changed, 63 insertions, 43 deletions
diff --git a/doc/gnunet-fuse.1 b/doc/gnunet-fuse.1 index 5c4fb24..2564b9a 100644 --- a/doc/gnunet-fuse.1 +++ b/doc/gnunet-fuse.1 | |||
@@ -1,43 +1,63 @@ | |||
1 | .TH gnunet\-fuse "1" "6 Jun 2012" "GNUnet" | 1 | .Dd June 6, 2012 |
2 | .SH NAME | 2 | .Dt GNUNET-FUSE 1 |
3 | gnunet\-fuse \- mount directories shared on gnunet | 3 | .Os |
4 | 4 | .Sh NAME | |
5 | .SH SYNOPSIS | 5 | .Nm gnunet-fuse |
6 | .B gnunet\-fuse | 6 | .Nd |
7 | [\fIOPTIONS\fR] | 7 | mount directories shared on gnunet |
8 | .SH DESCRIPTION | 8 | .Sh SYNOPSIS |
9 | .PP | 9 | .Nm |
10 | 10 | .Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME | |
11 | 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. | 11 | .Op Fl d Ar PATH | Fl \-directory= Ns Ar PATH |
12 | 12 | .Op Fl h | \-help | |
13 | 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. | 13 | .Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL |
14 | 14 | .Op Fl s Ar URI | Fl \-source= Ns Ar URI | |
15 | .TP | 15 | .Op Fl t | \-single-threaded |
16 | \fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR | 16 | .Op Fl v | \-version |
17 | configuration file to use | 17 | .Sh DESCRIPTION |
18 | .TP | 18 | .Nm |
19 | \fB\-d \fIPATH\fR, \fB\-\-directory=PATH\fR | 19 | is a tool to mount directories that have been published via GNUnet's file-sharing applications. |
20 | PATH specifies the mountpoint that gnunet\-fuse should use as the destination for mounting the file system. | 20 | 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. |
21 | .TP | 21 | In contrast to downloading the directory recursively via gnunet-download, this has the advantage that files are downloaded on-demand. |
22 | \fB\-h\fR, \fB\-\-help\fR | 22 | Only those files (or directories) that you access will be downloaded. |
23 | print help page | 23 | Furthermore, in the case of larger files, only those blocks that an application actually reads will be downloaded. |
24 | .TP | 24 | 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. |
25 | \fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR | 25 | .Pp |
26 | Change the loglevel. Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. | 26 | gnunet-fuse will store all downloaded files in a temporary directory on disk. |
27 | .TP | 27 | This cache will be purged when gnunet-fuse exits normally (which happens when the file-system is unmounted). |
28 | \fB\-s \fIURI\fR, \fB\-\-source=URI\fR | 28 | As mounting a file system is a priviledged operation, gnunet-fuse must be run by root. |
29 | 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. | 29 | 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. |
30 | .TP | 30 | This can be solved either by adding root to the 'gnunet' group, or by disabling the access control options for gnunet-service\-fs. |
31 | \fB\-t\fR, \fB\-\-single-threaded\fR | 31 | .Pp |
32 | 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. | 32 | gnunet-fuse currently only supports read-only operations on the file system. |
33 | .TP | 33 | All files will be owned by root and will be world-readable. |
34 | \fB\-v\fR, \fB\-\-version\fR | 34 | .Bl -tag -width Ds |
35 | print the version number | 35 | .It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME |
36 | 36 | Configuration file to use. | |
37 | .SH NOTES | 37 | .It Fl d Ar PATH | Fl \-directory= Ns Ar PATH |
38 | gnunet\-fuse currently only supports read\-only operations on the file system. All files will be owned by root and will be world-readable. | 38 | PATH specifies the mountpoint that gnunet-fuse should use as the destination for mounting the file system. |
39 | 39 | .It Fl h | \-help | |
40 | .SH "REPORTING BUGS" | 40 | Print the help page |
41 | Report bugs by using mantis <https://bugs.gnunet.org/> or by sending electronic mail to <gnunet\-developers@gnu.org> | 41 | .It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL |
42 | .SH "SEE ALSO" | 42 | Change the loglevel. |
43 | \fBgnunet\-publish\fP(1), \fBgnunet\-fs\-gtk\fP(1) | 43 | Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG. |
44 | .It Fl s Ar URI | Fl \-source= Ns Ar URI | ||
45 | URI is the file-sharing URI of the directory that is to be mounted. | ||
46 | It must be either of type CHK or of type LOC. | ||
47 | .It Fl t | \-single-threaded | ||
48 | In this mode, gnunet-fuse will run in "debug" mode and disable FUSE concurrency (and add some additional logging). | ||
49 | Normally, gnunet-fuse will download multiple files in parallel if multiple IO requests are queued with the file system at the same time. | ||
50 | In debug mode, all requests are processed sequentially. | ||
51 | Note that gnunet-fuse will still fork a helper process to perform the actual interaction with the GNUnet file-sharing service. | ||
52 | .It Fl v | \-version | ||
53 | Print the version number. | ||
54 | .El | ||
55 | .\".Sh EXAMPLES | ||
56 | .Sh SEE ALSO | ||
57 | .Xr gnunet-publish 1 , | ||
58 | .Xr gnunet-fs-gtk 1 | ||
59 | .Sh BUGS | ||
60 | Report bugs by using | ||
61 | .Lk https://bugs.gnunet.org | ||
62 | or by sending electronic mail to | ||
63 | .Aq Mt gnunet-developers@gnu.org . | ||