aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/man/Makefile.am1
-rw-r--r--doc/man/gnunet-download.14
-rw-r--r--doc/man/gnunet-publish.17
-rw-r--r--doc/man/gnunet-search.12
-rw-r--r--doc/man/gnunet-transport.196
-rw-r--r--doc/man/gnunet-unindex.12
6 files changed, 4 insertions, 108 deletions
diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am
index 20575204f..dcc60e6fb 100644
--- a/doc/man/Makefile.am
+++ b/doc/man/Makefile.am
@@ -8,7 +8,6 @@ man_MANS = \
8 gnunet-publish.1 \ 8 gnunet-publish.1 \
9 gnunet-search.1 \ 9 gnunet-search.1 \
10 gnunet-statistics.1 \ 10 gnunet-statistics.1 \
11 gnunet-transport.1 \
12 gnunet-unindex.1 \ 11 gnunet-unindex.1 \
13 gnunet-monkey.1 12 gnunet-monkey.1
14 13
diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1
index 2da931554..5c5eb64a9 100644
--- a/doc/man/gnunet-download.1
+++ b/doc/man/gnunet-download.1
@@ -25,10 +25,6 @@ causes gnunet\-download to delete incomplete downloads when aborted with CTRL\-C
25print help page 25print help page
26 26
27.TP 27.TP
28\fB\-H \fIHOSTNAME\fR, \fB\-\-host=\fIHOSTNAME\fR
29on which host is gnunetd running (default: localhost). You can also specify a port using the syntax HOSTNAME:PORT. The default port is 2087.
30
31.TP
32\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR 28\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR
33Change the loglevel. Possible values for LOGLEVEL are 29Change the loglevel. Possible values for LOGLEVEL are
34ERROR, WARNING, INFO and DEBUG. 30ERROR, WARNING, INFO and DEBUG.
diff --git a/doc/man/gnunet-publish.1 b/doc/man/gnunet-publish.1
index 904a7947c..402fef2d0 100644
--- a/doc/man/gnunet-publish.1
+++ b/doc/man/gnunet-publish.1
@@ -24,7 +24,7 @@ It is possible to update content in GNUnet if that content was placed and obtain
24.PP 24.PP
25You can use automatic meta\-data extraction (based on libextractor) or the command\-line option \-m to specify meta-data. For the \-m option you need to use the form keyword\-type:value. For example, use "\-m os:Linux" to specify that the operating system is Linux. Common meta\-data types are "author", "title" , "mimetype", "filename", "language", "subject" and "keywords". A full list can be obtained from the extract tool using the option \-\-list. The meta\-data is used to help users in searching for files on the network. The keywords are case\-sensitive. 25You can use automatic meta\-data extraction (based on libextractor) or the command\-line option \-m to specify meta-data. For the \-m option you need to use the form keyword\-type:value. For example, use "\-m os:Linux" to specify that the operating system is Linux. Common meta\-data types are "author", "title" , "mimetype", "filename", "language", "subject" and "keywords". A full list can be obtained from the extract tool using the option \-\-list. The meta\-data is used to help users in searching for files on the network. The keywords are case\-sensitive.
26.PP 26.PP
27GNUnet supports two styles of publishing files on the network. Publishing a file means that a copy of the file is made in the local (!) database of the node. Indexing a file means that an index is added to the local (!) database with symbolic links to the file itself. The links will use the SHA-512 hash of the entire file as the filename. Indexing is generally significantly more efficient and the default choice. However, indexing only works if the indexed file can be read (using the same absolute path) by gnunetd. If this is not the case, indexing will fail (and gnunet\-publish will automatically revert to publishing instead). Regardless of which method is used to publish the file, the file will be slowly (depending on how often it is requested and on how much bandwidth is available) dispersed into the network. If you publish or index a file and then leave the network, it will almost always NOT be available anymore. 27GNUnet supports two styles of publishing files on the network. Publishing a file means that a copy of the file is made in the local (!) database of the node. Indexing a file means that an index is added to the local (!) database with symbolic links to the file itself. The links will use the SHA-512 hash of the entire file as the filename. Indexing is generally significantly more efficient and the default choice. However, indexing only works if the indexed file can be read (using the same absolute path) by gnunet-service-fs. If this is not the case, indexing will fail (and gnunet\-publish will automatically revert to publishing instead). Regardless of which method is used to publish the file, the file will be slowly (depending on how often it is requested and on how much bandwidth is available) dispersed into the network. If you publish or index a file and then leave the network, it will almost always NOT be available anymore.
28 28
29\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR 29\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
30Use alternate config file (if this option is not specified, the default is ~/.gnunet/gnunet.conf). 30Use alternate config file (if this option is not specified, the default is ~/.gnunet/gnunet.conf).
@@ -42,9 +42,6 @@ Print the list of keywords that will be used for each file given the current opt
42Print a brief help page with all the options. 42Print a brief help page with all the options.
43 43
44.TP 44.TP
45\fB\-H \fIHOSTNAME\fR, \fB\-\-host=\fIHOSTNAME\fR
46on which host is gnunetd running (default: localhost). You can also specify a port using the syntax HOSTNAME:PORT. The default port is 2087.
47.TP
48\fB\-k \fIKEYWORD\fR, \fB\-\-key=KEYWORD\fR 45\fB\-k \fIKEYWORD\fR, \fB\-\-key=KEYWORD\fR
49additional key to index the content with (to add multiple keys, specify multiple times). Each additional key is case\-sensitive. Can be specified multiple times. The keyword is only applied to the top\-level file or directory. 46additional key to index the content with (to add multiple keys, specify multiple times). Each additional key is case\-sensitive. Can be specified multiple times. The keyword is only applied to the top\-level file or directory.
50 47
@@ -165,4 +162,4 @@ GNUnet configuration file
165.SH "REPORTING BUGS" 162.SH "REPORTING BUGS"
166Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 163Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
167.SH "SEE ALSO" 164.SH "SEE ALSO"
168\fBgnunet\-auto\-share\fP(1), \fBgnunet\-gtk\fP(1), \fBgnunet\-pseudonym\fP(1), \fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1), \fBgnunet.conf\fP(5), \fBgnunetd\fP(1), \fBextract\fP(1) 165\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-pseudonym\fP(1), \fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1), \fBgnunet.conf\fP(5), \fBextract\fP(1)
diff --git a/doc/man/gnunet-search.1 b/doc/man/gnunet-search.1
index ce985be5c..9fb8bc123 100644
--- a/doc/man/gnunet-search.1
+++ b/doc/man/gnunet-search.1
@@ -89,4 +89,4 @@ GNUnet configuration file; specifies the default value for the timeout
89.SH "REPORTING BUGS" 89.SH "REPORTING BUGS"
90Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 90Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
91.SH "SEE ALSO" 91.SH "SEE ALSO"
92\fBgnunet\-gtk\fP(1), \fBgnunet\-publish\fP(1), \fBgnunet\-download\fP(1), \fBgnunet\-pseudonym\fP(1), \fBgnunet.conf\fP(5), \fBgnunetd\fP(1) 92\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1), \fBgnunet\-download\fP(1), \fBgnunet\-pseudonym\fP(1), \fBgnunet.conf\fP(5),
diff --git a/doc/man/gnunet-transport.1 b/doc/man/gnunet-transport.1
deleted file mode 100644
index 643759395..000000000
--- a/doc/man/gnunet-transport.1
+++ /dev/null
@@ -1,96 +0,0 @@
1.TH GNUNET-TRANSPORT "1" "23 Dec 2006" "GNUnet"
2.SH NAME
3gnunet\-transport \- a tool to test a GNUnet transport service
4.SH SYNOPSIS
5.B gnunet\-transport\
6[\fIOPTIONS\fR]
7.SH DESCRIPTION
8.PP
9gnunet\-transport can be used to test or profile
10a GNUnet transport service. The tool can be used to test
11both the correctness of the software as well as the correctness
12of the configuration. gnunet\-transport features two modes,
13called loopback mode and ping mode. In loopback mode the test is limited to testing if the
14transport can be used to communicate with itself (loopback).
15This mode does not include communication with other peers which
16may be blocked by firewalls and other general Internet connectivity
17problems. The loopback mode is particularly useful to test
18the SMTP transport service since this service is fairly hard to
19configure correctly and most problems can be reveiled by just
20testing the loopback. In ping mode the tool will attempt to download
21peer advertisements from the URL specified in the configuration file
22and then try to contact each of the peers. Note that it is perfectly
23normal that some peers do not respond, but if no peer responds something
24is likely to be wrong. The configuration is always taken
25from the configuration file. Do not run gnunetd while running
26gnunet\-transport since the transport services cannot
27be used by two processes at the same time.
28.PP
29gnunet\-transport will always produce an error\-message for
30the NAT transport in loopback mode. If NAT is configured in accept\-mode (as in,
31accept connections from peers using network address translation),
32the check will fail with the message "could not create HELO",
33which is correct since the peer itself is clearly not going to
34advertise itself as a NAT. If the peer is configured in NAT\-mode,
35that is, the peer is behind a NAT box, the message will be
36'could not connect'. For NAT, both messages are NOT errors
37but exactly what is supposed to happen.
38.PP
39Similarly, a NAT\-ed peer should typically configure the TCP transport
40to use port 0 (not listen on any port). In this case,
41gnunet\-transport will print 'could not create HELO' for the
42TCP transport. This is also ok. In fact, a correctly configured
43peer using NAT should give just two errors (could not connect for
44tcp and could not create HELO for NAT) when tested using
45gnunet\-transport\. The reason is, that gnunet\-transport\
46only tests loopback connectivity, and for a NAT\-ed peer, that just
47does not apply.
48.PP
49Note that in ping mode the HTTP download times out after 5 minutes,
50so if the list of peers is very large and not all peers can be
51queried within the 5 minutes the tool may abort before trying all
52peers.
53.TP
54\fB\-c \fIFILENAME\fR, \fB\-\-config=\fIFILENAME\fR
55use config file (default: /etc/gnunetd.conf)
56.TP
57\fB\-h\fR, \fB\-\-help\fR
58print help page
59.TP
60\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=\fILOGLEVEL\fR
61change the loglevel. Possible values for \fILOGLEVEL\fR are NOTHING, FATAL, ERROR, FAILURE, WARNING, MESSAGE, INFO, DEBUG, CRON and EVERYTHING.
62.TP
63\fB\-p\fR, \fB\-\-ping\fR
64use ping mode (loopback mode is default)
65.TP
66\fB\-r\fI COUNT \fB\-\-repeat=\fICOUNT\fR
67send COUNT messages in a sequence over the same connection
68.TP
69\fB\-s\fI SIZE \fB\-\-size=\fISIZE\fR
70test using the specified message size, default is 11
71.TP
72\fB\-t\fI TRANSPORT\fR, \fB\-\-transport=\fITRANSPORT\fR
73run using the specified transport, if not given the transports
74configured in the configuration file are used.
75.TP
76\fB\-u \fIUSER\fR, \fB\-\-user=USER\fR
77run as user USER (and if available as group USER). Note that to use this option, you will probably have to start gnunet-transport as
78root. It is typically better to directly start gnunet-transport as that user instead.
79.TP
80\fB\-v\fR, \fB\-\-version\fR
81print the version number
82.TP
83\fB\-V\fR, \fB\-\-verbose\fR
84be verbose
85.SH NOTES
86gnunet\-transport can run for a long time, depending on
87how high you have set the \fICOUNT\fR level. Run first with small numbers
88for \fICOUNT\fR to get an initial estimate on the runtime.
89.SH FILES
90.TP
91/etc/gnunetd.conf
92default gnunetd configuration file
93.SH "REPORTING BUGS"
94Report bugs by using mantis <https://gnunet.org/mantis/> or by sending electronic mail to <gnunet-developers@gnu.org>
95.SH "SEE ALSO"
96\fBgnunetd.conf\fP(5), \fBgnunetd\fP(1)
diff --git a/doc/man/gnunet-unindex.1 b/doc/man/gnunet-unindex.1
index be478eace..9cbb7aa57 100644
--- a/doc/man/gnunet-unindex.1
+++ b/doc/man/gnunet-unindex.1
@@ -34,4 +34,4 @@ GNUnet configuration file
34.SH "REPORTING BUGS" 34.SH "REPORTING BUGS"
35Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 35Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
36.SH "SEE ALSO" 36.SH "SEE ALSO"
37\fBgnunet\-gtk\fP(1), \fBgnunet\-publish\fP(1), \fBgnunet\-gtk\fP(1), \fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1), \fBgnunet.conf\fP(5), \fBgnunetd\fP(1) 37\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1), \fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1), \fBgnunet.conf\fP(5)