aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/man/gnunet-ats.117
-rw-r--r--doc/man/gnunet-auto-share.152
-rw-r--r--doc/man/gnunet-bcd.113
-rw-r--r--doc/man/gnunet-cadet.16
-rw-r--r--doc/man/gnunet-config.16
-rw-r--r--doc/man/gnunet-conversation-test.138
-rw-r--r--doc/man/gnunet-conversation.134
-rw-r--r--doc/man/gnunet-core.18
-rw-r--r--doc/man/gnunet-datastore.126
-rw-r--r--doc/man/gnunet-directory.110
-rw-r--r--doc/man/gnunet-dns2gns.13
-rw-r--r--doc/man/gnunet-download-manager.169
-rw-r--r--doc/man/gnunet-download.111
-rw-r--r--doc/man/gnunet-ecc.16
-rw-r--r--doc/man/gnunet-fs.137
-rw-r--r--doc/man/gnunet-gns-proxy.14
-rw-r--r--doc/man/gnunet-gns.139
-rw-r--r--doc/man/gnunet-identity.178
-rw-r--r--doc/man/gnunet-namecache.17
-rw-r--r--doc/man/gnunet-namestore-fcfsd.13
-rw-r--r--doc/man/gnunet-namestore.17
-rw-r--r--doc/man/gnunet-nat-auto.14
-rw-r--r--doc/man/gnunet-nat-server.14
-rw-r--r--doc/man/gnunet-nat.189
-rw-r--r--doc/man/gnunet-peerinfo.14
-rw-r--r--doc/man/gnunet-publish.1507
-rw-r--r--doc/man/gnunet-qr.112
-rw-r--r--doc/man/gnunet-revocation.12
-rw-r--r--doc/man/gnunet-search.18
-rw-r--r--doc/man/gnunet-testbed-profiler.17
-rw-r--r--doc/man/gnunet-testing.118
-rw-r--r--doc/man/gnunet-transport.19
-rw-r--r--doc/man/gnunet-unindex.13
-rw-r--r--doc/man/gnunet-vpn.170
-rw-r--r--doc/man/gnunet-zoneimport.14
-rw-r--r--doc/man/gnunet.conf.59
36 files changed, 596 insertions, 628 deletions
diff --git a/doc/man/gnunet-ats.1 b/doc/man/gnunet-ats.1
index 5f933d621..895c71942 100644
--- a/doc/man/gnunet-ats.1
+++ b/doc/man/gnunet-ats.1
@@ -1,18 +1,14 @@
1.TH GNUNET\-ATS 1 "Oct 16, 2015" "GNUnet" 1.TH GNUNET\-ATS 1 "October 16, 2015" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-ats \- display information about transport resource allocation 3gnunet\-ats \- display information about transport resource allocation
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-ats 5.B gnunet\-ats
8.RI [ options ] 6.RI [ options ]
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-ats\fP can be used to display information about the GNUnet's 9\fBgnunet\-ats\fP can be used to display information about the GNUnet's
13transport selection mechanism. It shows information about the 10transport selection mechanism. It shows information about the
14addresses and the assigned input and output bandwidth. 11addresses and the assigned input and output bandwidth.
15
16.SH OPTIONS 12.SH OPTIONS
17.B 13.B
18.IP "\-a, \-\-aa" 14.IP "\-a, \-\-aa"
@@ -22,8 +18,10 @@ List all addresses currently known to ats.
22Use the configuration file FILENAME. 18Use the configuration file FILENAME.
23.B 19.B
24.IP "\-C, \-\-connect=PEERID" 20.IP "\-C, \-\-connect=PEERID"
25Ask ATS to suggest an address for PEERID to transport to establish a connection. 21Ask ATS to suggest an address for PEERID to transport to establish a
26Note that you can use the gnunet\-transport command\-line tool to force disconnects. 22connection.
23Note that you can use the gnunet\-transport command\-line tool to
24force disconnects.
27.B 25.B
28.IP "\-h, \-\-help" 26.IP "\-h, \-\-help"
29Print short help on options. 27Print short help on options.
@@ -35,7 +33,8 @@ Print information for a specific peer identity only
35Value to set for when changing preference values 33Value to set for when changing preference values
36.B 34.B
37.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL" 35.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
38Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR. 36Use LOGLEVEL for logging.
37Valid values are DEBUG, INFO, WARNING and ERROR.
39.B 38.B
40.IP "\-m, \-\-monitor" 39.IP "\-m, \-\-monitor"
41Monitor changes to the bandwidth assignments continuously 40Monitor changes to the bandwidth assignments continuously
@@ -60,11 +59,9 @@ Print verbose output (include ATS address properties)
60.B 59.B
61.IP "\-v, \-\-version" 60.IP "\-v, \-\-version"
62Print GNUnet version number. 61Print GNUnet version number.
63
64.SH BUGS 62.SH BUGS
65Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending 63Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
66electronic mail to <bug\-gnunet@gnu.org> 64electronic mail to <bug\-gnunet@gnu.org>
67
68.SH SEE ALSO 65.SH SEE ALSO
69gnunet\-transport(1) 66gnunet\-transport(1)
70The full documentation for 67The full documentation for
diff --git a/doc/man/gnunet-auto-share.1 b/doc/man/gnunet-auto-share.1
index 89c8bd6b3..3989b1351 100644
--- a/doc/man/gnunet-auto-share.1
+++ b/doc/man/gnunet-auto-share.1
@@ -1,11 +1,11 @@
1.TH GNUNET\-AUTO\-SHARE "1" "18 Jun 2012" "GNUnet" 1.TH GNUNET\-AUTO\-SHARE "1" "June 18, 2012" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-auto\-share \- a command line tool to automatically share an entire directory with other users 3gnunet\-auto\-share \- a command line tool to automatically share an
4entire directory with other users
4.SH SYNOPSIS 5.SH SYNOPSIS
5.B gnunet\-auto\-share 6.B gnunet\-auto\-share
6[\fIOPTIONS\fR] DIRNAME 7[\fIOPTIONS\fR] DIRNAME
7.SH DESCRIPTION 8.SH DESCRIPTION
8.PP
9In order to share files with other GNUnet users, the files must first be made 9In order to share files with other GNUnet users, the files must first be made
10available to GNUnet. This tool can be used to automatically share all files 10available to GNUnet. This tool can be used to automatically share all files
11from a certain directory. The program will periodically scan the directory 11from a certain directory. The program will periodically scan the directory
@@ -17,35 +17,28 @@ has many options in common with gnunet\-publish, but can only be used to
17index files. 17index files.
18.PP 18.PP
19You can use automatic meta\-data extraction (based on libextractor). 19You can use automatic meta\-data extraction (based on libextractor).
20.PP 20.TP
21
22\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR 21\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
23Use alternate config file (if this option is not specified, the 22Use alternate config file (if this option is not specified, the
24default is ~/.config/gnunet.conf). 23default is ~/.config/gnunet.conf).
25
26.TP 24.TP
27\fB\-D\fR, \fB\-\-disable\-extractor\fR 25\fB\-D\fR, \fB\-\-disable\-extractor\fR
28Disable use of GNU libextractor for finding additional keywords and metadata. 26Disable use of GNU libextractor for finding additional keywords and metadata.
29
30.TP 27.TP
31\fB\-h\fR, \fB\-\-help\fR 28\fB\-h\fR, \fB\-\-help\fR
32Print a brief help page with all the options. 29Print a brief help page with all the options.
33
34.TP 30.TP
35\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=\fILOGLEVEL\fR 31\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=\fILOGLEVEL\fR
36Change the loglevel. Possible values for LOGLEVEL are 32Change the loglevel. Possible values for LOGLEVEL are
37ERROR, WARNING, INFO and DEBUG. 33ERROR, WARNING, INFO and DEBUG.
38
39.TP 34.TP
40\fB\-p \fIPRIORITY\fR, \fB\-\-prio=\fIPRIORITY\fR 35\fB\-p \fIPRIORITY\fR, \fB\-\-prio=\fIPRIORITY\fR
41Executive summary: You probably don't need it. 36Executive summary: You probably don't need it.
42
43Set the priority of the published content (default: 365). If the local 37Set the priority of the published content (default: 365). If the local
44database is full, GNUnet will discard the content with the lowest ranking. 38database is full, GNUnet will discard the content with the lowest ranking.
45Note that ranks change over time depending on popularity. The default 39Note that ranks change over time depending on popularity. The default
46should be high enough to preserve the locally published content in favor 40should be high enough to preserve the locally published content in favor
47of content that migrates from other peers. 41of content that migrates from other peers.
48
49.TP 42.TP
50\fB\-r \fILEVEL\fR, \fB\-\-replication=\fILEVEL\fR 43\fB\-r \fILEVEL\fR, \fB\-\-replication=\fILEVEL\fR
51Set the desired replication level. If CONTENT_PUSHING is set to YES, GNUnet 44Set the desired replication level. If CONTENT_PUSHING is set to YES, GNUnet
@@ -54,20 +47,15 @@ normal "random" replication of all content. This option can be used to push
54some content out into the network harder. Note that pushing content LEVEL 47some content out into the network harder. Note that pushing content LEVEL
55times into the network does not guarantee that there will actually be LEVEL 48times into the network does not guarantee that there will actually be LEVEL
56replicas. 49replicas.
57
58.TP 50.TP
59\fB\-v\fR, \fB\-\-version\fR 51\fB\-v\fR, \fB\-\-version\fR
60Print the version number. 52Print the version number.
61
62.TP 53.TP
63\fB\-V\fR, \fB\-\-verbose\fR 54\fB\-V\fR, \fB\-\-verbose\fR
64Be verbose. Using this option causes gnunet\-publish to print progress 55Be verbose. Using this option causes gnunet\-publish to print progress
65information and at the end the file identification that can be used to download 56information and at the end the file identification that can be used to download
66the file from GNUnet. 57the file from GNUnet.
67
68
69.SH SETTING ANONYMITY LEVEL 58.SH SETTING ANONYMITY LEVEL
70
71The \fB\-a\fR option can be used to specify additional anonymity constraints. 59The \fB\-a\fR option can be used to specify additional anonymity constraints.
72If set to 0, GNUnet will publish the file non-anonymously and in fact sign 60If set to 0, GNUnet will publish the file non-anonymously and in fact sign
73the advertisement for the file using your peer's private key. This will 61the advertisement for the file using your peer's private key. This will
@@ -81,7 +69,7 @@ anonymity, which increases the amount of cover traffic your own traffic will
81get, at the expense of performance. Note that regardless of the anonymity 69get, at the expense of performance. Note that regardless of the anonymity
82level you choose, peers that cache content in the network always use anonymity 70level you choose, peers that cache content in the network always use anonymity
83level 1. 71level 1.
84 72.PP
85The definition of the ANONYMITY LEVEL is the following. 0 means no anonymity 73The definition of the ANONYMITY LEVEL is the following. 0 means no anonymity
86is required. Otherwise a value of 'v' means that 1 out of v bytes of "anonymous" 74is required. Otherwise a value of 'v' means that 1 out of v bytes of "anonymous"
87traffic can be from the local user, leaving 'v-1' bytes of cover traffic per 75traffic can be from the local user, leaving 'v-1' bytes of cover traffic per
@@ -89,38 +77,34 @@ byte on the wire. Thus, if GNUnet routes n bytes of messages from foreign
89peers (using anonymous routing), it may originate n/(v-1) bytes of data in 77peers (using anonymous routing), it may originate n/(v-1) bytes of data in
90the same time\-period. The time\-period is twice the average delay that 78the same time\-period. The time\-period is twice the average delay that
91GNUnet defers forwarded queries. 79GNUnet defers forwarded queries.
92 80.PP
93The default is 1 and this should be fine for most users. Also notice that if 81The default is 1 and this should be fine for most users. Also notice that if
94you choose very large values, you may end up having no throughput at all, 82you choose very large values, you may end up having no throughput at all,
95especially if many of your fellow GNUnet\-peers all do the same. 83especially if many of your fellow GNUnet\-peers all do the same.
96
97
98.SH EXAMPLES 84.SH EXAMPLES
99.PP
100
101\fBBasic example\fR 85\fBBasic example\fR
102 86.TP
103Share a directory "$HOME/gnunet\-share/": 87# gnunet\-auto\-share $HOME/gnunet\-share/ &
104 88Share a directory "$HOME/gnunet\-share/"
105 # gnunet\-auto\-share $HOME/gnunet\-share/ & 89.PP
106
107
108\fBBasic configuration\fR 90\fBBasic configuration\fR
109 91.PP
110Share a directory "$HOME/gnunet\-share/": 92Share a directory "$HOME/gnunet\-share/":
111 93
112 [gnunet-auto-share] 94 [gnunet-auto-share]
113 OPTIONS = $HOME/gnunet\-share 95 OPTIONS = $HOME/gnunet\-share
114 IMMEDIATE_START = YES # start this service when the peer starts 96 IMMEDIATE_START = YES # start this service when the peer starts
115
116.SH FILES 97.SH FILES
117.TP 98.TP
118~/.config/gnunet.conf 99~/.config/gnunet.conf
119GNUnet configuration file 100GNUnet configuration file
120.SH "REPORTING BUGS" 101.SH BUGS
121Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 102Report bugs to <https://gnunet.org/bugs/> or by sending electronic
122.SH "SEE ALSO" 103mail to <gnunet\-developers@gnu.org>
123\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1), \fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1), \fBgnunet.conf\fP(5), \fBextract\fP(1) 104.SH SEE ALSO
105\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1),
106\fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1),
107\fBgnunet.conf\fP(5), \fBextract\fP(1)
124The full documentation for 108The full documentation for
125.B gnunet 109.B gnunet
126is maintained as a Texinfo manual. If the 110is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-bcd.1 b/doc/man/gnunet-bcd.1
index 4a9fe08f6..f10e6f891 100644
--- a/doc/man/gnunet-bcd.1
+++ b/doc/man/gnunet-bcd.1
@@ -1,13 +1,10 @@
1.TH GNUNET\-BCD 1 "Dec 5, 2013" "GNUnet" 1.TH GNUNET\-BCD 1 "December 5, 2013" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-bcd \- run HTTP server to create GNS business cards 3gnunet\-bcd \- run HTTP server to create GNS business cards
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-bcd 5.B gnunet\-bcd
8.RI [ options ] 6.RI [ options ]
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-bcd\fP can be used to create an business card with a QR code 9\fBgnunet\-bcd\fP can be used to create an business card with a QR code
13containing the public key of a zone from the GNU Name System. 10containing the public key of a zone from the GNU Name System.
@@ -15,7 +12,6 @@ gnunet\-bcd requires LaTeX (pdflatex) with various packages to be
15installed. If it does not work for you, try installing the full 12installed. If it does not work for you, try installing the full
16TeXLive distribution first, for example using the package\-manager 13TeXLive distribution first, for example using the package\-manager
17apt: "apt-get install texlive-full". 14apt: "apt-get install texlive-full".
18
19.SH OPTIONS 15.SH OPTIONS
20.B 16.B
21.IP "\-p PORT, \-\-port=PORT" 17.IP "\-p PORT, \-\-port=PORT"
@@ -32,11 +28,10 @@ Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR.
32.B 28.B
33.IP "\-v, \-\-version" 29.IP "\-v, \-\-version"
34Print GNUnet version number. 30Print GNUnet version number.
35
36.SH BUGS 31.SH BUGS
37Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 32Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
38 33electronic mail to <gnunet\-developers@gnu.org>
39.SH "SEE ALSO" 34.SH SEE ALSO
40The full documentation for 35The full documentation for
41.B gnunet 36.B gnunet
42is maintained as a Texinfo manual. If the 37is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-cadet.1 b/doc/man/gnunet-cadet.1
index 9414c14eb..3551a335d 100644
--- a/doc/man/gnunet-cadet.1
+++ b/doc/man/gnunet-cadet.1
@@ -64,9 +64,9 @@ Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR.
64Print GNUnet version number. 64Print GNUnet version number.
65 65
66.SH BUGS 66.SH BUGS
67Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 67Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
68 68electronic mail to <gnunet\-developers@gnu.org>
69.SH "SEE ALSO" 69.SH SEE ALSO
70The full documentation for 70The full documentation for
71.B gnunet 71.B gnunet
72is maintained as a Texinfo manual. If the 72is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-config.1 b/doc/man/gnunet-config.1
index d0fc50ecd..43e7a011b 100644
--- a/doc/man/gnunet-config.1
+++ b/doc/man/gnunet-config.1
@@ -49,9 +49,9 @@ Print GNUnet version number.
49 49
50 50
51.SH BUGS 51.SH BUGS
52Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 52Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
53 53electronic mail to <gnunet\-developers@gnu.org>
54.SH "SEE ALSO" 54.SH SEE ALSO
55The full documentation for 55The full documentation for
56.B gnunet 56.B gnunet
57is maintained as a Texinfo manual. If the 57is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-conversation-test.1 b/doc/man/gnunet-conversation-test.1
index 6ceca61e2..046091752 100644
--- a/doc/man/gnunet-conversation-test.1
+++ b/doc/man/gnunet-conversation-test.1
@@ -1,23 +1,21 @@
1.TH GNUNET\-CONVERSATION\-TEST 1 "Oct 30, 2013" "GNUnet" 1.TH GNUNET\-CONVERSATION\-TEST 1 "October 30, 2013" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-conversation\-test \- check your speaker and microphone settings 3gnunet\-conversation\-test \- check your speaker and microphone settings
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-conversation\-test [OPTIONS] 5.B gnunet\-conversation\-test [OPTIONS]
8.RI URI 6.RI URI
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-conversation\-test\fP can be used to check your speaker and microphone 9\fBgnunet\-conversation\-test\fP can be used to check your speaker and
13settings. It will record you for five seconds and then play the recording back 10microphone settings.
14to you. If this fails, you might want to use the \fBpavucontrol\fP tool to 11It will record you for five seconds and then play the recording back
15check which microphone or speaker were assigned to GNUnet by PulseAudio (you 12to you.
16may have more than one set of microphones or speakers known to your computer). 13If this fails, you might want to use the \fBpavucontrol\fP tool to
17 14check which microphone or speaker were assigned to GNUnet by
18You can use gnunet\-conversation\-test without having a peer running on your 15PulseAudio (you may have more than one set of microphones or speakers
19computer. 16known to your computer).
20 17You can use gnunet\-conversation\-test without having a peer running
18on your computer.
21.SH OPTIONS 19.SH OPTIONS
22.B 20.B
23.IP "\-c FILENAME, \-\-config=FILENAME" 21.IP "\-c FILENAME, \-\-config=FILENAME"
@@ -27,20 +25,20 @@ Use the configuration file FILENAME.
27Print short help on options. 25Print short help on options.
28.B 26.B
29.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL" 27.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
30Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR. 28Use LOGLEVEL for logging.
29Valid values are DEBUG, INFO, WARNING and ERROR.
31.B 30.B
32.IP "\-v, \-\-version" 31.IP "\-v, \-\-version"
33Print GNUnet version number. 32Print GNUnet version number.
34
35
36.SH BUGS 33.SH BUGS
37Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 34Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
38 35electronic mail to <gnunet\-developers@gnu.org>
39.SH "SEE ALSO" 36.SH SEE ALSO
40\fBgnunet\-conversation\fP(1) 37\fBgnunet\-conversation\fP(1)
41The full documentation for 38The full documentation for
42.B gnunet 39.B gnunet
43is maintained as a Texinfo manual. If the 40is maintained as a Texinfo manual.
41If the
44.B info 42.B info
45and 43and
46.B gnunet 44.B gnunet
diff --git a/doc/man/gnunet-conversation.1 b/doc/man/gnunet-conversation.1
index 2440c48a7..fb0596e19 100644
--- a/doc/man/gnunet-conversation.1
+++ b/doc/man/gnunet-conversation.1
@@ -1,20 +1,19 @@
1.TH GNUNET\-CONVERSATION 1 "Oct 5, 2013" "GNUnet" 1.TH GNUNET\-CONVERSATION 1 "October 5, 2013" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-conversation \- have a conversation with your peers 3gnunet\-conversation \- have a conversation with your peers
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-conversation \-e NAME [OPTIONS] 5.B gnunet\-conversation \-e NAME [OPTIONS]
8.RI URI 6.RI URI
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-conversation\fP can be used to have a conversation with other GNUnet 9\fBgnunet\-conversation\fP can be used to have a conversation with
13users. You can make calls and receive incoming calls. You need to setup an 10other GNUnet users.
14ego using gnunet\-identity first. For others to be able to call you, you must 11You can make calls and receive incoming calls.
15add a PHONE record to your zone in the GNU Name System (using gnunet\-namestore). 12You need to setup an ego using gnunet\-identity first.
16gnunet\-conversation has an interactive help system via the /help command. 13For others to be able to call you, you must add a PHONE record to
17 14your zone in the GNU Name System (using gnunet\-namestore).
15gnunet\-conversation has an interactive help system via the /help
16command.
18.SH OPTIONS 17.SH OPTIONS
19.B 18.B
20.IP "\-c FILENAME, \-\-config=FILENAME" 19.IP "\-c FILENAME, \-\-config=FILENAME"
@@ -27,21 +26,20 @@ Specifies the NAME of the ego to use (for caller ID).
27Print short help on options. 26Print short help on options.
28.B 27.B
29.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL" 28.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
30Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR. 29Use LOGLEVEL for logging.
30Valid values are DEBUG, INFO, WARNING and ERROR.
31.B 31.B
32.IP "\-p LINE, \-\-phone=LINE" 32.IP "\-p LINE, \-\-phone=LINE"
33Optional argument that can be used to specify the phone LINE to be used with 33Optional argument that can be used to specify the phone LINE to be used with
34the conversation service. The default LINE is zero, which should be fine 34the conversation service.
35for most users. 35The default LINE is zero, which should be fine for most users.
36.B 36.B
37.IP "\-v, \-\-version" 37.IP "\-v, \-\-version"
38Print GNUnet version number. 38Print GNUnet version number.
39
40
41.SH BUGS 39.SH BUGS
42Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 40Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
43 41electronic mail to <gnunet\-developers@gnu.org>
44.SH "SEE ALSO" 42.SH SEE ALSO
45\fBgnunet\-identity\fP(1), \fBgnunet\-namestore\fP(1), \fBgnunet\-gns\fP(1) 43\fBgnunet\-identity\fP(1), \fBgnunet\-namestore\fP(1), \fBgnunet\-gns\fP(1)
46The full documentation for 44The full documentation for
47.B gnunet 45.B gnunet
diff --git a/doc/man/gnunet-core.1 b/doc/man/gnunet-core.1
index 382d1b152..12d936f7a 100644
--- a/doc/man/gnunet-core.1
+++ b/doc/man/gnunet-core.1
@@ -35,10 +35,10 @@ be verbose
35.SH NOTES 35.SH NOTES
36 36
37 37
38.SH "REPORTING BUGS" 38.SH BUGS
39Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 39Report bugs by using mantis <https://gnunet.org/bugs/> or by sending
40 40electronic mail to <gnunet\-developers@gnu.org>
41.SH "SEE ALSO" 41.SH SEE ALSO
42\fBgnunet\-transport\fP(1) 42\fBgnunet\-transport\fP(1)
43The full documentation for 43The full documentation for
44.B gnunet 44.B gnunet
diff --git a/doc/man/gnunet-datastore.1 b/doc/man/gnunet-datastore.1
index f97363e64..535aedbf5 100644
--- a/doc/man/gnunet-datastore.1
+++ b/doc/man/gnunet-datastore.1
@@ -1,18 +1,17 @@
1.TH gnunet\-datastore "1" "13 April 2017" "GNUnet" 1.TH gnunet\-datastore "1" "April 13, 2017" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-datastore \- dump or insert (restore) GNUnet datastore databases 3gnunet\-datastore \- dump or insert (restore) GNUnet datastore databases
4
5.SH SYNOPSIS 4.SH SYNOPSIS
6.B gnunet\-datastore 5.B gnunet\-datastore
7[\fIOPTIONS\fR] 6[\fIOPTIONS\fR]
8.SH DESCRIPTION 7.SH DESCRIPTION
9.PP 8.PP
10 9gnunet\-datastore can be used to backup and restore or merge GNUnet
11gnunet\-datastore can be used to backup and restore or merge GNUnet datastores. 10datastores.
12This is useful if a datastore is to be migrated between SQL databases, i.e. 11This is useful if a datastore is to be migrated between SQL databases,
13from sqlite to postgres or vice versa. gnunet\-datastore will dump the 12i.e. from sqlite to postgres or vice versa.
14entire contents of the database or insert a dump file into the database. 13gnunet\-datastore will dump the entire contents of the database or
15 14insert a dump file into the database.
16.TP 15.TP
17\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR 16\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
18configuration file to use 17configuration file to use
@@ -37,14 +36,15 @@ configure logging to write logs to FILENAME
37.TP 36.TP
38\fB\-v\fR, \fB\-\-version\fR 37\fB\-v\fR, \fB\-\-version\fR
39print the version number 38print the version number
40 39.SH BUGS
41.SH "REPORTING BUGS" 40Report bugs by using mantis <https://gnunet.org/bugs/> or by sending
42Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 41electronic mail to <gnunet\-developers@gnu.org>
43.SH "SEE ALSO" 42.SH SEE ALSO
44\fBgnunet\-publish\fP(1) 43\fBgnunet\-publish\fP(1)
45The full documentation for 44The full documentation for
46.B gnunet 45.B gnunet
47is maintained as a Texinfo manual. If the 46is maintained as a Texinfo manual.
47If the
48.B info 48.B info
49and 49and
50.B gnunet 50.B gnunet
diff --git a/doc/man/gnunet-directory.1 b/doc/man/gnunet-directory.1
index 7bed13f4d..a8aa515e4 100644
--- a/doc/man/gnunet-directory.1
+++ b/doc/man/gnunet-directory.1
@@ -56,10 +56,12 @@ search results. The directory file can be downloaded to disk
56by \fBgnunet\-download\fP(1) for later processing or be handled more directly 56by \fBgnunet\-download\fP(1) for later processing or be handled more directly
57by \fBgnunet\-fs\-gtk\fP(1). 57by \fBgnunet\-fs\-gtk\fP(1).
58 58
59.SH "REPORTING BUGS" 59.SH BUGS
60Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 60Report bugs by using mantis <https://gnunet.org/bugs/> or by sending
61.SH "SEE ALSO" 61electronic mail to <gnunet\-developers@gnu.org>
62\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1), \fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1) 62.SH SEE ALSO
63\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1),
64\fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1)
63The full documentation for 65The full documentation for
64.B gnunet 66.B gnunet
65is maintained as a Texinfo manual. If the 67is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-dns2gns.1 b/doc/man/gnunet-dns2gns.1
index 8a3c83218..6ecad3c42 100644
--- a/doc/man/gnunet-dns2gns.1
+++ b/doc/man/gnunet-dns2gns.1
@@ -35,7 +35,8 @@ Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR.
35Print GNUnet version number. 35Print GNUnet version number.
36 36
37.SH BUGS 37.SH BUGS
38Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <bug\-gnunet@gnu.org> 38Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
39electronic mail to <bug\-gnunet@gnu.org>
39.SH SEE ALSO 40.SH SEE ALSO
40gnunet\-gns\-fcfs(1), gnunet\-gns(1), gnunet\-identity(1) 41gnunet\-gns\-fcfs(1), gnunet\-gns(1), gnunet\-identity(1)
41The full documentation for 42The full documentation for
diff --git a/doc/man/gnunet-download-manager.1 b/doc/man/gnunet-download-manager.1
index 797afa8c0..7cc6dbffb 100644
--- a/doc/man/gnunet-download-manager.1
+++ b/doc/man/gnunet-download-manager.1
@@ -1,36 +1,64 @@
1.TH GNUNET-DOWNLOAD-MANAGER 1 "15 Jan, 2011" "GNUnet" 1.TH GNUNET-DOWNLOAD-MANAGER 1 "October 26, 2018" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet-download-manager \- manage downloads across sessions 3gnunet-download-manager \- manage downloads across sessions
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-download\-manager 5.B gnunet\-download\-manager
8.RI [ options ] 6.RI [ options ]
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-download\-manager\fP is a script that can be used to track 9\fBgnunet\-download\-manager\fP is a script that can be used to track
13download sessions. It makes the process of resuming downloads after a 10download sessions.
14system reboot easier. A typical use is to define an alias (depending 11It makes the process of resuming downloads after a system reboot
15on your shell) of the form 12easier.
16 13A typical use is to define an alias (depending on your shell) of the
14form:
15.TP
17$ alias gnunet\-download='gnunet\-download\-manager.scm download' 16$ alias gnunet\-download='gnunet\-download\-manager.scm download'
18 17.PP
19Other commands for the download manager include resume (resumes all 18The options for the download manager include:
20downloads), status (show status of pending downloads), killall (abort 19.TP
21all downloads), settings (for configuration) and help (print help text). 20.B download
22 21download
23gnunet\-download\-manager is a scheme script and will only work if Guile 22.TP
24is available. 23.B resume
25 24resumes all downloads
25.TP
26.B status
27show status of pending downloads
28.TP
29.B killall
30abort all downloads
31.TP
32.B settings
33for configuration
34.TP
35.B help
36print help text
37.PP
38gnunet\-download\-manager is a Scheme script and will only work if GNU
39Guile is available.
40.SH EXAMPLES
41(add-hook! *completed-download-hook* completed-download-notification-hook)
42.TP
43Add this to the configuration file to be notified of completed
44downloads.
45.SH FILES
46.TP
47~/.gnunet-download-manager.scm
48Configuration file.
26.SH BUGS 49.SH BUGS
27Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet-developers@gnu.org> 50Report bugs by using mantis <https://gnunet.org/bugs/> or by sending
28 51electronic mail to <gnunet-developers@gnu.org>.
52.PP
53Furthermore it is assumed that gnunet-download-manager is no longer
54working correctly with Guile 2.2 series or current GNUnet, bugfixes
55are welcome.
29.SH SEE ALSO 56.SH SEE ALSO
30gnunet\-download(1) 57gnunet\-download(1)
31The full documentation for 58The full documentation for
32.B gnunet 59.B gnunet
33is maintained as a Texinfo manual. If the 60is maintained as a Texinfo manual.
61If the
34.B info 62.B info
35and 63and
36.B gnunet 64.B gnunet
@@ -47,3 +75,6 @@ will give you access to a tutorial for developers.
47Depending on your installation, this information is also 75Depending on your installation, this information is also
48available in 76available in
49\fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7). 77\fBgnunet\fP(7) and \fBgnunet-c-tutorial\fP(7).
78.SH HISTORY
79.SH AUTHORS
80gnunet\-download\-manager was contributed by Ludovic Courtes in 2004.
diff --git a/doc/man/gnunet-download.1 b/doc/man/gnunet-download.1
index d787a7aba..aa1328c00 100644
--- a/doc/man/gnunet-download.1
+++ b/doc/man/gnunet-download.1
@@ -147,10 +147,13 @@ do the same.
147.TP 147.TP
148~/.config/gnunet.conf 148~/.config/gnunet.conf
149GNUnet configuration file 149GNUnet configuration file
150.SH "REPORTING BUGS" 150.SH BUGS
151Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 151Report bugs to <https://gnunet.org/bugs/> or by sending electronic
152.SH "SEE ALSO" 152mail to <gnunet\-developers@gnu.org>
153\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1), \fBgnunet\-search\fP(1), \fBgnunet.conf\fP(5), \fBgnunet\-service\-fs\fP(1) 153.SH SEE ALSO
154\fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-publish\fP(1),
155\fBgnunet\-search\fP(1), \fBgnunet.conf\fP(5),
156\fBgnunet\-service\-fs\fP(1)
154The full documentation for 157The full documentation for
155.B gnunet 158.B gnunet
156is maintained as a Texinfo manual. If the 159is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-ecc.1 b/doc/man/gnunet-ecc.1
index f0de83865..e3db11eab 100644
--- a/doc/man/gnunet-ecc.1
+++ b/doc/man/gnunet-ecc.1
@@ -1,4 +1,4 @@
1.TH GNUNET\-ECC 1 "Jun 5, 2017" "GNUnet" 1.TH GNUNET\-ECC 1 "June 5, 2017" "GNUnet"
2 2
3.SH NAME 3.SH NAME
4gnunet\-ecc \- manipulate GNUnet ECC key files 4gnunet\-ecc \- manipulate GNUnet ECC key files
@@ -49,7 +49,9 @@ Print GNUnet version number.
49 49
50 50
51.SH BUGS 51.SH BUGS
52Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 52Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
53electronic mail to <gnunet\-developers@gnu.org>
54.SH SEE ALSO
53The full documentation for 55The full documentation for
54.B gnunet 56.B gnunet
55is maintained as a Texinfo manual. If the 57is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-fs.1 b/doc/man/gnunet-fs.1
index e3837cb9d..8a9f0838c 100644
--- a/doc/man/gnunet-fs.1
+++ b/doc/man/gnunet-fs.1
@@ -1,19 +1,17 @@
1.TH gnunet\-fs "1" "2 Nov 2011" "GNUnet" 1.TH GNUNET\-FS "1" "November 2, 2011" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-fs \- measure and control the fs subsystem 3gnunet\-fs \- measure and control the fs subsystem
4
5.SH SYNOPSIS 4.SH SYNOPSIS
6.B gnunet\-fs 5.B gnunet\-fs
7[\fIOPTIONS\fR] 6[\fIOPTIONS\fR]
8.SH DESCRIPTION 7.SH DESCRIPTION
9.PP 8.PP
10
11gnunet\-fs is a tool to access various functions of GNUnet's fs 9gnunet\-fs is a tool to access various functions of GNUnet's fs
12subsystem from the command\-line. Most of these are not expected to 10subsystem from the command\-line.
13be useful for end-users. gnunet\-fs can currently only be used to 11Most of these are not expected to be useful for end-users.
14obtain a list of indexed files. Other functions should be added in 12gnunet\-fs can currently only be used to obtain a list of indexed
15the near future. 13files.
16 14Other functions should be added in the near future.
17.TP 15.TP
18\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR 16\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
19configuration file to use 17configuration file to use
@@ -21,21 +19,22 @@ configuration file to use
21\fB\-h\fR, \fB\-\-help\fR 19\fB\-h\fR, \fB\-\-help\fR
22print help page 20print help page
23.TP 21.TP
24\fB\-i\fR, \fB\-\-list-indexed\fR print information about files that 22\fB\-i\fR, \fB\-\-list-indexed\fR
25are currently indexed by file-sharing 23print information about files that are currently indexed by
24file-sharing
26.TP 25.TP
27\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR Change the 26\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR
28loglevel. Possible values for LOGLEVEL are ERROR, WARNING, INFO and 27Change the loglevel.
29DEBUG. 28Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
30.TP 29.TP
31\fB\-v\fR, \fB\-\-version\fR print the version number 30\fB\-v\fR, \fB\-\-version\fR
31print the version number
32.TP 32.TP
33\fB\-V\fR, \fB\-\-verbose\fR be verbose 33\fB\-V\fR, \fB\-\-verbose\fR
34 34be verbose
35
36.SH BUGS 35.SH BUGS
37Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 36Report bugs by using mantis <https://gnunet.org/bugs/> or by sending
38 37electronic mail to <gnunet\-developers@gnu.org>
39.SH SEE ALSO 38.SH SEE ALSO
40\fBgnunet\-publish\fP(1) 39\fBgnunet\-publish\fP(1)
41The full documentation for 40The full documentation for
diff --git a/doc/man/gnunet-gns-proxy.1 b/doc/man/gnunet-gns-proxy.1
index 3a6cc004f..ccb0f7206 100644
--- a/doc/man/gnunet-gns-proxy.1
+++ b/doc/man/gnunet-gns-proxy.1
@@ -45,8 +45,8 @@ Print GNUnet version number.
45 45
46 46
47.SH BUGS 47.SH BUGS
48Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <bug\-gnunet@gnu.org> 48Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
49 49electronic mail to <bug\-gnunet@gnu.org>
50.SH SEE ALSO 50.SH SEE ALSO
51gnunet\-gns(1) 51gnunet\-gns(1)
52The full documentation for 52The full documentation for
diff --git a/doc/man/gnunet-gns.1 b/doc/man/gnunet-gns.1
index f19c4fc4d..9f7a651a7 100644
--- a/doc/man/gnunet-gns.1
+++ b/doc/man/gnunet-gns.1
@@ -1,58 +1,51 @@
1.TH GNUNET\-GNS 1 "Mar 23, 2018" "GNUnet" 1.TH GNUNET\-GNS 1 "March 23, 2018" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-gns \- Access to GNU Name System 3gnunet\-gns \- Access to GNU Name System
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-gns 5.B gnunet\-gns
8.RI [ options ] 6.RI [ options ]
9.br
10
11.SH DESCRIPTION 7.SH DESCRIPTION
12\fBgnunet\-gns\fP can be used to lookup and process GNU Name Service 8\fBgnunet\-gns\fP can be used to lookup and process GNU Name Service
13names. 9names.
14
15.SH OPTIONS 10.SH OPTIONS
16.B 11.B
17.IP "\-c FILENAME, \-\-config=FILENAME" 12.IP "\-c FILENAME, \-\-config=FILENAME"
18Use the configuration file FILENAME. 13Use the configuration file FILENAME.
19.B 14.B
20.IP "\-r, \-\-raw" 15.IP "\-r, \-\-raw"
21No unneeded output. This is a quiet mode where only important 16No unneeded output.
22information is displayed. For example a lookup for an IP address will 17This is a quiet mode where only important information is displayed.
23only yield the IP address, no descriptive text. 18For example a lookup for an IP address will only yield the IP address,
19no descriptive text.
24.B 20.B
25.IP "\-h, \-\-help" 21.IP "\-h, \-\-help"
26Print short help on options. 22Print short help on options.
27.B 23.B
28.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL" 24.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
29Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and 25Use LOGLEVEL for logging.
30ERROR. 26Valid values are DEBUG, INFO, WARNING and ERROR.
31.B 27.B
32.IP "\-u NAME, \-\-lookup=NAME" 28.IP "\-u NAME, \-\-lookup=NAME"
33Name to lookup. Resolve the specified name using the GNU Name System. 29Name to lookup.
30Resolve the specified name using the GNU Name System.
34.B 31.B
35.IP "\-t TYPE, \-\-type=TYPE" 32.IP "\-t TYPE, \-\-type=TYPE"
36Resource Record Type (TYPE) to look for. Supported TYPE's are: A, 33Resource Record Type (TYPE) to look for.
37AAAA, CNAME, NS, PKEY, PSEU, TLSA, SRV, SOA, MX, LEHO, VPN, REV, PTR, 34Supported TYPE's are: A, AAAA, CNAME, NS, PKEY, PSEU, TLSA, SRV, SOA,
38TXT 35MX, LEHO, VPN, REV, PTR, TXT.
39
40Defaults to "A". 36Defaults to "A".
41.B 37.B
42.IP "\-v, \-\-version" 38.IP "\-v, \-\-version"
43Print GNUnet version number. 39Print GNUnet version number.
44.B
45
46.SH RETURN VALUE 40.SH RETURN VALUE
47
48gnunet\-gns will return 0 on success, 1 on internal failures, 2 on 41gnunet\-gns will return 0 on success, 1 on internal failures, 2 on
49launch failures, 4 if the given name is not configured to use GNS. 42launch failures, 4 if the given name is not configured to use GNS.
50
51
52.SH BUGS 43.SH BUGS
53Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 44Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
54.SH "SEE ALSO" 45electronic mail to <gnunet\-developers@gnu.org>
46.SH SEE ALSO
55\fBgnunet\-namestore\fP(1), \fBgnunet\-identity\fP(1) 47\fBgnunet\-namestore\fP(1), \fBgnunet\-identity\fP(1)
48.PP
56The full documentation for 49The full documentation for
57.B gnunet 50.B gnunet
58is maintained as a Texinfo manual. If the 51is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-identity.1 b/doc/man/gnunet-identity.1
index d20c3a0fa..8d009d07b 100644
--- a/doc/man/gnunet-identity.1
+++ b/doc/man/gnunet-identity.1
@@ -1,4 +1,4 @@
1.TH GNUNET-IDENTITY "1" "5 Sep 2013" "GNUnet" 1.TH GNUNET-IDENTITY "1" "September 5, 2013" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-identity \- create, delete or list egos 3gnunet\-identity \- create, delete or list egos
4.SH SYNOPSIS 4.SH SYNOPSIS
@@ -6,64 +6,62 @@ gnunet\-identity \- create, delete or list egos
6[options] 6[options]
7.SH DESCRIPTION 7.SH DESCRIPTION
8.PP 8.PP
9gnunet\-identity is a tool for managing egos. An ego is the persona 9gnunet\-identity is a tool for managing egos.
10that controls a namespace. It is identical to a public\-private ECC 10An ego is the persona that controls a namespace.
11key pair. 11It is identical to a public\-private ECC key pair.
12 12.PP
13gnunet\-identity can be used to list all of the egos that were created 13gnunet\-identity can be used to list all of the egos that were created
14locally, to create new egos, and to delete existing egos (the 14locally, to create new egos, and to delete existing egos (the
15namespace will continue to exist, but it will be impossible to add 15namespace will continue to exist, but it will be impossible to add
16additional data to it). 16additional data to it).
17 17.PP
18Creating a new ego requires using the \-C option together with an 18Creating a new ego requires using the \-C option together with an
19identifier (name) that is to be used for the new ego. This identifier 19identifier (name) that is to be used for the new ego.
20is only used locally for this peer and not shared with other peers. 20This identifier is only used locally for this peer and not shared with
21 21other peers.
22.TP 22.TP
23\fB\-C NAME\fR, \fB\-\-create=NAME\fR Creates a new ego with the given 23\fB\-C NAME\fR, \fB\-\-create=NAME\fR
24NAME. 24Creates a new ego with the given NAME.
25
26.TP 25.TP
27\fB\-D NAME\fR, \fB\-\-delete=NAME\fR Delete the ego with the given 26\fB\-D NAME\fR, \fB\-\-delete=NAME\fR
28NAME. 27Delete the ego with the given NAME.
29
30.TP 28.TP
31\fB\-e NAME\fR, \fB\-\-ego=NAME\fR Perform "set" operation with the 29\fB\-e NAME\fR, \fB\-\-ego=NAME\fR
32respective ego. Needs to be used together with option \-s. 30Perform "set" operation with the respective ego.
33 31Needs to be used together with option \-s.
34.TP 32.TP
35\fB\-h\fR, \fB\-\-help\fR Print help page. 33\fB\-h\fR, \fB\-\-help\fR
36 34Print help page.
37.TP 35.TP
38\fB\-d\fR, \fB\-\-display\fR display all of our egos 36\fB\-d\fR, \fB\-\-display\fR
39 37display all of our egos
40.TP 38.TP
41\fB\-m\fR, \fB\-\-monitor\fR run in monitor mode, listing all ouf our 39\fB\-m\fR, \fB\-\-monitor\fR
42egos until CTRL-C is pressed. Each ego is listed together with a 40Run in monitor mode, listing all ouf our egos until CTRL-C is pressed.
43unique pointer value; if egos are renamed, that pointer value remains 41Each ego is listed together with a unique pointer value; if egos are
44the same; if egos are deleted, they are listed one more time with a 42renamed, that pointer value remains the same; if egos are deleted,
45name of "<null>". 43they are listed one more time with a name of "<null>".
46
47.TP 44.TP
48\fB\-s SUBSYSTEM\fR, \fB\-\-set=SUBSYSTEM\fR Perform "set" operation 45\fB\-s SUBSYSTEM\fR, \fB\-\-set=SUBSYSTEM\fR
49for the specified SUBSYSTEM with the respective ego. Needs to be used 46Perform "set" operation for the specified SUBSYSTEM with the
50together with option \-e. After this, the given SUBSYSTEM will use 47respective ego.
51the ego with the specified NAME. This will fail if NAME does not yet 48Needs to be used together with option \-e.
52exist. 49After this, the given SUBSYSTEM will use the ego with the specified
53 50NAME.
54 51This will fail if NAME does not yet exist.
55.SH FILES 52.SH FILES
56.TP 53.TP
57~/.local/share/gnunet/identity/egos 54~/.local/share/gnunet/identity/egos
58Directory where the egos are stored (by default) 55Directory where the egos are stored (by default)
59 56.SH BUGS
60.SH "REPORTING BUGS" 57Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
61Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 58electronic mail to <gnunet\-developers@gnu.org>
62.SH "SEE ALSO" 59.SH SEE ALSO
63\fBgnunet\-gns\fP(1), \fBgnunet\-namestore\fP(1) 60\fBgnunet\-gns\fP(1), \fBgnunet\-namestore\fP(1)
64The full documentation for 61The full documentation for
65.B gnunet 62.B gnunet
66is maintained as a Texinfo manual. If the 63is maintained as a Texinfo manual.
64If the
67.B info 65.B info
68and 66and
69.B gnunet 67.B gnunet
diff --git a/doc/man/gnunet-namecache.1 b/doc/man/gnunet-namecache.1
index 8b610d119..528656218 100644
--- a/doc/man/gnunet-namecache.1
+++ b/doc/man/gnunet-namecache.1
@@ -1,4 +1,4 @@
1.TH GNUNET\-NAMECACHE 1 "Oct 16, 2013" "GNUnet" 1.TH GNUNET\-NAMECACHE 1 "October 16, 2013" "GNUnet"
2 2
3.SH NAME 3.SH NAME
4gnunet\-namecache \- inspect namecache 4gnunet\-namecache \- inspect namecache
@@ -35,8 +35,9 @@ Specifies the public key of the zone to inspect (mandatory option)
35 35
36 36
37.SH BUGS 37.SH BUGS
38Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 38Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
39.SH "SEE ALSO" 39electronic mail to <gnunet\-developers@gnu.org>
40.SH SEE ALSO
40\fBgnunet\-gns\fP(1) 41\fBgnunet\-gns\fP(1)
41The full documentation for 42The full documentation for
42.B gnunet 43.B gnunet
diff --git a/doc/man/gnunet-namestore-fcfsd.1 b/doc/man/gnunet-namestore-fcfsd.1
index 2c2960d86..fc0f40eef 100644
--- a/doc/man/gnunet-namestore-fcfsd.1
+++ b/doc/man/gnunet-namestore-fcfsd.1
@@ -50,7 +50,8 @@ Print GNUnet version number.
50Specifies for which EGO should FCFSD manage the zone. 50Specifies for which EGO should FCFSD manage the zone.
51 51
52.SH BUGS 52.SH BUGS
53Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <bug\-gnunet@gnu.org> 53Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
54electronic mail to <bug\-gnunet@gnu.org>
54.SH SEE ALSO 55.SH SEE ALSO
55gnunet\-identity(1), gnunet\-gns(1), gnunet\-gns\-proxy(1) 56gnunet\-identity(1), gnunet\-gns(1), gnunet\-gns\-proxy(1)
56The full documentation for 57The full documentation for
diff --git a/doc/man/gnunet-namestore.1 b/doc/man/gnunet-namestore.1
index 7b06b7fce..10577a0d9 100644
--- a/doc/man/gnunet-namestore.1
+++ b/doc/man/gnunet-namestore.1
@@ -1,4 +1,4 @@
1.TH GNUNET\-NAMESTORE 1 "Apr 15, 2014" "GNUnet" 1.TH GNUNET\-NAMESTORE 1 "April 15, 2014" "GNUnet"
2 2
3.SH NAME 3.SH NAME
4gnunet\-namestore \- manipulate GNU Name System (GNS) zone data 4gnunet\-namestore \- manipulate GNU Name System (GNS) zone data
@@ -89,8 +89,9 @@ Specifies the name of the ego controlling the private key for the zone
89 89
90 90
91.SH BUGS 91.SH BUGS
92Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 92Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
93.SH "SEE ALSO" 93electronic mail to <gnunet\-developers@gnu.org>
94.SH SEE ALSO
94\fBgnunet\-gns\fP(1), \fBgnunet\-namestore\-gtk\fP(1) 95\fBgnunet\-gns\fP(1), \fBgnunet\-namestore\-gtk\fP(1)
95The full documentation for 96The full documentation for
96.B gnunet 97.B gnunet
diff --git a/doc/man/gnunet-nat-auto.1 b/doc/man/gnunet-nat-auto.1
index 17de488ce..ca50d76fc 100644
--- a/doc/man/gnunet-nat-auto.1
+++ b/doc/man/gnunet-nat-auto.1
@@ -65,8 +65,8 @@ Test UDP configuration:
65 65
66 66
67.SH BUGS 67.SH BUGS
68Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 68Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
69 69electronic mail to <gnunet\-developers@gnu.org>
70.SH SEE ALSO 70.SH SEE ALSO
71gnunet\-transport(1) gnunet\-nat(1) 71gnunet\-transport(1) gnunet\-nat(1)
72The full documentation for 72The full documentation for
diff --git a/doc/man/gnunet-nat-server.1 b/doc/man/gnunet-nat-server.1
index 68cbefe5d..a97768340 100644
--- a/doc/man/gnunet-nat-server.1
+++ b/doc/man/gnunet-nat-server.1
@@ -53,8 +53,8 @@ are supposed to autoconfigure with this server.
53Use the configuration file FILENAME. 53Use the configuration file FILENAME.
54 54
55.SH BUGS 55.SH BUGS
56Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 56Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
57 57electronic mail to <gnunet\-developers@gnu.org>
58.SH SEE ALSO 58.SH SEE ALSO
59gnunet\-transport(1) 59gnunet\-transport(1)
60The full documentation for 60The full documentation for
diff --git a/doc/man/gnunet-nat.1 b/doc/man/gnunet-nat.1
index a7f8526b4..cf48e1dc6 100644
--- a/doc/man/gnunet-nat.1
+++ b/doc/man/gnunet-nat.1
@@ -1,118 +1,91 @@
1.TH GNUNET\-NAT 1 "27 Nov 2016" "GNUnet" 1.TH GNUNET\-NAT 1 "October 26, 2018" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-nat \- interact with the NAT service 3gnunet\-nat \- interact with the NAT service
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-nat 5.B gnunet\-nat
8.RI [ options ] 6.RI [ options ]
9.br
10
11.SH DESCRIPTION 7.SH DESCRIPTION
12 8This tool allows testing various NAT traversal functions, as well as
13This tool allows testing various NAT traversal functions, as well 9attempting auto\-configuration.
14as attempting auto\-configuration.
15
16.SH OPTIONS 10.SH OPTIONS
17
18.B 11.B
19.IP "\-b ADDRESS, \-\-bind=ADDRESS" 12.IP "\-b ADDRESS, \-\-bind=ADDRESS"
20Assume that the service is (locally) bound to ADDRESS. 13Assume that the service is (locally) bound to ADDRESS.
21
22.B 14.B
23.IP "\-c FILENAME, \-\-config=FILENAME" 15.IP "\-c FILENAME, \-\-config=FILENAME"
24Use the configuration file FILENAME. 16Use the configuration file FILENAME.
25
26.B 17.B
27.IP "\-e ADDRESS, \-\-external=ADDRESS" 18.IP "\-e ADDRESS, \-\-external=ADDRESS"
28Assume that ADDRESS is the globally visible address of the peer. 19Assume that ADDRESS is the globally visible address of the peer.
29
30.B 20.B
31.IP "\-i ADDRESS, \-\-in=ADDRESS" 21.IP "\-i ADDRESS, \-\-in=ADDRESS"
32Assuming we are listening at ADDRESS for connection reversal requests. 22Assuming we are listening at ADDRESS for connection reversal requests.
33
34.B 23.B
35.IP "\-r ADDRESS, \-\-remote=ADDRESS" 24.IP "\-r ADDRESS, \-\-remote=ADDRESS"
36Ask the peer at ADDRESS for connection reversal, using the local 25Ask the peer at ADDRESS for connection reversal, using the local
37address for the target address of the reversal. 26address for the target address of the reversal.
38
39.B 27.B
40.IP "\-S NAME, \-\-section=NAME" 28.IP "\-S NAME, \-\-section=NAME"
41Name of section in configuration file to use for additional options. 29Name of section in configuration file to use for additional options.
42
43.B 30.B
44.IP "\-s, \-\-stun" 31.IP "\-s, \-\-stun"
45Enable processing of STUN requests. Will try to read UDP packets from 32Enable processing of STUN requests.
46the bind address and handle the packets if they are STUN packets. Will 33Will try to read UDP packets from the bind address and handle the
47only work with UDP. 34packets if they are STUN packets.
48 35Will only work with UDP.
49.B 36.B
50.IP "\-t, \-\-tcp" 37.IP "\-t, \-\-tcp"
51Use TCP. 38Use TCP.
52
53.B 39.B
54.IP "\-u, \-\-udp" 40.IP "\-u, \-\-udp"
55Use UDP. 41Use UDP.
56
57.B 42.B
58.IP "\-W, \-\-watch" 43.IP "\-W, \-\-watch"
59Watch for connection reversal requests. 44Watch for connection reversal requests.
60
61.SH EXAMPLES 45.SH EXAMPLES
62.PP 46.PP
63
64\fBBasic examples\fR 47\fBBasic examples\fR
65 48.TP
49# gnunet-nat -i 0.0.0.0:8080 -u
66We are bound to "0.0.0.0:8080" on UDP and want to obtain all 50We are bound to "0.0.0.0:8080" on UDP and want to obtain all
67applicable IP addresses: 51applicable IP addresses.
68 52.TP
69 # gnunet-nat -i 0.0.0.0:8080 -u 53# gnunet-nat -i '[::0]':8080 -t
70
71We are bound to "::0" on port 8080 on TCP and want to obtain all 54We are bound to "::0" on port 8080 on TCP and want to obtain all
72applicable IP addresses: 55applicable IP addresses.
73 56.TP
74 # gnunet-nat -i '[::0]':8080 -t 57# gnunet-nat -i 127.0.0.1:8080 -u
75
76We are bound to "127.0.0.1:8080" on UDP and want to obtain all 58We are bound to "127.0.0.1:8080" on UDP and want to obtain all
77applicable IP addresses: 59applicable IP addresses:
78 60.PP
79 # gnunet-nat -i 127.0.0.1:8080 -u
80
81\fBICMP-based NAT traversal:\fR 61\fBICMP-based NAT traversal:\fR
82 62.TP
63# gnunet-nat -Wt -i 192.168.178.12:8080
83Watch for connection reversal request (you must be bound to NAT range 64Watch for connection reversal request (you must be bound to NAT range
84or to wildcard, 0.0.0.0), only works for IPv4: 65or to wildcard, 0.0.0.0), only works for IPv4:
85 66.TP
86 # gnunet-nat -Wt -i 192.168.178.12:8080 67# gnunet-nat -t -r 1.2.3.4:8080 -i 2.3.4.5:8080
87
88Initiate connection reversal request from peer at external IPv4 68Initiate connection reversal request from peer at external IPv4
89address 1.2.3.4, while we are running ourselves at 2.3.4.5:8080 (must 69address 1.2.3.4, while we are running ourselves at 2.3.4.5:8080 (must
90use IPv4 addresses): 70use IPv4 addresses):
91 71.TP
92 # gnunet-nat -t -r 1.2.3.4:8080 -i 2.3.4.5:8080 72# gnunet-nat -t -r 1.2.3.4:8080 -i 0.0.0.0:8080
93
94Initiate connection reversal request from peer at external IPv4 73Initiate connection reversal request from peer at external IPv4
95address 1.2.3.4, and let the kernel fill in whatever IPv4 address we 74address 1.2.3.4, and let the kernel fill in whatever IPv4 address we
96happen to have: 75happen to have:
97 76.PP
98 # gnunet-nat -t -r 1.2.3.4:8080 -i 0.0.0.0:8080
99
100\fBManual hole punching:\fR 77\fBManual hole punching:\fR
101 78.TP
79# gnunet-nat -t -p AUTO:8080
102Assume manually punched NAT, but determine external IP automatically: 80Assume manually punched NAT, but determine external IP automatically:
103 81.PP
104 # gnunet-nat -t -p AUTO:8080
105
106\fBSTUN-based XXX:\fR 82\fBSTUN-based XXX:\fR
107 83.TP
108XXX: 84# gnunet-nat FIXME -s
109 85XXX
110 # gnunet-nat FIXME -s
111
112
113.SH BUGS 86.SH BUGS
114Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 87Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
115 88electronic mail to <gnunet\-developers@gnu.org>
116.SH SEE ALSO 89.SH SEE ALSO
117gnunet\-transport(1) 90gnunet\-transport(1)
118The full documentation for 91The full documentation for
diff --git a/doc/man/gnunet-peerinfo.1 b/doc/man/gnunet-peerinfo.1
index a0226f25b..5c610b59f 100644
--- a/doc/man/gnunet-peerinfo.1
+++ b/doc/man/gnunet-peerinfo.1
@@ -51,8 +51,8 @@ Print the version number
51 51
52 52
53.SH BUGS 53.SH BUGS
54Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 54Report bugs by using mantis <https://gnunet.org/bugs/> or by sending
55 55electronic mail to <gnunet\-developers@gnu.org>
56.SH SEE ALSO 56.SH SEE ALSO
57gnunet.conf(5) 57gnunet.conf(5)
58The full documentation for 58The full documentation for
diff --git a/doc/man/gnunet-publish.1 b/doc/man/gnunet-publish.1
index 8811ad6e2..5bc2eec76 100644
--- a/doc/man/gnunet-publish.1
+++ b/doc/man/gnunet-publish.1
@@ -1,4 +1,4 @@
1.TH GNUNET-PUBLISH "1" "16 Nov 2015" "GNUnet" 1.TH GNUNET-PUBLISH "1" "November 16, 2015" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-publish \- a command line interface for publishing new content into GNUnet 3gnunet\-publish \- a command line interface for publishing new content into GNUnet
4.SH SYNOPSIS 4.SH SYNOPSIS
@@ -7,321 +7,328 @@ gnunet\-publish \- a command line interface for publishing new content into GNUn
7.SH DESCRIPTION 7.SH DESCRIPTION
8.PP 8.PP
9In order to share files with other GNUnet users, the files must first 9In order to share files with other GNUnet users, the files must first
10be made available to GNUnet. GNUnet does not automatically share all 10be made available to GNUnet.
11files from a certain directory (however, you can do this with the 11GNUnet does not automatically share all files from a certain directory
12gnunet\-auto\-share tool). In fact, even files that are downloaded 12(however, you can do this with the gnunet\-auto\-share tool).
13are not automatically shared. 13In fact, even files that are downloaded are not automatically shared.
14.PP 14.PP
15In order to start sharing files, the files must be added either using 15In order to start sharing files, the files must be added either using
16gnunet\-publish or a graphical interface such as gnunet\-fs\-gtk. The 16gnunet\-publish or a graphical interface such as gnunet\-fs\-gtk.
17command line tool gnunet\-publish is more useful if many files are 17The command line tool gnunet\-publish is more useful if many files are
18supposed to be added. gnunet\-publish can automatically publish 18supposed to be added.
19batches of files, recursively publish directories, create directories 19gnunet\-publish can automatically publish batches of files,
20that can be browsed within GNUnet and publish file lists in a 20recursively publish directories, create directories that can be
21namespace. When run on a directory, gnunet\-publish will always 21browsed within GNUnet and publish file lists in a namespace.
22recursively publish all of the files in the directory. 22When run on a directory, gnunet\-publish will always recursively
23publish all of the files in the directory.
23.PP 24.PP
24gnunet\-publish can automatically extract keywords from the files that 25gnunet\-publish can automatically extract keywords from the files that
25are shared. Users that want to download files from GNUnet use 26are shared.
26keywords to search for the appropriate content. You can disable 27Users that want to download files from GNUnet use keywords to search
27keyword extraction with the \-D option. You can manually add keywords 28for the appropriate content.
28using the \-k option. The keywords are case\-sensitive. 29You can disable keyword extraction with the \-D option.
30You can manually add keywords using the \-k option.
31The keywords are case\-sensitive.
29.PP 32.PP
30In addition to searching for files by keyword, GNUnet allows 33In addition to searching for files by keyword, GNUnet allows
31organizing files into directories. With directories, the user only 34organizing files into directories.
32needs to find the directory in order to be able to download any of the 35With directories, the user only needs to find the directory in order
33files listed in the directory. Directories can contain pointers to 36to be able to download any of the files listed in the directory.
34other directories. 37Directories can contain pointers to other directories.
35.PP 38.PP
36With gnunet\-publish, it is easy to create new directories 39With gnunet\-publish, it is easy to create new directories
37simultaneously when adding the files. Simply pass the name of a 40simultaneously when adding the files.
38directory instead of a file. 41Simply pass the name of a directory instead of a file.
39.PP 42.PP
40Since keywords can be spammed (any user can add any content under any 43Since keywords can be spammed (any user can add any content under any
41keyword), GNUnet supports namespaces. A namespace is a subset of the 44keyword), GNUnet supports namespaces.
42searchspace into which only the holder of a certain pseudonym can add 45A namespace is a subset of the searchspace into which only the holder
43content. Any GNUnet user can create any number of pseudonyms using 46of a certain pseudonym can add content.
44\fBgnunet\-pseudonym\fR. Pseudonyms are stored in the user's GNUnet 47Any GNUnet user can create any number of pseudonyms using
45directory. While pseudonyms are locally identified with an arbitrary 48\fBgnunet\-pseudonym\fR. Pseudonyms are stored in the user's GNUnet
46string that the user selects when the pseudonym is created, the 49directory.
47namespace is globally known only under the hash of the public key of 50While pseudonyms are locally identified with an arbitrary string that
48the pseudonym. Since only the owner of the pseudonym can add content 51the user selects when the pseudonym is created, the namespace is
49to the namespace, it is impossible for other users to pollute the 52globally known only under the hash of the public key of the pseudonym.
50namespace. gnunet\-publish automatically publishes the top\-directory 53Since only the owner of the pseudonym can add content to the
51(or the only file if only one file is specified) into the namespace if 54namespace, it is impossible for other users to pollute the namespace.
52a pseudonym is specified. 55gnunet\-publish automatically publishes the top\-directory (or the
56only file if only one file is specified) into the namespace if a
57pseudonym is specified.
53.PP 58.PP
54It is possible to update content in GNUnet if that content was placed 59It is possible to update content in GNUnet if that content was placed
55and obtained from a particular namespace. Updates are only possible 60and obtained from a particular namespace.
56for content in namespaces since this is the only way to assure that a 61Updates are only possible for content in namespaces since this is the
57malicious party can not supply counterfeited updates. Note that an 62only way to assure that a malicious party can not supply counterfeited
58update with GNUnet does not make the old content unavailable, GNUnet 63updates.
59merely allows the publisher to point users to more recent 64Note that an update with GNUnet does not make the old content
60versions. You can use the \-N option to specify the future identifier 65unavailable, GNUnet merely allows the publisher to point users to more
61of an update. When using this option, a GNUnet client that finds the 66recent versions.
62current (\-t) identifier will automatically begin a search for the 67You can use the \-N option to specify the future identifier of an
63update (\-N) identifier. If you later publish an update under the 68update.
64(\-N) identifier, both results will be given to the user. 69When using this option, a GNUnet client that finds the current (\-t)
70identifier will automatically begin a search for the update (\-N)
71identifier.
72If you later publish an update under the (\-N) identifier, both
73results will be given to the user.
65.PP 74.PP
66You can use automatic meta\-data extraction (based on libextractor) or 75You can use automatic meta\-data extraction (based on libextractor) or
67the command\-line option \-m to specify meta-data. For the \-m option 76the command\-line option \-m to specify meta-data.
68you need to use the form keyword\-type:value. For example, use "\-m 77For the \-m option you need to use the form keyword\-type:value.
69os:Linux" to specify that the operating system is Linux. Common 78For example, use "\-m os:Linux" to specify that the operating system
70meta\-data types are "author", "title" , "mimetype", "filename", 79is Linux.
71"language", "subject" and "keywords". A full list can be obtained 80Common meta\-data types are "author", "title" , "mimetype",
72from the extract tool using the option \-\-list. The meta\-data is 81"filename", "language", "subject" and "keywords".
73used to help users in searching for files on the network. The 82A full list can be obtained from the extract tool using the option
74keywords are case\-sensitive. 83\-\-list.
84The meta\-data is used to help users in searching for files on the
85network.
86The keywords are case\-sensitive.
75.PP 87.PP
76GNUnet supports two styles of publishing files on the 88GNUnet supports two styles of publishing files on the network.
77network. Publishing a file means that a copy of the file is made in 89Publishing a file means that a copy of the file is made in the local
78the local (!) database of the node. Indexing a file means that an 90(!) database of the node.
79index is added to the local (!) database with symbolic links to the 91Indexing a file means that an index is added to the local (!)
80file itself. The links will use the SHA-512 hash of the entire file 92database with symbolic links to the file itself.
81as the filename. Indexing is generally significantly more efficient 93The links will use the SHA-512 hash of the entire file as the
82and the default choice. However, indexing only works if the indexed 94filename.
83file can be read (using the same absolute path) by gnunet-service-fs. 95Indexing is generally significantly more efficient and the default
96choice.
97However, indexing only works if the indexed file can be read (using
98the same absolute path) by gnunet-service-fs.
84If this is not the case, indexing will fail (and gnunet\-publish will 99If this is not the case, indexing will fail (and gnunet\-publish will
85automatically revert to publishing instead). Regardless of which 100automatically revert to publishing instead).
86method is used to publish the file, the file will be slowly (depending 101Regardless of which method is used to publish the file, the file will
87on how often it is requested and on how much bandwidth is available) 102be slowly (depending on how often it is requested and on how much
88dispersed into the network. If you publish or index a file and then 103bandwidth is available) dispersed into the network.
89leave the network, it will almost always NOT be available anymore. 104If you publish or index a file and then leave the network, it will
90 105almost always NOT be available anymore.
91\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR Use alternate config 106.PP
92file (if this option is not specified, the default is 107\fB\-c \fIFILENAME\fR, \fB\-\-config=FILENAME\fR
93~/.config/gnunet.conf). 108Use alternate config file (if this option is not specified, the
94 109default is ~/.config/gnunet.conf).
95.TP 110.TP
96\fB\-D\fR, \fB\-\-disable\-extractor\fR Disable use of GNU 111\fB\-D\fR, \fB\-\-disable\-extractor\fR
97libextractor for finding additional keywords and metadata. 112Disable use of GNU libextractor for finding additional keywords and
98 113metadata.
99.TP 114.TP
100\fB\-d\fR, \fB\-\-disable\-creation\-time\fR Disable use of creation 115\fB\-d\fR, \fB\-\-disable\-creation\-time\fR
101time timestamp in metadata. Useful to make created directories 116Disable use of creation time timestamp in metadata.
102deterministic and to avoid leaking information about the time at which 117Useful to make created directories deterministic and to avoid leaking
103a file was made available. 118information about the time at which a file was made available.
104
105.TP 119.TP
106\fB\-e\fR, \fB\-\-extract\fR Print the list of keywords that will be 120\fB\-e\fR, \fB\-\-extract\fR
107used for each file given the current options. Do not perform any 121Print the list of keywords that will be used for each file given the
108indexing or publishing. 122current options.
109 123Do not perform any indexing or publishing.
110.TP 124.TP
111\fB\-h\fR, \fB\-\-help\fR Print a brief help page with all the 125\fB\-h\fR, \fB\-\-help\fR
112options. 126Print a brief help page with all the options.
113
114.TP 127.TP
115\fB\-k \fIKEYWORD\fR, \fB\-\-key=KEYWORD\fR additional key to index 128\fB\-k \fIKEYWORD\fR, \fB\-\-key=KEYWORD\fR
116the content with (to add multiple keys, specify multiple times). Each 129Additional key to index the content with (to add multiple keys,
117additional key is case\-sensitive. Can be specified multiple times. 130specify multiple times).
131Each additional key is case\-sensitive.
132Can be specified multiple times.
118The keyword is only applied to the top\-level file or directory. 133The keyword is only applied to the top\-level file or directory.
119
120.TP 134.TP
121\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=\fILOGLEVEL\fR Change the 135\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=\fILOGLEVEL\fR
122loglevel. Possible values for LOGLEVEL are ERROR, WARNING, INFO and 136Change the loglevel.
123DEBUG. 137Possible values for LOGLEVEL are ERROR, WARNING, INFO and DEBUG.
124
125.TP 138.TP
126\fB\-m \fITYPE:VALUE\fR, \fB\-\-meta=\fITYPE:VALUE\fR For the main 139\fB\-m \fITYPE:VALUE\fR, \fB\-\-meta=\fITYPE:VALUE\fR
127file (or directory), set the metadata of the given TYPE to the given 140For the main file (or directory), set the metadata of the given TYPE
128VALUE. Note that this will not add the respective VALUE to the set of 141to the given VALUE.
142Note that this will not add the respective VALUE to the set of
129keywords under which the file can be found. 143keywords under which the file can be found.
130
131.TP 144.TP
132\fB\-n\fR, \fB\-\-noindex\fR Executive summary: You probably don't 145\fB\-n\fR, \fB\-\-noindex\fR
133need it. 146Executive summary: You probably don't need it.
134 147Do not index, full publishing.
135Do not index, full publishing. Note that directories, information for 148Note that directories, information for keyword search, namespace
136keyword search, namespace search and indexing data are always 149search and indexing data are always published (even without this
137published (even without this option). With this option, every block 150option).
138of the actual files is stored in encrypted form in the block database 151With this option, every block of the actual files is stored in
139of the local peer. While this adds security if the local node is 152encrypted form in the block database of the local peer.
140compromised (the adversary snags your machine), it is significantly 153While this adds security if the local node is compromised (the
141less efficient compared to on\-demand encryption and is definitely not 154adversary snags your machine), it is significantly less efficient
142recommended for large files. 155compared to on\-demand encryption and is definitely not recommended
143 156for large files.
144.TP 157.TP
145\fB\-N \fIID\fR, \fB\-\-next=\fIID\fR Specifies the next identifier of 158\fB\-N \fIID\fR, \fB\-\-next=\fIID\fR
146a future version of the file to be published under the same pseudonym. 159Specifies the next identifier of a future version of the file to be
147This option is only valid together with the \-P option. This option 160published under the same pseudonym.
148can be used to specify what the identifier of an updated version will 161This option is only valid together with the \-P option.
149look like. Note that specifying \-i and \-N without \-t is not 162This option can be used to specify what the identifier of an updated
150allowed. 163version will look like.
151 164Note that specifying \-i and \-N without \-t is not allowed.
152.TP 165.TP
153\fB\-p \fIPRIORITY\fR, \fB\-\-prio=\fIPRIORITY\fR Executive summary: 166\fB\-p \fIPRIORITY\fR, \fB\-\-prio=\fIPRIORITY\fR
154You probably don't need it. 167Executive summary: You probably don't need it.
155 168Set the priority of the published content (default: 365).
156Set the priority of the published content (default: 365). If the 169If the local database is full, GNUnet will discard the content with
157local database is full, GNUnet will discard the content with the 170the lowest ranking.
158lowest ranking. Note that ranks change over time depending on 171Note that ranks change over time depending on popularity.
159popularity. The default should be high enough to preserve the locally 172The default should be high enough to preserve the locally published
160published content in favor of content that migrates from other peers. 173content in favor of content that migrates from other peers.
161
162.TP 174.TP
163\fB\-P \fINAME\fR, \fB\-\-pseudonym=\fINAME\fR For the top\-level 175\fB\-P \fINAME\fR, \fB\-\-pseudonym=\fINAME\fR
164directory or file, places the file into the namespace identified by 176For the top\-level directory or file, places the file into the
165the pseudonym NAME. NAME must be a valid pseudonym managed by 177namespace identified by the pseudonym NAME.
166gnunet\-identity. 178NAME must be a valid pseudonym managed by gnunet\-identity.
167
168.TP 179.TP
169\fB\-r \fILEVEL\fR, \fB\-\-replication=\fILEVEL\fR Set the desired 180\fB\-r \fILEVEL\fR, \fB\-\-replication=\fILEVEL\fR
170replication level. If CONTENT_PUSHING is set to YES, GNUnet will push 181Set the desired replication level.
171each block (for the file) LEVEL times to other peers before doing 182If CONTENT_PUSHING is set to YES, GNUnet will push each block (for the
172normal "random" replication of all content. This option can be used 183file) LEVEL times to other peers before doing normal "random"
173to push some content out into the network harder. Note that pushing 184replication of all content.
174content LEVEL times into the network does not guarantee that there 185This option can be used to push some content out into the network
175will actually be LEVEL replicas. 186harder.
176 187Note that pushing content LEVEL times into the network does not
188guarantee that there will actually be LEVEL replicas.
177.TP 189.TP
178\fB\-s\fR, \fB\-\-simulate-only\fR When this option is used, 190\fB\-s\fR, \fB\-\-simulate-only\fR
179gnunet\-publish will not actually publish the file but just simulate 191When this option is used, gnunet\-publish will not actually publish
180what would be done. This can be used to compute the GNUnet URI for a 192the file but just simulate what would be done.
181file without actually sharing it. 193This can be used to compute the GNUnet URI for a file without actually
182 194sharing it.
183.TP 195.TP
184\fB\-t \fIID\fR, \fB\-\-this=\fIID\fR Specifies the identifier under 196\fB\-t \fIID\fR, \fB\-\-this=\fIID\fR
185which the file is to be published under a pseudonym. This option is 197Specifies the identifier under which the file is to be published under
186only valid together with the\ \-P option. 198a pseudonym.
187 199This option is only valid together with the\ \-P option.
188.TP 200.TP
189\fB\-u \fIURI\fR, \fB\-\-uri=\fIURI\fR This option can be used to 201\fB\-u \fIURI\fR, \fB\-\-uri=\fIURI\fR
190specify the URI of a file instead of a filename (this is the only case 202This option can be used to specify the URI of a file instead of a
191where the otherwise mandatory filename argument must be omitted). 203filename (this is the only case where the otherwise mandatory filename
204argument must be omitted).
192Instead of publishing a file or directory and using the corresponding 205Instead of publishing a file or directory and using the corresponding
193URI, gnunet\-publish will use this URI and perform the selected 206URI, gnunet\-publish will use this URI and perform the selected
194namespace or keyword operations. This can be used to add additional 207namespace or keyword operations.
195keywords to a file that has already been shared or to add files to a 208This can be used to add additional keywords to a file that has already
196namespace for which the URI is known but the content is not locally 209been shared or to add files to a namespace for which the URI is known
197available. 210but the content is not locally available.
198
199.TP 211.TP
200\fB\-v\fR, \fB\-\-version\fR Print the version number. 212\fB\-v\fR, \fB\-\-version\fR
201 213Print the version number.
202.TP 214.TP
203\fB\-V\fR, \fB\-\-verbose\fR Be verbose. Using this option causes 215\fB\-V\fR, \fB\-\-verbose\fR
204gnunet\-publish to print progress information and at the end the file 216Be verbose.
205identification that can be used to download the file from GNUnet. 217Using this option causes gnunet\-publish to print progress information
206 218and at the end the file identification that can be used to download
207 219the file from GNUnet.
208.SH SETTING ANONYMITY LEVEL 220.SH SETTING ANONYMITY LEVEL
209
210The \fB\-a\fR option can be used to specify additional anonymity 221The \fB\-a\fR option can be used to specify additional anonymity
211constraints. If set to 0, GNUnet will publish the file non-anonymously 222constraints.
212and in fact sign the advertisement for the file using your peer's 223If set to 0, GNUnet will publish the file non-anonymously and in fact
213private key. This will allow other users to download the file as fast 224sign the advertisement for the file using your peer's private key.
214as possible, including using non-anonymous methods (DHT, direct 225This will allow other users to download the file as fast as possible,
215transfer). If you set it to 1 (default), you use the standard 226including using non-anonymous methods (DHT, direct transfer).
216anonymous routing algorithm (which does not explicitly leak your 227If you set it to 1 (default), you use the standard anonymous routing
217identity). However, a powerful adversary may still be able to perform 228algorithm (which does not explicitly leak your identity).
218traffic analysis (statistics) to over time infer data about your 229However, a powerful adversary may still be able to perform traffic
219identity. You can gain better privacy by specifying a higher level of 230analysis (statistics) to over time infer data about your identity.
220anonymity, which increases the amount of cover traffic your own 231You can gain better privacy by specifying a higher level of anonymity,
221traffic will get, at the expense of performance. Note that regardless 232which increases the amount of cover traffic your own traffic will get,
222of the anonymity level you choose, peers that cache content in the 233at the expense of performance.
223network always use anonymity level 1. 234Note that regardless of the anonymity level you choose, peers that
224 235cache content in the network always use anonymity level 1.
225The definition of the ANONYMITY LEVEL is the following. 0 means no 236.PP
226anonymity is required. Otherwise a value of 'v' means that 1 out of v 237The definition of the ANONYMITY LEVEL is the following.
227bytes of "anonymous" traffic can be from the local user, leaving 'v-1' 2380 means no anonymity is required.
228bytes of cover traffic per byte on the wire. Thus, if GNUnet routes n 239Otherwise a value of 'v' means that 1 out of v bytes of "anonymous"
229bytes of messages from foreign peers (using anonymous routing), it may 240traffic can be from the local user, leaving 'v-1' bytes of cover
230originate n/(v-1) bytes of data in the same time\-period. The 241traffic per byte on the wire.
231time\-period is twice the average delay that GNUnet defers forwarded 242Thus, if GNUnet routes n bytes of messages from foreign peers (using
232queries. 243anonymous routing), it may originate n/(v-1) bytes of data in the same
233 244time\-period.
234The default is 1 and this should be fine for most users. Also notice 245The time\-period is twice the average delay that GNUnet defers
235that if you choose very large values, you may end up having no 246forwarded queries.
236throughput at all, especially if many of your fellow GNUnet\-peers all 247.PP
237do the same. 248The default is 1 and this should be fine for most users.
238 249Also notice that if you choose very large values, you may end up
239 250having no throughput at all, especially if many of your fellow
251GNUnet\-peers all do the same.
240.SH EXAMPLES 252.SH EXAMPLES
241.PP 253.PP
242
243\fBBasic examples\fR 254\fBBasic examples\fR
244 255.TP
245Index a file COPYING: 256gnunet\-publish COPYING
246 257Index a file COPYING
247 # gnunet\-publish COPYING 258.TP
248 259gnunet\-publish \-n COPYING
249Publish a file COPYING: 260Publish a file COPYING
250 261.TP
251 # gnunet\-publish \-n COPYING 262gnunet\-publish \-k gpl \-k test COPYING
252 263Index a file COPYING with the keywords \fBgpl\fR and \fBtest\fR
253Index a file COPYING with the keywords \fBgpl\fR and \fBtest\fR: 264.TP
254 265gnunet\-publish \-m "description:GNU License" \-k gpl \-k test \-m "mimetype:text/plain" COPYING
255 # gnunet\-publish \-k gpl \-k test COPYING
256
257Index a file COPYING with description "GNU License", mime-type 266Index a file COPYING with description "GNU License", mime-type
258"text/plain" and keywords \fBgpl\fR and \fBtest\fR: 267"text/plain" and keywords \fBgpl\fR and \fBtest\fR
259 268.PP
260 # gnunet\-publish \-m "description:GNU License" \-k gpl \-k test \-m
261 "mimetype:text/plain" COPYING
262
263\fBUsing directories\fR 269\fBUsing directories\fR
264 270.TP
271mkdir gnu ; mv COPYING AUTHORS gnu/ ; gnunet\-publish \-k test \-k gnu \-D gnu/
265Index the files COPYING and AUTHORS with keyword \fBtest\fR and build 272Index the files COPYING and AUTHORS with keyword \fBtest\fR and build
266a directory containing the two files. Make the directory itself 273a directory containing the two files. Make the directory itself
267available under keyword \fBgnu\fR and disable keyword extraction using 274available under keyword \fBgnu\fR and disable keyword extraction using
268libextractor: 275libextractor
269 276.TP
270 # mkdir gnu mv COPYING AUTHORS gnu/ gnunet\-publish \-k test \-k gnu 277gnunet\-publish \-n \-m "description:Kitten collection" \-k kittens kittendir/
271 # \-D gnu/
272
273Neatly publish an image gallery in \fBkittendir/\fR and its subdirs 278Neatly publish an image gallery in \fBkittendir/\fR and its subdirs
274with keyword \fBkittens\fR for the directory but no keywords for the 279with keyword \fBkittens\fR for the directory but no keywords for the
275individual files or subdirs (\-n). Force description for all files: 280individual files or subdirs (\-n).
276 281Force description for all files.
277 # gnunet\-publish \-n \-m "description:Kitten collection" \-k kittens 282.PP
278 kittendir/
279
280\fBSecure publishing with namespaces\fR 283\fBSecure publishing with namespaces\fR
281 284.TP
285gnunet\-publish \-P RIAA-2 \-t gpl COPYING
282Publish file COPYING with pseudonym RIAA-2 (\-P) and with identifier 286Publish file COPYING with pseudonym RIAA-2 (\-P) and with identifier
283\fBgpl\fR (\-t) and no updates: 287\fBgpl\fR (\-t) and no updates
284 288.TP
285 # gnunet\-publish \-P RIAA-2 \-t gpl COPYING 289gnunet\-publish \-P RIAA-2 \-t MUSIC \-N VIDEOS /home/ogg
286
287Recursively index /home/ogg and build a matching directory 290Recursively index /home/ogg and build a matching directory
288structure. Publish the top\-level directory into the namespace under 291structure. Publish the top\-level directory into the namespace under
289the pseudonym RIAA\-2 (\-P) under identifier 'MUSIC' (\-t) and promise 292the pseudonym RIAA\-2 (\-P) under identifier 'MUSIC' (\-t) and promise
290to provide an update with identifier 'VIDEOS' (\-N): 293to provide an update with identifier 'VIDEOS' (\-N):
291 294.TP
292 # gnunet\-publish \-P RIAA-2 \-t MUSIC \-N VIDEOS /home/ogg 295gnunet\-publish \-nV /var/lib/mysql
293
294Recursively publish (\-n) /var/lib/mysql and build a matching 296Recursively publish (\-n) /var/lib/mysql and build a matching
295directory structure, but disable the use of libextractor to extract 297directory structure, but disable the use of libextractor to extract
296keywords (\-n). Print the file identifiers (\-V) that can be used to 298keywords (\-n).
297retrieve the files. This will store a copy of the MySQL database in 299Print the file identifiers (\-V) that can be used to retrieve the
298GNUnet but without adding any keywords to search for it. Thus only 300files.
299people that have been told the secret file identifiers printed with 301This will store a copy of the MySQL database in GNUnet but without
300the \-V option can retrieve the (secret?) files: 302adding any keywords to search for it.
301 303Thus only people that have been told the secret file identifiers
302 # gnunet\-publish \-nV /var/lib/mysql 304printed with the \-V option can retrieve the (secret?) files:
303 305.TP
306gnunet\-publish \-P MPAA-1 \-t root \-N next noise.mp3
304Create a namespace entry 'root' in namespace MPAA-1 and announce that 307Create a namespace entry 'root' in namespace MPAA-1 and announce that
305the next update will be called 'next': 308the next update will be called 'next':
306 309.TP
307 # gnunet\-publish \-P MPAA-1 \-t root \-N next noise.mp3 310gnunet\-publish \-P MPAA-1 \-t next noise_updated.mp3
308
309Update the previous entry, do not allow any future updates: 311Update the previous entry, do not allow any future updates:
310
311 # gnunet\-publish \-P MPAA-1 \-t next noise_updated.mp3
312
313
314.SH FILES 312.SH FILES
315.TP 313.TP
316~/.config/gnunet.conf 314~/.config/gnunet.conf
317GNUnet configuration file 315GNUnet configuration file
318.SH "REPORTING BUGS" 316.SH BUGS
319Report bugs to <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 317Report bugs to <https://gnunet.org/bugs/> or by sending electronic
320.SH "SEE ALSO" 318mail to <gnunet\-developers@gnu.org>
321\fBgnunet\-auto\-share\fP(1), \fBgnunet\-fs\-gtk\fP(1), \fBgnunet\-search\fP(1), \fBgnunet\-download\fP(1), \fBgnunet.conf\fP(5), \fBextract\fP(1), \fBgnunet\-identity\fP(1) 319.SH SEE ALSO
320\fBgnunet\-auto\-share\fP(1)
321\fBgnunet\-fs\-gtk\fP(1)
322\fBgnunet\-search\fP(1)
323\fBgnunet\-download\fP(1)
324\fBgnunet.conf\fP(5)
325\fBextract\fP(1)
326\fBgnunet\-identity\fP(1)
327.PP
322The full documentation for 328The full documentation for
323.B gnunet 329.B gnunet
324is maintained as a Texinfo manual. If the 330is maintained as a Texinfo manual.
331If the
325.B info 332.B info
326and 333and
327.B gnunet 334.B gnunet
diff --git a/doc/man/gnunet-qr.1 b/doc/man/gnunet-qr.1
index 01c05084c..b80f18bb3 100644
--- a/doc/man/gnunet-qr.1
+++ b/doc/man/gnunet-qr.1
@@ -1,17 +1,13 @@
1.TH GNUNET\-QR 1 "Sep 13, 2014" "GNUnet" 1.TH GNUNET\-QR 1 "September 13, 2014" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-qr \- Scan a QR code using a video device and import. 3gnunet\-qr \- Scan a QR code using a video device and import.
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-qr 5.B gnunet\-qr
8.RI [ options ] 6.RI [ options ]
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-qr\fP is a command line tool to scan a QR code using a 9\fBgnunet\-qr\fP is a command line tool to scan a QR code using a
13video device and import. 10video device and import.
14
15.SH OPTIONS 11.SH OPTIONS
16.B 12.B
17.IP "\-c FILENAME, \-\-config=FILENAME" 13.IP "\-c FILENAME, \-\-config=FILENAME"
@@ -28,10 +24,10 @@ Do not show preview windows.
28.B 24.B
29.IP "\-v, \-\-verbose" 25.IP "\-v, \-\-verbose"
30Be verbose. 26Be verbose.
31
32.SH BUGS 27.SH BUGS
33Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 28Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
34.SH "SEE ALSO" 29electronic mail to <gnunet\-developers@gnu.org>
30.SH SEE ALSO
35The full documentation for 31The full documentation for
36.B gnunet 32.B gnunet
37is maintained as a Texinfo manual. If the 33is maintained as a Texinfo manual. If the
diff --git a/doc/man/gnunet-revocation.1 b/doc/man/gnunet-revocation.1
index 467eb4bcf..1afda399c 100644
--- a/doc/man/gnunet-revocation.1
+++ b/doc/man/gnunet-revocation.1
@@ -1,4 +1,4 @@
1.TH GNUNET\-REVOCATION 1 "Mar 15, 2012" "GNUnet" 1.TH GNUNET\-REVOCATION 1 "March 15, 2012" "GNUnet"
2 2
3.SH NAME 3.SH NAME
4gnunet\-revocation \- revoke private keys (of egos) in GNUnet 4gnunet\-revocation \- revoke private keys (of egos) in GNUnet
diff --git a/doc/man/gnunet-search.1 b/doc/man/gnunet-search.1
index d79dd620c..79991e375 100644
--- a/doc/man/gnunet-search.1
+++ b/doc/man/gnunet-search.1
@@ -1,4 +1,4 @@
1.TH GNUNET-SEARCH "1" "25 Feb 2012" "0.9.6" "GNUnet" 1.TH GNUNET-SEARCH "1" "February 25, 2012" "0.9.6" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-search \- a command line interface to search for content on GNUnet 3gnunet\-search \- a command line interface to search for content on GNUnet
4.SH SYNOPSIS 4.SH SYNOPSIS
@@ -117,11 +117,11 @@ Searches for content matching both mandatory keywords "Das" and "Kapital".
117Search results are printed by gnunet\-search like this: 117Search results are printed by gnunet\-search like this:
118.P 118.P
119.ad l 119.ad l
120 gnunet\-download \-o "COPYING" gnunet://fs/chk/HASH1.HASH2.SIZE 120 gnunet\-download \-o "COPYING" gnunet://fs/chk/HASH1.HASH2.SIZE
121 121
122 Description: The GNU General Public License 122 Description: The GNU General Public License
123 123
124 Mime-type: text/plain 124 Mime-type: text/plain
125.ad b 125.ad b
126 126
127The first line contains the command to run to download the file. The 127The first line contains the command to run to download the file. The
diff --git a/doc/man/gnunet-testbed-profiler.1 b/doc/man/gnunet-testbed-profiler.1
index a5f7ea70d..cac6e9af7 100644
--- a/doc/man/gnunet-testbed-profiler.1
+++ b/doc/man/gnunet-testbed-profiler.1
@@ -1,16 +1,12 @@
1.TH GNUNET\-TESTBED\-PROFILER 1 "Sep 13, 2014" "GNUnet" 1.TH GNUNET\-TESTBED\-PROFILER 1 "September 13, 2014" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-testbed\-profiler \- Profiling driver for the testbed. 3gnunet\-testbed\-profiler \- Profiling driver for the testbed.
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-testbed\-profiler 5.B gnunet\-testbed\-profiler
8.RI [ options ] 6.RI [ options ]
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-testbed\-profiler\fP is a command line profiling driver for the testbed. 9\fBgnunet\-testbed\-profiler\fP is a command line profiling driver for the testbed.
13
14.SH OPTIONS 10.SH OPTIONS
15.B 11.B
16.IP "\-c FILENAME, \-\-config=FILENAME" 12.IP "\-c FILENAME, \-\-config=FILENAME"
@@ -41,7 +37,6 @@ Create COUNT number of peers.
41.B 37.B
42.IP "\-v, \-\-version" 38.IP "\-v, \-\-version"
43Print GNUnet version number. 39Print GNUnet version number.
44
45.SH BUGS 40.SH BUGS
46Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 41Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
47.SH "SEE ALSO" 42.SH "SEE ALSO"
diff --git a/doc/man/gnunet-testing.1 b/doc/man/gnunet-testing.1
index 47aa4a411..ff1af50ef 100644
--- a/doc/man/gnunet-testing.1
+++ b/doc/man/gnunet-testing.1
@@ -1,16 +1,13 @@
1.TH GNUNET\-TESTING 1 "Jan 4, 2012" "GNUnet" 1.TH GNUNET\-TESTING 1 "January 4, 2012" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-testing \- Command line tool to access the testing library. 3gnunet\-testing \- Command line tool to access the testing library.
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-testing 5.B gnunet\-testing
8.RI [ options ] 6.RI [ options ]
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-testing\fP is a command line tool to access the testing library. 9\fBgnunet\-testing\fP is a command line tool to access the testing
13 10library.
14.SH OPTIONS 11.SH OPTIONS
15.B 12.B
16.IP "\-C, \-\-cfg" 13.IP "\-C, \-\-cfg"
@@ -42,13 +39,14 @@ Configuration template.
42.B 39.B
43.IP "\-v, \-\-version" 40.IP "\-v, \-\-version"
44Print GNUnet version number. 41Print GNUnet version number.
45
46.SH BUGS 42.SH BUGS
47Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 43Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
48.SH "SEE ALSO" 44electronic mail to <gnunet\-developers@gnu.org>
45.SH SEE ALSO
49The full documentation for 46The full documentation for
50.B gnunet 47.B gnunet
51is maintained as a Texinfo manual. If the 48is maintained as a Texinfo manual.
49If the
52.B info 50.B info
53and 51and
54.B gnunet 52.B gnunet
diff --git a/doc/man/gnunet-transport.1 b/doc/man/gnunet-transport.1
index e05f451b5..2aafbb9ab 100644
--- a/doc/man/gnunet-transport.1
+++ b/doc/man/gnunet-transport.1
@@ -1,20 +1,17 @@
1.TH gnunet\-transport "1" "17 Oct 2015" "GNUnet" 1.TH GNUNET\-TRANSPORT "1" "October 17, 2015" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-transport \- measure and control the transport subsystem 3gnunet\-transport \- measure and control the transport subsystem
4
5.SH SYNOPSIS 4.SH SYNOPSIS
6.B gnunet\-transport 5.B gnunet\-transport
7[\fIOPTIONS\fR] 6[\fIOPTIONS\fR]
8.SH DESCRIPTION 7.SH DESCRIPTION
9.PP 8.PP
10
11gnunet\-transport is a tool to access various functions of GNUnet's 9gnunet\-transport is a tool to access various functions of GNUnet's
12transport subsystem from the command\-line. Most of these are not 10transport subsystem from the command\-line. Most of these are not
13expected to be useful for end-users. gnunet\-transport can be used to 11expected to be useful for end-users. gnunet\-transport can be used to
14evaluate the performance of the transports, force a peer to connect to 12evaluate the performance of the transports, force a peer to connect to
15another peer (if possible). Other functions should be added in the 13another peer (if possible). Other functions should be added in the
16near future. 14near future.
17
18.TP 15.TP
19\fB\-b\fR, \fB\-\-benchmark\fR 16\fB\-b\fR, \fB\-\-benchmark\fR
20measure how fast we are receiving data (from all connections). On 17measure how fast we are receiving data (from all connections). On
@@ -62,10 +59,6 @@ print the version number
62.TP 59.TP
63\fB\-V\fR, \fB\-\-verbose\fR 60\fB\-V\fR, \fB\-\-verbose\fR
64be verbose 61be verbose
65
66.SH NOTES
67
68
69.SH "REPORTING BUGS" 62.SH "REPORTING BUGS"
70Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 63Report bugs by using mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org>
71.SH "SEE ALSO" 64.SH "SEE ALSO"
diff --git a/doc/man/gnunet-unindex.1 b/doc/man/gnunet-unindex.1
index bc6a23f6a..1c9d1a58c 100644
--- a/doc/man/gnunet-unindex.1
+++ b/doc/man/gnunet-unindex.1
@@ -1,4 +1,4 @@
1.TH GNUNET-UNINDEX "1" "6 Sep 2009" "GNUnet" 1.TH GNUNET-UNINDEX "1" "September 6, 2009" "GNUnet"
2.SH NAME 2.SH NAME
3gnunet\-unindex \- a command line interface for deleting indexed files from GNUnet 3gnunet\-unindex \- a command line interface for deleting indexed files from GNUnet
4.SH SYNOPSIS 4.SH SYNOPSIS
@@ -17,7 +17,6 @@ print help page
17\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR 17\fB\-L \fILOGLEVEL\fR, \fB\-\-loglevel=LOGLEVEL\fR
18Change the loglevel. Possible values for LOGLEVEL are NOTHING, 18Change the loglevel. Possible values for LOGLEVEL are NOTHING,
19ERROR, WARNING, INFO and DEBUG. 19ERROR, WARNING, INFO and DEBUG.
20
21.TP 20.TP
22\fB\-v\fR, \fB\-\-version\fR 21\fB\-v\fR, \fB\-\-version\fR
23print the version number 22print the version number
diff --git a/doc/man/gnunet-vpn.1 b/doc/man/gnunet-vpn.1
index f4e445c21..838624d98 100644
--- a/doc/man/gnunet-vpn.1
+++ b/doc/man/gnunet-vpn.1
@@ -1,29 +1,27 @@
1.TH GNUNET\-VPN 1 "25 Feb 2012" "GNUnet" 1.TH GNUNET\-VPN 1 "February 25, 2012" "GNUnet"
2
3.SH NAME 2.SH NAME
4gnunet\-vpn \- manually setup a GNUnet VPN tunnel 3gnunet\-vpn \- manually setup a GNUnet VPN tunnel
5
6.SH SYNOPSIS 4.SH SYNOPSIS
7.B gnunet\-vpn 5.B gnunet\-vpn
8.RI [ options ] 6.RI [ options ]
9.br 7.br
10
11.SH DESCRIPTION 8.SH DESCRIPTION
12\fBgnunet\-vpn\fP can be used to manually setup a VPN tunnel via the 9\fBgnunet\-vpn\fP can be used to manually setup a VPN tunnel via the
13GNUnet network. There are two main types of tunnels. Tunnels to an 10GNUnet network.
14exit node which routes the traffic to the global Internet, and tunnels 11There are two main types of tunnels.
15to a node that runs a service only within GNUnet. Depending on the 12Tunnels to an exit node which routes the traffic to the global
16type of tunnel, gnunet\-vpn takes different options. The "\-i" option 13Internet, and tunnels to a node that runs a service only within
17is required for tunnels to an exit node, whereas the "\-p" and "\-s" 14GNUnet.
18options in conjunction with either "\-u" or "\-t" are required for 15Depending on the type of tunnel, gnunet\-vpn takes different options.
19tunnels to services. For exit tunnels, both UDP and TCP traffic will 16The "\-i" option is required for tunnels to an exit node, whereas the
20be redirected. For service tunnels, either UDP ("\-u") or TCP ("\-t") 17"\-p" and "\-s" options in conjunction with either "\-u" or "\-t" are
21traffic will be redirected. 18required for tunnels to services.
22 19For exit tunnels, both UDP and TCP traffic will be redirected.
23The tool will display the IP address for this end of the tunnel. The 20For service tunnels, either UDP ("\-u") or TCP ("\-t") traffic will
24address can be displayed as soon as it has been allocated, or only 21be redirected.
22The tool will display the IP address for this end of the tunnel.
23The address can be displayed as soon as it has been allocated, or only
25after ("\-a") the tunnel has been created. 24after ("\-a") the tunnel has been created.
26
27.SH OPTIONS 25.SH OPTIONS
28.B 26.B
29.IP "\-4, \-\-ipv4" 27.IP "\-4, \-\-ipv4"
@@ -36,46 +34,50 @@ Desired IP address on this end of the tunnel should be an IPv6 address.
36Use the configuration file FILENAME. 34Use the configuration file FILENAME.
37.B 35.B
38.IP "\-d TIME, \-\-duration TIME" 36.IP "\-d TIME, \-\-duration TIME"
39The mapping should be established for TIME. The value given must be a 37The mapping should be established for TIME.
40number followed by a space and a time unit, for example "500 ms". 38The value given must be a number followed by a space and a time unit,
41Note that the quotes are required on the shell. Default is 5 minutes. 39for example "500 ms".
40Note that the quotes are required on the shell.
41Default is 5 minutes.
42.B 42.B
43.IP "\-h, \-\-help" 43.IP "\-h, \-\-help"
44Print short help on options. 44Print short help on options.
45.B 45.B
46.IP "\-i IP, \-\-ip IP" 46.IP "\-i IP, \-\-ip IP"
47Tunnel should be to an exit node and connect to the given IPv4 or IPv6 47Tunnel should be to an exit node and connect to the given IPv4 or IPv6
48IP address. Note that you can specify an IPv6 address as the target 48IP address.
49here, even in combination with "\-4" (4to6) and similarly you can 49Note that you can specify an IPv6 address as the target here, even in
50specify an IPv4 address in combination with "\-6" (6to4). 50combination with "\-4" (4to6) and similarly you can specify an IPv4
51address in combination with "\-6" (6to4).
51.B 52.B
52.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL" 53.IP "\-L LOGLEVEL, \-\-loglevel=LOGLEVEL"
53Use LOGLEVEL for logging. Valid values are DEBUG, INFO, WARNING and ERROR. 54Use LOGLEVEL for logging.
55Valid values are DEBUG, INFO, WARNING and ERROR.
54.B 56.B
55.IP "\-p PEERID, \-\-peer=PEERID" 57.IP "\-p PEERID, \-\-peer=PEERID"
56Name of the peer offering the service to connect to. Cannot be used 58Name of the peer offering the service to connect to.
57in conjunction with "\-i", requires "\-s". 59Cannot be used in conjunction with "\-i", requires "\-s".
58.B 60.B
59.IP "\-s NAME, \-\-service=NAME" 61.IP "\-s NAME, \-\-service=NAME"
60Name of the service running on the target peer. Cannot be used in 62Name of the service running on the target peer.
61conjunction with "\-i", requires "\-p". 63Cannot be used in conjunction with "\-i", requires "\-p".
62.B 64.B
63.IP "\-t, \-\-tcp" 65.IP "\-t, \-\-tcp"
64Service runs TCP. Either "\-t" or "\-u" must be specified when using "\-s". 66Service runs TCP.
67Either "\-t" or "\-u" must be specified when using "\-s".
65.B 68.B
66.IP "\-u, \-\-udp" 69.IP "\-u, \-\-udp"
67Service runs UDP. Either "\-t" or "\-u" must be specified when using "\-s". 70Service runs UDP.
71Either "\-t" or "\-u" must be specified when using "\-s".
68.B 72.B
69.IP "\-V, \-\-verbose" 73.IP "\-V, \-\-verbose"
70Be verbose. 74Be verbose.
71.B 75.B
72.IP "\-v, \-\-version" 76.IP "\-v, \-\-version"
73Print GNUnet version number. 77Print GNUnet version number.
74
75
76.SH BUGS 78.SH BUGS
77Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 79Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
78 80electronic mail to <gnunet\-developers@gnu.org>
79.SH SEE ALSO 81.SH SEE ALSO
80gnunet\-setup(1) 82gnunet\-setup(1)
81The full documentation for 83The full documentation for
diff --git a/doc/man/gnunet-zoneimport.1 b/doc/man/gnunet-zoneimport.1
index 57f5e70e2..0b3f44fff 100644
--- a/doc/man/gnunet-zoneimport.1
+++ b/doc/man/gnunet-zoneimport.1
@@ -75,8 +75,8 @@ $ gnunet\-zoneimport 1.2.3.4 < names.txt
75 75
76 76
77.SH BUGS 77.SH BUGS
78Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic mail to <gnunet\-developers@gnu.org> 78Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
79 79electronic mail to <gnunet\-developers@gnu.org>
80.SH SEE ALSO 80.SH SEE ALSO
81gnunet\-gns(1), gnunet\-namestore(1) 81gnunet\-gns(1), gnunet\-namestore(1)
82The full documentation for 82The full documentation for
diff --git a/doc/man/gnunet.conf.5 b/doc/man/gnunet.conf.5
index ec6a089d7..3aee4ed71 100644
--- a/doc/man/gnunet.conf.5
+++ b/doc/man/gnunet.conf.5
@@ -1,3 +1,4 @@
1.\" -*- mode: nroff -*-
1.TH GNUNET.CONF "5" "26 October 2018" "GNUnet" 2.TH GNUNET.CONF "5" "26 October 2018" "GNUnet"
2.SH NAME 3.SH NAME
3gnunet.conf \- GNUnet configuration file 4gnunet.conf \- GNUnet configuration file
@@ -144,10 +145,10 @@ to the actual external address for your usage.
144.TP 145.TP
145~/.config/gnunet.conf 146~/.config/gnunet.conf
146GNUnet configuration file 147GNUnet configuration file
147.SH "REPORTING BUGS" 148.SH BUGS
148Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending electronic 149Report bugs by using Mantis <https://gnunet.org/bugs/> or by sending
149mail to <bug-gnunet@gnu.org> 150electronic mail to <bug-gnunet@gnu.org>
150.SH "SEE ALSO" 151.SH SEE ALSO
151\fBgnunet\-setup\fP(1), \fBgnunet\-arm\fP(1) 152\fBgnunet\-setup\fP(1), \fBgnunet\-arm\fP(1)
152The full documentation for 153The full documentation for
153.B gnunet 154.B gnunet