View Issue Details

IDProjectCategoryView StatusLast Update
0003015GNUnetdocumentationpublic2013-12-24 20:54
Reporternilclass Assigned ToMatthias Wachs  
PrioritynormalSeverityminorReproducibilityN/A
Status closedResolutionfixed 
Product VersionGit master 
Target Version0.10.0Fixed in Version0.10.0 
Summary0003015: corrected grammar mistakes in "configuration-hostlist"
DescriptionI've noticed a few grammar mistakes in the "configuration-hostlist" part of the documentation: https://gnunet.org/configuration-hostlist

I couldn't find a way to submit a new revision to that document, so I'm using (hopefully not abusing) this bugtracker to submit it.
The corrected version is in the "Additional Information" section of this report.
Additional InformationAfter installing the software you need to get connected to the GNUnet network. The configuration file included in your download is already configured to connect you to the GNUnet network. In this section the relevant configuration settings are explained.

To get an initial connection to the GNUnet network and to get to know peers already connected to the network you can use the so called bootstrap servers. These servers can give you a list of peers connected to the network. To use these bootstrap servers you have to configure the hostlist daemon to activate bootstrapping.

To activate bootstrapping edit your configuration file and edit the [hostlist]-section. You have to set the argument "-b" in the options line:

[hostlist]
OPTIONS = -b

Additionally you have to specify which server you want to use. The default bootstrapping server is "http://v9.gnunet.org:58080/". To set the server you have to edit the line "SERVERS" in the hostlist section. To use the default server you should set the line to

SERVERS = http://v9.gnunet.org:58080/

To use bootstrapping your configuration file should include these lines:

[hostlist]
OPTIONS = -b
SERVERS = http://v9.gnunet.org:58080/

Besides using bootstrap servers you can configure your GNUnet peer to recieve hostlist advertisements. Peers offering hostlists to other peers can send advertisement messages to peers that connect to them. If you configure your peer to receive these messages, your peer can download these lists and connect to the peers included. These lists are persistent, which means that they are saved to your hard disk regularly and are loaded during startup.

To activate hostlist learning you have to add the "-e" switch to the OPTIONS line in the hostlist section:

[hostlist]
OPTIONS = -b -e

Furthermore you can specify in which file the lists are saved. To save the lists in the file "hostlists.file" just add the line:

HOSTLISTFILE = hostlists.file

Best practice is to activate both bootstrapping and hostlist learning. So your configuration file should include these lines:

[hostlist]
OPTIONS = -b -e
SERVERS = http://v9.gnunet.org:58080/
HOSTLISTFILE = $SERVICEHOME/hostlists.file
TagsNo tags attached.

Activities

Matthias Wachs

2013-09-05 15:24

reporter   ~0007407

Updated documentation and added new hostlist server address and port option

Matthias Wachs

2013-09-05 15:24

reporter   ~0007408

Thx for the fixes...

Issue History

Date Modified Username Field Change
2013-09-02 19:00 nilclass New Issue
2013-09-02 23:12 Christian Grothoff Assigned To => Matthias Wachs
2013-09-02 23:12 Christian Grothoff Status new => assigned
2013-09-05 15:24 Matthias Wachs Note Added: 0007407
2013-09-05 15:24 Matthias Wachs Note Added: 0007408
2013-09-05 15:24 Matthias Wachs Status assigned => resolved
2013-09-05 15:24 Matthias Wachs Resolution open => fixed
2013-09-05 15:24 Matthias Wachs Additional Information Updated
2013-09-10 00:08 Christian Grothoff Product Version => Git master
2013-09-10 00:08 Christian Grothoff Fixed in Version => 0.10.0
2013-09-10 00:08 Christian Grothoff Target Version => 0.10.0
2013-12-24 20:54 Christian Grothoff Status resolved => closed