X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=README;h=ad43c1f2a5b532766b9250484ff585910b006219;hb=5755db2c4ebd0852ca9db411d632be796c4b849c;hp=ee0af1dcc25d8c971d5dac891b4b917e4d1c8a78;hpb=5f7b5fb33b16a170fde12325150233f1bc014893;p=oweals%2Fgnunet.git diff --git a/README b/README index ee0af1dcc..ad43c1f2a 100644 --- a/README +++ b/README @@ -2,7 +2,7 @@ THIS SVN VERSION OF GNUNET IS INCOMPATIBLE TO ALL PREVIOUS RELEASES. WE ARE WORKING ON CHANGING FUNDAMENTAL PARTS OF THE CRYPTOGRAPHIC -PARTS OF THE SYSTEM. +PARTS OF THE SYSTEM. You need to install libgcrypt from git master (1.6.0beta93 at least) for the code to compile. @@ -20,8 +20,8 @@ primary application for GNUnet is anonymous file-sharing. GNUnet is currently developed by a worldwide group of independent free software developers. GNUnet is a GNU package (http://www.gnu.org/). -This is an ALPHA release. There are known and significant bugs as -well as many missing features in this release. +This is an ALPHA release. There are known and significant bugs as +well as many missing features in this release. Additional documentation about GNUnet can be found at https://gnunet.org/. @@ -40,21 +40,25 @@ packages. Hence please make sure to use the versions listed below. These are the direct dependencies for running GNUnet: - libextractor >= 0.6.1 -- libmicrohttpd >= 0.9.18 +- libmicrohttpd >= 0.9.31 - libgcrypt >= 1.2 - libcurl >= 7.21.3 - libunistring >= 0.9.2 - gnutls >= 2.12.0 - libidn >= 1.0 +- libglpk >= 4.45 +- openssl >= 1.0 (binary, used to generate X.509 certificate) - libltdl >= 2.2 (part of GNU libtool) -- sqlite >= 3.0 (default database) -- mysql >= 5.1 (alternative to sqLite) -- postgres >= 8.3 (alternative to sqLite) +- sqlite >= 3.8 (default database, required) +- mysql >= 5.1 (alternative to sqlite) +- postgres >= 8.3 (alternative to sqlite) +- libopus >= 0.9.14 (optional for experimental conversation tool) +- libpulse >= 2.0 (optional for experimental conversation tool) Recommended autotools for compiling the SVN version are: - autoconf >= 2.59 - automake >= 1.11.1 -- libtool >= 2.2 +- libtool >= 2.2 How to install? @@ -102,7 +106,7 @@ securely and then compile and install GNUnet to $GNUNET_PREFIX/bin/, $GNUNET_PREFIX/lib/ and $GNUNET_PREFIX/share/ and start the system with the default configuration. It is strongly recommended that you add a user "gnunet" to run "gnunet-arm". You can then still run the -end-user applications as another user. +end-user applications as another user. If you create a system user "gnunet", it is recommended that you edit the configuration file slightly so that data can be stored in the @@ -111,15 +115,16 @@ the $HOME-directory of your "gnunet" user is, you might need to set the SERVICEHOME option in section "[PATHS]" to "/var/lib/gnunet" to do this. Depending on your personal preferences, you may also want to use "/etc/gnunet.conf" for the location of the configuration file in -this case (instead of ~gnunet/.gnunet/gnunet.conf"). In this case, -you need to start GNUnet using "gnunet-arm -s -c /etc/gnunet.conf". +this case (instead of ~gnunet/.config/gnunet.conf"). In this case, +you need to start GNUnet using "gnunet-arm -s -c /etc/gnunet.conf" or +set "XDG_CONFIG_HOME=/etc/". You can avoid running 'make install' as root if you run configure with the "--with-sudo=yes" option and have extensive sudo rights (can run "chmod +s" and "chown" via 'sudo'). If you run 'make install' as a normal user without sudo rights (or the configure option), certain binaries that require additional priviledges will not be -installed properly (and autonomous NAT traversal, WLAN, DNS/GNS and +installed properly (and autonomous NAT traversal, WLAN, DNS/GNS and the VPN will then not work). If you run 'configure' and 'make install' as root or use the SUDO @@ -168,7 +173,7 @@ GNUnet uses two types of configuration files, one that specifies the system-wide defaults (typically located in $GNUNET_PREFIX/share/gnunet/config.d/) and a second one that overrides default values with user-specific preferences. The user-specific -configuration file should be located in "~/.gnunet/gnunet.conf" or its +configuration file should be located in "~/.config/gnunet.conf" or its location can be specified by giving the "-c" option to the respective GNUnet application. @@ -221,7 +226,7 @@ together with a description. To publish files on GNUnet, use the The GTK user interface is shipped separately. After downloading and -installing gnunet-gtk, you can invoke the setup tool and the +installing gnunet-gtk, you can invoke the setup tool and the file-sharing GUI with: $ gnunet-setup @@ -254,9 +259,9 @@ $ export GNUNET_PREFIX=$SOMEWHERE $ make check Some of the testcases require python >= 2.6 and pexpect to be -installed. If any testcases fail to pass on your system, run -"contrib/report.sh" and report the output together with -information about the failing testcase to the Mantis bugtracking +installed. If any testcases fail to pass on your system, run +"contrib/report.sh" and report the output together with +information about the failing testcase to the Mantis bugtracking system at https://gnunet.org/bugs/.