aboutsummaryrefslogtreecommitdiff
path: root/doc/man/gnunet.conf.5.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/gnunet.conf.5.in')
-rw-r--r--doc/man/gnunet.conf.5.in656
1 files changed, 632 insertions, 24 deletions
diff --git a/doc/man/gnunet.conf.5.in b/doc/man/gnunet.conf.5.in
index 2d140df97..69f9c59da 100644
--- a/doc/man/gnunet.conf.5.in
+++ b/doc/man/gnunet.conf.5.in
@@ -1,5 +1,5 @@
1.\" -*- mode: nroff -*- 1.\" -*- mode: nroff -*-
2.\" This file is part of Ascension. 2.\" This file is part of GNUnet.
3.\" Copyright (C) 2012-2015,2018,2019 GNUnet e.V. 3.\" Copyright (C) 2012-2015,2018,2019 GNUnet e.V.
4.\" 4.\"
5.\" Permission is granted to copy, distribute and/or modify this document 5.\" Permission is granted to copy, distribute and/or modify this document
@@ -32,25 +32,41 @@ GNUnet configuration file
32.Sh DESCRIPTION 32.Sh DESCRIPTION
33A GNUnet setup typically consists of a set of service processes run by a user "gnunet" and a set of user-interface processes run by a standard account. 33A GNUnet setup typically consists of a set of service processes run by a user "gnunet" and a set of user-interface processes run by a standard account.
34The default location for the configuration file for the services is 34The default location for the configuration file for the services is
35.Pa ~gnunet/.config/gnunet.conf Ns ; 35.Pa ~gnunet/.config/gnunet.conf Ns .
36however, as normal users also may need read-access to this configuration, you might want to instead put the service process configuration in 36However, as normal users also may need read-access to this configuration, you might want to instead put the service process configuration in
37.Pa @SYSCONFDIR@/gnunet.conf Ns . 37.Pa @SYSCONFDIR@/gnunet.conf Ns .
38gnunet-setup (part of gnunet-gtk) can be used to edit this configuration. 38.Xr gnunet-setup 1 ,
39part of gnunet-gtk, can be used to edit this configuration.
39The parts of GNUnet that are run as a normal user may have config options too and they read from 40The parts of GNUnet that are run as a normal user may have config options too and they read from
40.Pa $HOME/.config/gnunet.conf Ns . 41.Pa $HOME/.config/gnunet.conf Ns .
41The latter config file can skip any options for the services. 42The latter config file can skip any options for the services.
42.Pp 43.Pp
43The basic structure of the configuration file is the following. 44The basic structure of the configuration file is the following.
45.Bl -bullet -offset indent -compact
46.It
44The file is split into sections. 47The file is split into sections.
45Every section begins with "[SECTIONNAME]" and contains a number of options of the form "OPTION=VALUE". 48.It
49Every section begins with "[SECTIONNAME]".
50A section contains a number of options of the form "OPTION=VALUE".
51.It
46Empty lines and lines beginning with a "#" are treated as comments. 52Empty lines and lines beginning with a "#" are treated as comments.
47Almost all options are optional and the tools resort to reasonable defaults if they are not present. 53.It
54Almost all options are optional.
55The tools resort to reasonable defaults if an option is not present.
56.El
48.Pp 57.Pp
49Default values for all of the options can be found in the files in the 58Default values for all of the options can be found in the files in the
50.Pa $GNUNET_PREFIX/share/gnunet/config.d/ 59.Pa $GNUNET_PREFIX/share/gnunet/config.d/
51directory. 60directory.
52A typical setup will work out of the box with those. 61A typical setup will work out of the box with those.
53See the examples section below for some common setups on top of that. 62See the examples section below for some common setups on top of that.
63.Ss Variable naming conventions and data types
64Boolean values for options are set via "YES" or "NO" values, without the double-quotes.
65.sp
66Options which include "PATH" or "path" define a path on the file-system and can take additional variables in the path, such as
67.Ev $GNUNET_TMP .
68.sp
69Section names as listed more in detail below, are small letters only enclosed by square brakets.
54.Ss GENERAL OPTIONS 70.Ss GENERAL OPTIONS
55Many options will be common between sections. 71Many options will be common between sections.
56They can be repeated under each section with different values. 72They can be repeated under each section with different values.
@@ -61,12 +77,24 @@ The main use of this is to redefine "$GNUNET_HOME", which by default points to
61.Pa $HOME/.config/ Ns . 77.Pa $HOME/.config/ Ns .
62By setting this variable, you can change the location where GNUnet stores its internal data. 78By setting this variable, you can change the location where GNUnet stores its internal data.
63.Pa gnunet.conf 79.Pa gnunet.conf
64accepts the variable "GNUNET_TMP" which we suggest to use in place of the absolute definition of 80accepts the variable
81.Ev GNUNET_TMP
82which we suggest to use in place of the absolute definition of
65.Pa /tmp Ns . 83.Pa /tmp Ns .
66So instead of 84So instead of
67.Pa /tmp/foo 85.Pa /tmp/foo
68you would write "$GNUNET_TMP/foo". 86you would write
69The usage of "$GNUNET_TMP/foo", will result in "$TMPDIR/gnunet/foo", or "$TMP/gnunet/foo" and finally, if "TMPDIR" is undefined, "/tmp/gnunet/foo". 87.Pa $GNUNET_TMP/foo .
88The usage of
89.Pa $GNUNET_TMP/foo ,
90will result in
91.Pa $TMPDIR/gnunet/foo ,
92or
93.Pa $TMP/gnunet/foo
94and finally, if
95.Ev TMPDIR
96is undefined,
97.Pa /tmp/gnunet/foo .
70The following options are generic and shared by all services: 98The following options are generic and shared by all services:
71.Bl -tag -width Ds 99.Bl -tag -width Ds
72.It HOSTNAME 100.It HOSTNAME
@@ -102,41 +130,613 @@ If UNIX domain sockets are used, set this to YES if only users with the same UID
102.It UNIX_MATCH_GID 130.It UNIX_MATCH_GID
103If UNIX domain sockets are used, set this to YES if only users with the same GID are allowed to access the service. 131If UNIX domain sockets are used, set this to YES if only users with the same GID are allowed to access the service.
104.It RUN_PER_USER 132.It RUN_PER_USER
105Set to YES if this service should be run per-user, NO if this is a system service.
106End-users should never have to change the defaults GNUnet provides for this option. 133End-users should never have to change the defaults GNUnet provides for this option.
134.Bl -tag -width Ds
135.It YES
136Set to YES if this service should be run per-user.
137.It NO
138Set to NO if this is a system service.
139.El
140.El
141In the following sections the absence of a default value is either expressed as "Default value:" followed by nothing, or the lack of this line.
142.Ss ARM
143.Bl -tag -width Ds
144.It PORT
145Default value: 2087
146.It HOSTNAME
147Default value: localhost
148.It BINARY
149Default value: gnunet-service-arm
150.It ACCEPT_FROM
151Default value: 127.0.0.1;
152.It ACCEPT_FROM6
153Default value: ::1;
154.It UNIXPATH
155Special case, uses user runtime dir even for per-system service.
156.sp
157Default value: $GNUNET_USER_RUNTIME_DIR/gnunet-service-arm.sock
158.It UNIX_MATCH_UID
159Default value: YES
160.It UNIX_MATCH_GID
161Default value: YES
162.It GLOBAL_POSTFIX
163In the
164.Fl l
165option, format characters from
166.Xr strftime 3
167are allowed; In the GLOBAL_POSTFIX, "{}" stands for the name of the respective service.
168Thus the following example for this option would introduce per-service logging with a new log file each day.
169Note that only the last 3 log files are preserved.
170Example: -l $GNUNET_CACHE_HOME/{}-%Y-%m-%d.log
171.sp
172Default value:
173.It GLOBAL_PREFIX
174Default value:
175.It START_SYSTEM_SERVICES
176If set to YES, ARM will only start services that are marked as system-level services (and we'll expect a second ARM to be run per-user to run user-level services).
177Note that in this case you must have manually created a different configuration file with the user where at least this and the START_USER_SERVICES options differ.
178.It START_USER_SERVICES
179If set to YES, ARM will only start services that are marked as per-user services (and we'll expect a system user to run ARM to provide system-level services).
180Per-user services enable better personalization and priviledge separation and in particular ensures that personal data is stored under $HOME, which might be important in a multi-user system (or if $HOME is encrypted and /var/ is not).
181.sp
182Note that if you have different ARM services for SYSTEM and USER, and you are not on UNIX, you need to change the PORT option for the USER ARM instances to some free port (counting down from 2085 should provide free ports).
183.It RESOURCE_DIAGNOSTICS
184File where we should log per-service resource consumption on exit.
185.sp
186Default value: resource.log
187.It USERNAME
188Name of the user that will be used to provide the service.
189.sp
190Default value:
191.It MAXBUF
192Default value:
193.It TIMEOUT
194Default value:
195.It DISABLEV6
196Default value:
197.It BINDTO
198Default value:
199.It REJECT_FROM
200Default value:
201.It REJECT_FROM6
202Default value:
203.It PREFIX
204Default value:
107.El 205.El
108.Ss ATS OPTIONS 206.Ss ATS
109.Bl -tag -width Ds 207.Bl -tag -width Ds
208.It PORT
209Default value: 2098
210.It HOSTNAME
211Default value: localhost
212.It BINARY
213Default value: gnunet-service-ats
214.It ACCEPT_FROM
215Default value: 127.0.0.1;
216.It ACCEPT_FROM6
217Default value: ::1;
218.It UNIXPATH
219Default value: $GNUNET_RUNTIME_DIR/gnunet-service-ats.sock
220.It UNIX_MATCH_UID
221Default value: NO
222.It UNIX_MATCH_GID
223Default value: YES
224.It MODE
225Designated assignment mode.
226Possible values: PROPORTIONAL, MLP, RIL.
227.sp
228Default value: proportional
110.It UNSPECIFIED_QUOTA_IN 229.It UNSPECIFIED_QUOTA_IN
111quotes in KiB or MiB per seconds. 230quotes in KiB or MiB per seconds.
112Or use the word "unlimited" 231Or use the word "unlimited".
232Default value: 64 KiB
113.It UNSPECIFIED_QUOTA_OUT 233.It UNSPECIFIED_QUOTA_OUT
114quotes in KiB or MiB per seconds. 234quotes in KiB or MiB per seconds.
115Or use the word "unlimited" 235Or use the word "unlimited".
236Default value: 64 KiB
116.It LOOPBACK_QUOTA_IN 237.It LOOPBACK_QUOTA_IN
117quotes in KiB or MiB per seconds. 238quotes in KiB or MiB per seconds.
118Or use the word "unlimited" 239Or use the word "unlimited".
240Default value: unlimited
119.It LOOPBACK_QUOTA_OUT 241.It LOOPBACK_QUOTA_OUT
120quotes in KiB or MiB per seconds. 242quotes in KiB or MiB per seconds.
121Or use the word "unlimited" 243Or use the word "unlimited".
244Default value: unlimited
122.It LAN_QUOTA_IN 245.It LAN_QUOTA_IN
123quotes in KiB or MiB per seconds. 246quotes in KiB or MiB per seconds.
124Or use the word "unlimited" 247Or use the word "unlimited".
248Default value: unlimited
125.It LAN_QUOTA_OUT 249.It LAN_QUOTA_OUT
126quotes in KiB or MiB per seconds. 250quotes in KiB or MiB per seconds.
127Or use the word "unlimited" 251Or use the word "unlimited".
252Default value: unlimited
128.It WAN_QUOTA_IN 253.It WAN_QUOTA_IN
129quotes in KiB or MiB per seconds. 254quotes in KiB or MiB per seconds.
130Or use the word "unlimited" 255Or use the word "unlimited".
256Default value: 64 KiB
131.It WAN_QUOTA_OUT 257.It WAN_QUOTA_OUT
132quotes in KiB or MiB per seconds. 258quotes in KiB or MiB per seconds.
133Or use the word "unlimited" 259Or use the word "unlimited".
260Default value: 64 KiB
134.It WLAN_QUOTA_IN 261.It WLAN_QUOTA_IN
135quotes in KiB or MiB per seconds. 262quotes in KiB or MiB per seconds.
136Or use the word "unlimited" 263Or use the word "unlimited".
264Default value: 1 MiB
137.It WLAN_QUOTA_OUT 265.It WLAN_QUOTA_OUT
138quotes in KiB or MiB per seconds. 266quotes in KiB or MiB per seconds.
139Or use the word "unlimited" 267Or use the word "unlimited".
268Default value: 1 MiB
269.It BLUETOOTH_QUOTA_IN
270Default value: 128 KiB
271.It BLUETOOTH_QUOTA_OUT
272Default value: 128 KiB
273.It PROP_PROPORTIONALITY_FACTOR
274How proportional to preferences is bandwidth distribution in a network?
275Default value: 2.00
276.Bl -tag -width Ds
277.It 1.0
278Fair with respect to addresses without preferences.
279.It > 1.0
280The bigger, the more respect is payed to preferences.
281.El
282.It PROP_STABILITY_FACTOR
283Should we stick to existing connections are prefer to switch?
284[1.0...2.0], lower value prefers to switch, bigger value is more tolerant.
285.sp
286Default value: 1.25
287.It MLP_MAX_DURATION
288Maximum duration for a solution process (both LP and MILP).
289Default value: 3 s
290.It MLP_MAX_ITERATIONS
291Maximum numbero of iterations for a solution process (only LP).
292Tolerated MIP Gap [0.0 .. 1.0].
293.sp
294Default value: 0.025
295.It MLP_MAX_MIP_GAP
296Tolerated LP/MIP Gap [0.0 .. 1.0].
297.sp
298Default value: 0.025
299.It MLP_MAX_LP_MIP_GAP
300Default value: 0.025
301.It MLP_MAX_ITERATIONS
302Maximum number of iterations for a solution process.
303.sp
304Default value: 1024
305.It MLP_COEFFICIENT_D
306Default value: 1.0
307.It MLP_COEFFICIENT_U
308Default value: 1.0
309.It MLP_COEFFICIENT_R
310Default value: 1.0
311.It MLP_MIN_BANDWIDTH
312Default value: 1024
313.It MLP_MIN_CONNECTIONS
314Default value: 4
315.It MLP_DUMP_PROBLEM_ALL
316Dump all problems to disk.
317.sp
318Default value: YES
319.It MLP_DUMP_SOLUTION_ALL
320Dump all solution to disk.
321.sp
322Default value: YES
323.It MLP_GLPK_VERBOSE
324Print GLPK output.
325.sp
326Default value: YES
327.It MLP_DUMP_PROBLEM_ON_FAIL
328Dump all problems to disk.
329.sp
330Default value: YES
331.It MLP_DUMP_SOLUTION_ON_FAIL
332Dump all solution to disk.
333.sp
334Default value: YES
335.It RIL_STEP_TIME_MIN
336Default value: 500 ms
337.It RIL_STEP_TIME_MAX
338Default value: 1000 ms
339.It RIL_ALGORITHM
340Possible values: SARSA or Q-LEARNING.
341.sp
342Default value: Q-LEARNING
343.It RIL_DISCOUNT_BETA
344Default value: 0.7
345.It RIL_GRADIENT_STEP_SIZE
346Default value: 0.3
347.It RIL_TRACE_DECAY
348Default value: 0.2
349.It RIL_EXPLORE_RATIO
350Default value: 0.1
351.It RIL_GLOBAL_REWARD_SHARE
352Default value: 1
353.El
354.Ss AUCTION
355.Bl -tag -width Ds
356.El
357.Ss CADET
358.Bl -tag -width Ds
359.It IMMEDIATE_START
360Default value: YES
361.It START_ON_DEMAND
362Default value: YES
363.It PORT
364Default value: 2096
365.It HOSTNAME
366Default value: localhost
367.It BINARY
368Default value: gnunet-service-cadet
369.It PREFIX
370.It ACCEPT_FROM
371Default value: 127.0.0.1;
372.It ACCEPT_FROM6
373Default value: ::1;
374.It UNIXPATH
375Default value: $GNUNET_RUNTIME_DIR/gnunet-service-cadet.sock
376.It UNIX_MATCH_UID
377Default value: NO
378.It UNIX_MATCH_GID
379Default value: YES
380.It REFRESH_CONNECTION_TIME
381How often do we send KEEPALIVE messages on connections to keep them from timing out?
382.sp
383Default value: 5 min
384.It DROP_PERCENT
385Percentage of packets CADET is artificially dropping.
386Used for testing only!
387.It ID_ANNOUNCE_TIME
388How frequently do we usually anounce our presence in the DHT?
389.sp
390Default value: 1 h
391.It CONNECT_TIMEOUT
392Default value: 30 s
393.It DHT_REPLICATION_LEVEL
394What is the replication level we give to the DHT when announcing our existence?
395Usually there is no need to change this.
396.sp
397Default value: 3
398.It MAX_TUNNELS
399Not implemented
400.sp
401Default value: 1000
402.It MAX_CONNECTIONS
403Not implemented, replaced by MAX_ROUTES in NEW CADET!
404.sp
405Default value: 1000
406.It MAX_ROUTES
407How many routes do we participate in at most?
408Should be smaller than MAX_MSGS_QUEUE.
409.sp
410Default value: 5000
411.It MAX_MSGS_QUEUE
412Not implemented
413.sp
414Default value: 10000
415.It MAX_PEERS
416Not implemented
417.sp
418Default value: 1000
419.It RATCHET_TIME
420How often do we advance the ratchet even if there is not any traffic?
421.sp
422Default value: 1 h
423.It RATCHET_MESSAGES
424How often do we advance the ratched if there is traffic?
425.sp
426Default value: 64
427.El
428.Ss COMMUNICATOR-UNIX
429.Bl -tag -width Ds
430.It UNIXPATH
431Default value: $GNUNET_RUNTIME_DIR/gnunet-communicator-unix.sock
432.El
433.Ss CONSENSUS
434.Bl -tag -width Ds
435.It START_ON_DEMAND
436Default value: YES
437.It PORT
438Default value: 2103
439.It HOSTNAME
440Default value: localhost
441.It BINARY
442Default value: gnunet-service-consensus
443.It ACCEPT_FROM
444Default value: 127.0.0.1;
445.It ACCEPT_FROM6
446Default value: ::1;
447.It UNIXPATH
448Default value: $GNUNET_RUNTIME_DIR/gnunet-service-consensus.sock
449.It UNIX_MATCH_UID
450Default value: YES
451.It UNIX_MATCH_GID
452Default value: YES
453.El
454.Ss CORE
455.Bl -tag -width Ds
456.It START_ON_DEMAND
457Default value: YES
458.It PORT
459Default value: 2092
460.It HOSTNAME
461Default value: localhost
462.It BINARY
463Default value: gnunet-service-core
464.It ACCEPT_FROM
465Default value: 127.0.0.1;
466.It ACCEPT_FROM6
467Default value: ::1;
468.It UNIXPATH
469Default value: $GNUNET_RUNTIME_DIR/gnunet-service-core.sock
470.It UNIX_MATCH_UID
471Default value: NO
472.It UNIX_MATCH_GID
473Default value: YES
474.It DISABLE_SOCKET_FORWARDING
475Default value: NO
476.It USERNAME
477.It MAXBUF
478.It TIMEOUT
479.It DISABLEV6
480.It BINDTO
481.It REJECT_FROM
482.It REJECT_FROM6
483.It PREFIX
484.It USE_EPHEMERAL_KEYS
485Default value: YES
486.sp
487This MUST be set to YES in production, only set to NO for testing for performance (testbed/cluster-scale use!).
488.El
489.Ss DATACACHE-POSTGRES
490.Bl -tag -width Ds
491.It CONFIG
492Default value: postgres:///gnunet
493.El
494.Ss DATASTORE
495.Bl -tag -width Ds
496.It START_ON_DEMAND
497Default value: YES
498.It UNIXPATH
499Default value: $GNUNET_RUNTIME_DIR/gnunet-service-datastore.sock
500.It UNIX_MATCH_UID
501Default value: NO
502.It UNIX_MATCH_GID
503Default value: YES
504.It PORT
505Default value: 2093
506.It HOSTNAME
507Default value: localhost
508.It BINARY
509Default value: gnunet-service-datastore
510.It ACCEPT_FROM
511Default value: 127.0.0.1;
512.It ACCEPT_FROM6
513Default value: ::1;
514.It QUOTA
515Default value: 5 GB
516.It BLOOMFILTER
517Default value: $GNUNET_DATA_HOME/datastore/bloomfilter
518.It DATABASE
519Default value: sqlite
520.It DISABLE_SOCKET_FORWARDING
521Default value: NO
522.El
523.Ss DATASTORE-SQLITE
524.Bl -tag -width Ds
525.It FILENAME
526Default value: $GNUNET_DATA_HOME/datastore/sqlite.db
527.El
528.Ss DATASTORE-POSTGRES
529.Bl -tag -width Ds
530.It CONFIG
531Default value: postgres:///gnunet
532.El
533.Ss DATASTORE-MYSQL
534.Bl -tag -width Ds
535.It DATABASE
536Default value: gnunet
537.It CONFIG
538Default value: ~/.my.cnf
539.It USER
540Default value: gnunet
541.It PASSWORD
542.It HOST
543Default value: localhost
544.It PORT
545Default value: 3306
546.El
547.Ss DATASTORE-HEAP
548.Bl -tag -width Ds
549.It HASHMAPSIZE
550Default value: 1024
551.El
552.Ss DHT
553.Bl -tag -width Ds
554.El
555.Ss EXIT
556.Bl -tag -width Ds
557.El
558.Ss FS
559.Bl -tag -width Ds
560.El
561.Ss GNS
562.Bl -tag -width Ds
563.El
564.Ss HOSTLIST
565.Bl -tag -width Ds
566.El
567.Ss IDENTITY
568.Bl -tag -width Ds
569.El
570.Ss NAMECACHE
571.Bl -tag -width Ds
572.El
573.Ss NAMESTORE
574.Bl -tag -width Ds
575.El
576.Ss NAT-AUTO
577.Bl -tag -width Ds
578.El
579.Ss NAT
580.Bl -tag -width Ds
581.El
582.Ss NSE
583.Bl -tag -width Ds
584.El
585.Ss PEERINFO
586.Bl -tag -width Ds
587.El
588.Ss PEERSTORE
589.Bl -tag -width Ds
590.El
591.Ss PT
592.Bl -tag -width Ds
593.El
594.Ss REGEX
595.Bl -tag -width Ds
596.El
597.Ss RESOLVER
598.Bl -tag -width Ds
599.El
600.Ss REST
601.Bl -tag -width Ds
602.It UNIXPATH
603Default value: $GNUNET_USER_RUNTIME_DIR/gnunet-service-rest.sock
604.It BINARY
605Default value: gnunet-rest-server
606.It BIND_TO
607Default value: 127.0.0.1
608.It BIND_TO6
609Default value: ::1
610.It REST_PORT
611Default value: 7776
612.It REST_ALLOW_HEADERS
613Default value: Authorization,Accept,Content-Type
614.It REST_ALLOW_ORIGIN
615Default value: *
616.It REST_ALLOW_CREDENTIALS
617Default value: true
618.El
619.Ss REVOCATION
620.Ss SCALARPRODUCT
621.Ss SECRETSHARING
622.Ss SET
623.Ss STATISTICS
624.Ss TEMPLATE
625.Ss TESTBED-LOGGER
626.Ss TESTBED
627.Ss TESTING
628.Ss TOPOLOGY
629.Bl -tag -width Ds
630.It IMMEDIATE_START
631Default value: YES
632.It NOARMBIND
633Default value: YES
634.It MINIMUM-FRIENDS
635Default value: 0
636.It FRIENDS-ONLY
637Default value: NO
638.It TARGET-CONNECTION-COUNT
639Default value: 16
640.It FRIENDS
641Default value: $GNUNET_CONFIG_HOME/topology/friends.txt
642.It BINARY
643Default value: gnunet-daemon-topology
644.El
645.Ss TRANSPORT
646.Ss UTIL
647.Ss VPN
648.Bl -tag -width Ds
649.It START_ON_DEMAND
650Default value: YES
651.It PORT
652Default value: 2105
653.It HOSTNAME
654Default value: localhost
655.It BINARY
656Default value: gnunet-service-vpn
657.It ACCEPT_FROM
658Default value: 127.0.0.1;
659.It ACCEPT_FROM6
660Default value: ::1;
661.It UNIXPATH
662Default value: $GNUNET_RUNTIME_DIR/gnunet-service-vpn.sock
663.It UNIX_MATCH_UID
664Default value: NO
665.It UNIX_MATCH_GID
666Default value: YES
667.It IPV6ADDR
668Default value: 1234::1
669.It IPV6PREFIX
670Default value: 32
671.It IPV4ADDR
672Default value: 10.11.10.1
673.It IPV4MASK
674Default value: 255.255.0.0
675.It VIRTDNS
676Default value: 10.11.10.2
677.It VIRTDNS6
678Default value: 1234::17
679.It IFNAME
680Default value: vpn-gnunet
681.El
682.Ss ZONEMASTER
683.Bl -tag -width Ds
684.It START_ON_DEMAND
685Default value: YES
686.It IMMEDIATE_START
687Default value: YES
688.It HOSTNAME
689Default value: localhost
690.It BINARY
691Default value: gnunet-service-zonemaster
692.It UNIXPATH
693Default value: $GNUNET_USER_RUNTIME_DIR/gnunet-service-zonemaster.sock
694.It PORT
695Default value: 2123
696.It UNIX_MATCH_UID
697Do we require users that want to access GNS to run this process (usually not a good idea)?
698.sp
699Default value: NO
700.It UNIX_MATCH_GID
701Do we require users that want to access GNS to be in the 'gnunet' group?
702.sp
703Default value: NO
704.It MAX_PARALLEL_BACKGROUND_QUERIES
705How many queries is GNS allowed to perform in the background at the same time?
706.sp
707Default value: 1000
708.It ZONE_PUBLISH_TIME_WINDOW
709How frequently do we try to publish our full zone?
710.sp
711Default value: 4 h
712.It USE_CACHE
713Using caching or always ask DHT?
714.sp
715Default value: YES
716.It PREFIX
717.El
718.Ss ZONEMASTER-MONITOR
719.Bl -tag -width Ds
720.It START_ON_DEMAND
721Default value: YES
722.It IMMEDIATE_START
723Default value: YES
724.It HOSTNAME
725Default value: localhost
726.It BINARY
727Default value: gnunet-service-zonemaster-monitor
728.It UNIXPATH
729Default value: $GNUNET_USER_RUNTIME_DIR/gnunet-service-zonemaster-monitor.sock
730.It PORT
731Default value: 2124
732.It UNIX_MATCH_UID
733Do we require users that want to access GNS to run this process (usually not a good idea)?
734.sp
735Default value: NO
736.It UNIX_MATCH_GID
737Do we require users that want to access GNS to be in the 'gnunet' group?
738.sp
739Default value: NO
140.El 740.El
141.Sh EXAMPLES 741.Sh EXAMPLES
142This example is a simple way to get started, using a server that has a known list of peers to get you started. 742This example is a simple way to get started, using a server that has a known list of peers to get you started.
@@ -157,11 +757,19 @@ Please remember to change your IP address to the actual external address for you
157 START_USER_SERVICES = NO 757 START_USER_SERVICES = NO
158.Ed 758.Ed
159.Sh FILES 759.Sh FILES
160.Pa ~/.config/gnunet.conf 760.Pa ~gnunet/.config/gnunet.conf
161GNUnet configuration file 761GNUnet syste-user configuration file
762.Pa $HOME/.config/gnunet.conf
763User specific GNUnet configuration file
764.Pa @SYSCONFDIR@/gnunet.conf
765Systemwide GNUnet configuration file
766.Pa $GNUNET_PREFIX/share/gnunet/config.d/
767GNUnet configuration directory with all default option values
162.Sh SEE ALSO 768.Sh SEE ALSO
769.Xr env 1 ,
163.Xr gnunet-arm 1 , 770.Xr gnunet-arm 1 ,
164.Xr gnunet-setup 1 771.Xr gnunet-setup 1 ,
772.Xr strftime 3
165.sp 773.sp
166The full documentation for gnunet is maintained as a Texinfo manual. 774The full documentation for gnunet is maintained as a Texinfo manual.
167If the 775If the