path: root/doc
diff options
authorChristian Grothoff <>2012-10-29 09:08:43 +0000
committerChristian Grothoff <>2012-10-29 09:08:43 +0000
commit68df8985a5865ca0ff238403ccdea644d3925df3 (patch)
tree0d9ca4319671c6ebd6bea3d9b71aec476d147257 /doc
parent5adb26f40e80ead79d64dee3c69904fcf8056214 (diff)
-man page for configuration file
Diffstat (limited to 'doc')
2 files changed, 21 insertions, 0 deletions
diff --git a/doc/man/ b/doc/man/
index 3bcea3213..51d915689 100644
--- a/doc/man/
+++ b/doc/man/
@@ -1,4 +1,5 @@
man_MANS = \
+ gnunet.conf.5 \
gnunet-arm.1 \
gnunet-auto-share.1 \
gnunet-config.1 \
diff --git a/doc/man/gnunet.conf.5 b/doc/man/gnunet.conf.5
new file mode 100644
index 000000000..0d2f868e7
--- /dev/null
+++ b/doc/man/gnunet.conf.5
@@ -0,0 +1,20 @@
+.TH GNUNET.CONF "5" "25 Oct 2012" "GNUnet"
+gnunet.conf \- GNUnet configuration file
+A GNUnet setup typically consists of a a set of service processes run by a user "gnunet" and a set of user-interface processes run by a standard account. The service processes are usually started using "gnunet\-arm \-s". The default location for the configuration file is then "~gnunet/.gnunet/gnunet.conf"; however, as normal users also may need read-access to this configuration, you might want to instead put the service process configuration to "/etc/gnunet.conf". gnunet\-setup can be used to edit this configuration. The configuration for normal users is in "$HOME/.gnunet/gnunet.conf". The file does not have to exist, and there are no options that typically require manual configuration in this file. Note that while it is possible to run both sets of processes as the same user (and use one shared configuration file), this breaks some GNUnet components (GADS/GNS) and is generally not recommended.
+The basic structure of the configuration file is the following. The file is split into sections. Every section begins with "[SECTIONNAME]" and contains a number of options of the form "OPTION=VALUE". Empty lines and lines beginning with a "#" are treated as comments. Almost all options are optional and the tools resort to reasonable defaults if they are not present.
+Default values for all of the options can be found in the files in the "$GNUNET_PREFIX/share/gnunet/config.d/" directory. Note that only some of the options can be configured with gnunet\-setup, as for most options the default choice is all that should ever be needed by normal users. However, developers may find some of the other options of interest.
+GNUnet configuration file
+Report bugs by using Mantis <> or by sending electronic mail to <>
+\fBgnunet\-setup\fP(1), \fBgnunet\-arm\fP(1)