diff options
Diffstat (limited to 'users/configuration.rst')
-rw-r--r-- | users/configuration.rst | 49 |
1 files changed, 13 insertions, 36 deletions
diff --git a/users/configuration.rst b/users/configuration.rst index 5d99db0..fcdcf17 100644 --- a/users/configuration.rst +++ b/users/configuration.rst | |||
@@ -340,49 +340,26 @@ exists (!). An alternative name for the \"gnunetdns\" group can be | |||
340 | specified using the ``--with-gnunetdns=GRPNAME`` configure option. | 340 | specified using the ``--with-gnunetdns=GRPNAME`` configure option. |
341 | 341 | ||
342 | 342 | ||
343 | .. _Configuring-the-Friend_002dto_002dFriend-_0028F2F_0029-mode: | 343 | Configuring dropshipped HELLOs to bootstrap |
344 | |||
345 | Configuring the Friend-to-Friend (F2F) mode | ||
346 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 344 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
347 | 345 | ||
348 | GNUnet knows three basic modes of operation: | 346 | GNUnet by default tries to bootstrap using included hellos and a hostlist |
349 | 347 | server. | |
350 | - In standard \"peer-to-peer\" mode, your peer will connect to any | 348 | The HELLOs that GNUnet tries to bootstrap with can be found in the directory |
351 | peer. | 349 | ``$PREFIX/share/gnunet/hellos``. |
352 | 350 | The use of the HELLOs in this folder can be controlled with the configuration | |
353 | - In the pure \"friend-to-friend\" mode, your peer will ONLY connect to | 351 | setting ``USE_INCLUDED_HELLOS`` of the ``peerstore`` service: |
354 | peers from a list of friends specified in the configuration. | ||
355 | |||
356 | - Finally, in mixed mode, GNUnet will only connect to arbitrary peers | ||
357 | if it has at least a specified number of connections to friends. | ||
358 | |||
359 | When configuring any of the F2F (\"friend-to-friend\") modes, you first | ||
360 | need to create a file with the peer identities of your friends. Ask your | ||
361 | friends to run | ||
362 | 352 | ||
363 | .. code-block:: text | 353 | .. code-block:: text |
364 | 354 | ||
365 | $ gnunet-peerinfo -sq | 355 | $ gnunet-config -s peerstore -o USE_INCLUDED_HELLOS |
366 | |||
367 | The resulting output of this command needs to be added to your | ||
368 | ``friends`` file, which is simply a plain text file with one line per | ||
369 | friend with the output from the above command. | ||
370 | |||
371 | You then specify the location of your ``friends`` file in the | ||
372 | ``FRIENDS`` option of the \"topology\" section. | ||
373 | |||
374 | Once you have created the ``friends`` file, you can tell GNUnet to only | ||
375 | connect to your friends by setting the ``FRIENDS-ONLY`` option (again in | ||
376 | the \"topology\" section) to YES. | ||
377 | |||
378 | If you want to run in mixed-mode, set \"FRIENDS-ONLY\" to NO and | ||
379 | configure a minimum number of friends to have (before connecting to | ||
380 | arbitrary peers) under the \"MINIMUM-FRIENDS\" option. | ||
381 | 356 | ||
382 | If you want to operate in normal P2P-only mode, simply set | 357 | Note, however, that once the included HELLOs have been parsed, the ``peerstore`` |
383 | ``MINIMUM-FRIENDS`` to zero and ``FRIENDS_ONLY`` to NO. This is the | 358 | will cache them locally in its databse. To purge included HELLOs in this case, |
384 | default. | 359 | the database will have to be deleted. |
385 | 360 | ||
361 | Unless you want to establish a private network, you should not have to touch | ||
362 | this option. | ||
386 | 363 | ||
387 | .. _Configuring-the-hostlist-to-bootstrap: | 364 | .. _Configuring-the-hostlist-to-bootstrap: |
388 | 365 | ||