[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [gnunet-texinfo] branch master updated (cc13ef6 -> 6abc704)
|
From: |
gnunet |
|
Subject: |
[GNUnet-SVN] [gnunet-texinfo] branch master updated (cc13ef6 -> 6abc704) |
|
Date: |
Wed, 24 May 2017 17:39:41 +0200 |
This is an automated email from the git hooks/post-receive script.
ng0 pushed a change to branch master
in repository gnunet-texinfo.
from cc13ef6 installation.texi: make it more of a chapter structure.
new f933a22 some more warnings eliminated
new ab42da0 it seems like the installation.texi file doesn't produuce
warnings anymore
new 21b1542 user.texi repaired too
new 6abc704 switch from texi2* to makeinfo. Almost bikeshed painting.
The 4 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
Makefile | 4 +-
README | 28 +++++-
installation.texi | 271 +++++++++++++++++++++++++++++++++++++++++++++---------
user.texi | 157 +++++++++++++++++++++++++++----
4 files changed, 395 insertions(+), 65 deletions(-)
diff --git a/Makefile b/Makefile
index f291e9f..17d4465 100644
--- a/Makefile
+++ b/Makefile
@@ -1,8 +1,8 @@
pdf:
- texi2pdf --quiet gnunet.texi
+ makeinfo --pdf --quiet gnunet.texi
html:
- texi2html gnunet.texi
+ makeinfo --html gnunet.texi
info:
makeinfo --no-split gnunet.texi
diff --git a/README b/README
index 0a6353b..33337f5 100644
--- a/README
+++ b/README
@@ -60,4 +60,30 @@ TARGETS
MISC
* [] All images are visible
* [] All images have alt-text in html
-* [] All images have a description in pdf and makeinfo outputs
\ No newline at end of file
+* [] All images have a description in pdf and makeinfo outputs
+
+Misc
+----
+
+Working with this on Guix does not require running make.
+You can simply do:
+
+guix environment --ad-hoc --fallback texinfo texlive
+
+and you are good to go. Well due to the big size of texlive
+we currently have you have to bring some time.
+Okay I lied. You have to bring lots of time.
+
+This is just for pdf. html should just work fine without
+the tex binary, so you can just run:
+
+guix environment --ad-hoc texinfo
+
+and in the environment: makeinfo --html gnunet.texi
+
+You could also run make this way.
+
+The results are not part of your profile, so
+the next time you run guix gc, everything you
+(as applications) had in the envrionment is
+garbage collected.
\ No newline at end of file
diff --git a/installation.texi b/installation.texi
index a3e4a16..d15e78e 100644
--- a/installation.texi
+++ b/installation.texi
@@ -19,10 +19,24 @@ profile ID number included. We will then relax these
restrictions on your
account. We're sorry for this inconvenience; however, few people would want to
read this site if 99% of it was advertisements for bogus websites.
+
+
+
+
+
@menu
-* Dependencies
-* External dependencies
-* Internal dependencies
+* Dependencies::
+* Generic installation instructions::
+* Build instructions for Ubuntu 12.04 using Git::
+* Install the GNUnet-gtk user interface from Subversion::
+* Build Instructions for Microsoft Windows Platforms::
+* Build instructions for Debian 7.5::
+* Installing GNUnet 0.10.1 on Ubuntu 14.04::
+* Installing GNUnet from Git on Ubuntu 14.4::
+* Build instructions for Debian 8::
+* Outdated build instructions for previous revisions::
+* Portable GNUnet::
+* Graphical interface::
@end menu
@node Dependencies
@@ -32,6 +46,13 @@ read this site if 99% of it was advertisements for bogus
websites.
This document lists the various known dependencies for GNUnet 0.10.x.
Suggestions for missing dependencies or wrong version numbers are welcome.
+
+
address@hidden
+* External dependencies::
+* Internal dependencies::
address@hidden menu
+
@node External dependencies
@subsection External dependencies
@c %**end of header
@@ -411,6 +432,20 @@ system, it should have been created during the
installation.
@node Build instructions for Ubuntu 12.04 using Git
@section Build instructions for Ubuntu 12.04 using Git
+
+
+
address@hidden
+* Install the required build tools::
+* Install libgcrypt 1.6 and libgpg-error::
+* Install gnutls with DANE support::
+* Install libgnurl::
+* Install libmicrohttpd from Git::
+* Install libextractor from Git::
+* Install GNUnet dependencies::
+* Build GNUnet::
address@hidden menu
+
@node Install the required build tools
@subsection Install the required build tools
@@ -543,8 +578,19 @@ PostgreSQL @code{$ sudo apt-get install libpq-dev
postgresql}
@end itemize
address@hidden Build GNUnet
+
+
@node Build GNUnet
address@hidden Build GNUnet
+
+
+
address@hidden
+* Configuring the installation path::
+* Configuring the system::
+* Installing components requiring sudo permission::
+* Build::
address@hidden menu
@node Configuring the installation path
@subsubsection Configuring the installation path
@@ -556,8 +602,8 @@ when calling the configure script:@code{ --prefix=DIRECTORY}
$ export PATH=$PATH:DIRECTORY/bin@
}
address@hidden Configuring the system
@node Configuring the system
address@hidden Configuring the system
Please make sure NOW that you have created a user and group 'gnunet'@
and additionally a group 'gnunetdns':@
@@ -581,8 +627,9 @@ permissions. To allow these few components to be installed
use:@
@code{@
$ ./configure --with-sudo}
address@hidden Build
@node Build
address@hidden Build
+
@code{@
$ git clone https://gnunet.org/git/gnunet/@
@@ -600,8 +647,9 @@ After installing it, you need to create an empty
configuration file:@
And finally you can start GNUnet with@
@code{$ gnunet-arm -s}
address@hidden Install the GNUnet-gtk user interface from Subversion
@node Install the GNUnet-gtk user interface from Subversion
address@hidden Install the GNUnet-gtk user interface from Subversion
+
Install depencies:@
@code{$ sudo apt-get install libgtk-3-dev libunique-3.0-dev libgladeui-dev
libqrencode-dev}
@@ -618,16 +666,29 @@ To build GNUnet (with an optional prefix)and execute:@
@node Build Instructions for Microsoft Windows Platforms
@section Build Instructions for Microsoft Windows Platforms
address@hidden Introduction
address@hidden Introduction
+
+
address@hidden
+* Introduction to building on MS Windows::
+* Requirements::
+* Dependencies & Initial Setup::
+* GNUnet Installation::
+* Adjusting Windows for running and testing GNUnet::
+* Building the GNUnet Installer::
+* Using GNUnet with Netbeans on Windows::
address@hidden menu
+
address@hidden Introduction to building on MS Windows
address@hidden Introduction to building on MS Windows
+
This document is a guide to building GNUnet and its dependencies on Windows
platforms. GNUnet development is mostly done under Linux and especially SVN
checkouts may not build out of the box. We regret any inconvenience, and if you
have problems, please report them.
address@hidden Requirements
@node Requirements
address@hidden Requirements
The Howto is based upon a @strong{Windows Server 2008 address@hidden
Installation, @strong{sbuild} and thus a @uref{http://www.mingw.org/wiki/MSYS,
@@ -641,8 +702,9 @@ and later will also work, but
@strong{non-server version can not run a VPN-Exit-Node} as the NAT features
have been removed as of Windows Vista.
address@hidden Dependencies & Initial Setup
@node Dependencies & Initial Setup
address@hidden Dependencies & Initial Setup
+
@itemize @bullet
@@ -767,8 +829,9 @@ The installer script is located in @file{contrib\win} in
the GNUnet source tree.
TODO
address@hidden Build instructions for Debian 7.5
@node Build instructions for Debian 7.5
address@hidden Build instructions for Debian 7.5
+
These are the installation instructions for Debian 7.5. They were tested using
a minimal, fresh Debian 7.5 AMD64 installation without non-free software
@@ -794,6 +857,18 @@ course you will need to install one to use GNUnet's
graphical user interfaces.
Thus, it is suggested that you simply install the desktop environment of your
choice before beginning with the instructions.
+
+
address@hidden
+* Update::
+* Stable? Hah!::
+* Update again::
+* Installing Packages::
+* Installing Dependencies from Source::
+* Installing GNUnet from Source::
+* But wait there is more!::
address@hidden menu
+
@node Update
@subsection Update
@@ -933,8 +1008,9 @@ sources, and finally compiling and installing the
libraries:@
$ make ; sudo make install; cd ..@
@end example
address@hidden Installing GNUnet from Source
@node Installing GNUnet from Source
address@hidden Installing GNUnet from Source
+
For this, simply follow the generic installation instructions from
here.
@@ -1041,8 +1117,8 @@ After installing it, you need to create an empty
configuration file:@
And finally you can start GNUnet with@
@code{$ gnunet-arm -s}
address@hidden Installing GNUnet from Git on Ubuntu 14.4
@node Installing GNUnet from Git on Ubuntu 14.4
address@hidden Installing GNUnet from Git on Ubuntu 14.4
@strong{Install the required build tools:}
@code{@
@@ -1160,6 +1236,15 @@ you might simply already have some of the necessary
packages installed. Thus,
it is suggested that you simply install the desktop environment of your choice
before beginning with the instructions.
+
address@hidden
+* Update Debian::
+* Installing Debian Packages::
+* Installing Dependencies from Source2::
+* Installing GNUnet from Source2::
+* But wait (again) there is more!::
address@hidden menu
+
@node Update Debian
@subsection Update Debian
@@ -1245,6 +1330,20 @@ This chapter contains a collection of outdated, older
installation guides. They
are mostly intended to serve as a starting point for writing up-to-date
instructions and should not be expected to work for GNUnet 0.10.x.
+
address@hidden
+* Build instructions for FreeBSD 8::
+* Basic installation for Mac OS X::
+* Basic Installation for Fedora/PlanetLab nodes running Fedora 12::
+* Basic Installation for Fedora/PlanetLab nodes running Fedora 8 .::
+* Build instructions for Gentoo::
+* Building GLPK for MinGW::
+* Compiling libgnurl for GNUnet cannot find data type for curl_off_t.::
+* GUI build instructions for Ubuntu 12.04 using Subversion::
+* Installation with gnunet-update::
+* Instructions for Microsoft Windows Platforms (Old)::
address@hidden menu
+
@node Build instructions for FreeBSD 8
@subsection Build instructions for FreeBSD 8
@@ -1467,8 +1566,9 @@ Install GNUnet
@end itemize
address@hidden Basic Installation for Fedora/PlanetLab nodes running Fedora 12
@node Basic Installation for Fedora/PlanetLab nodes running Fedora 12
address@hidden Basic Installation for Fedora/PlanetLab nodes running Fedora 12
+
@strong{This documentation is outdated and not valid for GNUnet 0.10.0!}@
@@ -1702,8 +1802,9 @@ libmicrohttpd@
Done!
address@hidden Build instructions for Gentoo
@node Build instructions for Gentoo
address@hidden Build instructions for Gentoo
+
This page describes how to install GNUnet 0.9 on Gentoo.
@@ -1773,8 +1874,8 @@ MinGW does not automatically detect the correct buildtype
so you have to
specify it manually
@end itemize
address@hidden Compiling libgnurl for GNUnet: cannot find data type for
curl_off_t.
address@hidden Compiling libgnurl for GNUnet: cannot find data type for
curl_off_t.
address@hidden Compiling libgnurl for GNUnet cannot find data type for
curl_off_t.
address@hidden Compiling libgnurl for GNUnet cannot find data type for
curl_off_t.
If you have to compile libgnurl from source since the version included in your
distribution is to old you perhaps get an error message while running the
@@ -1938,6 +2039,16 @@ problems arise.
not build out of the box. We regret any inconvenience, and if you have
problems, please report them.
+
+
address@hidden
+* Hardware and OS requirements::
+* Software installation::
+* Building libextractor and GNUnet::
+* Installer::
+* Source::
address@hidden menu
+
@node Hardware and OS requirements
@subsubsection Hardware and OS requirements
@@ -2273,6 +2384,14 @@ Currently this has only been tested on Ubuntu 12.04,
12.10, 13.04, Debian and
CentOS 6, but it should work on almost any GNU/Linux distribution. More
in-detail information can be found in the handbook.
+
+
address@hidden
+* Prerequisites::
+* Download & set up gnunet-update::
+* Install GNUnet::
address@hidden menu
+
@node Prerequisites
@subsubsection Prerequisites
@@ -2312,7 +2431,7 @@ configured and afterwards started by executing@
@code{gnunet-arm -s}
@node Graphical interface
address@hidden Graphical interface
address@hidden Graphical interface
If you also would like to use gnunet-gtk and gnunet-setup (highly recommended
for beginners), do:
@@ -2324,8 +2443,33 @@ sudo ldconfig
@end example
Now you can run @code{gnunet-setup} for easy configuration of your GNUnet peer.
+
address@hidden
+* Configuring your peer::
+* Configuring the Friend-to-Friend (F2F) mode::
+* Configuring the hostlist to bootstrap::
+* Configuration of the HOSTLIST proxy settings::
+* Configuring your peer to provide a hostlist ::
+* Configuring the datastore::
+* Configuring the MySQL database::
+* Reasons for not using MySQL::
+* Setup Instructions::
+* Testing::
+* Performance Tuning::
+* Configuring the Postgres database::
+* Reasons to use Postgres::
+* Reasons not to use Postgres::
+* Manual setup instructions::
+* Testing the setup manually::
+* Configuring the datacache::
+* Configuring the file-sharing service::
+* Configuring logging::
+* Configuring the transport service and plugins::
+* Configuring the wlan transport plugin::
address@hidden menu
+
@node Configuring your peer
address@hidden Configuring your peer
address@hidden Configuring your peer
This chapter will describe the various configuration options in GNUnet.
@@ -2340,7 +2484,7 @@ While you can also configure your peer by editing the
configuration file by
hand, this is not recommended for anyone except for developers.
@node Configuring the Friend-to-Friend (F2F) mode
address@hidden Configuring the Friend-to-Friend (F2F) mode
address@hidden Configuring the Friend-to-Friend (F2F) mode
GNUnet knows three basic modes of operation. In standard "peer-to-peer" mode,
your peer will connect to any peer. In the pure "friend-to-friend" mode, your
@@ -2372,7 +2516,7 @@ If you want to operate in normal P2P-only mode, simply
set "MINIMUM-FRIENDS" to
zero and "FRIENDS_ONLY" to NO. This is the default.
@node Configuring the hostlist to bootstrap
address@hidden Configuring the hostlist to bootstrap
address@hidden Configuring the hostlist to bootstrap
After installing the software you need to get connected to the GNUnet network.
The configuration file included in your download is already configured to
@@ -2444,7 +2588,7 @@ HOSTLISTFILE = $SERVICEHOME/hostlists.file
@end example
@node Configuration of the HOSTLIST proxy settings
address@hidden Configuration of the HOSTLIST proxy settings
address@hidden Configuration of the HOSTLIST proxy settings
The hostlist client can be configured to use a proxy to connect to the hostlist
server. This functionality can be configured in the configuration file directly
@@ -2488,8 +2632,8 @@ following settings in the @code{[hostlist]} section of
the configuration:@
# PROXY_PASSWORD =@
@end example
address@hidden Configuring your peer to provide a hostlist
address@hidden Configuring your peer to provide a hostlist
address@hidden Configuring your peer to provide a hostlist
address@hidden Configuring your peer to provide a hostlist
If you operate a peer permanently connected to GNUnet you can configure your
peer to act as a hostlist server, providing other peers the list of peers known
@@ -2548,7 +2692,7 @@ Advertising without providing a hostlist does not make
sense and will not work.
@end itemize
@node Configuring the datastore
address@hidden Configuring the datastore
address@hidden Configuring the datastore
The datastore is what GNUnet uses to for long-term storage of file-sharing
data. Note that long-term does not mean 'forever' since content does have an
@@ -2563,7 +2707,7 @@ datastore, you need to specify which database GNUnet
should use to do so.
Currently, you have the choice between sqLite, MySQL and Postgres.
@node Configuring the MySQL database
address@hidden Configuring the MySQL database
address@hidden Configuring the MySQL database
This section describes how to setup the MySQL database for GNUnet.
@@ -2595,7 +2739,7 @@ Complex manual setup
@end itemize
@node Setup Instructions
address@hidden Setup Instructions
address@hidden Setup Instructions
@itemize @bullet
@@ -2637,7 +2781,7 @@ password=$the_password_you_like
Luckily $USER has only priviledges to mess up GNUnet's tables, which should be
pretty harmless.
@node Testing
address@hidden Testing
address@hidden Testing
You should briefly try if the database connection works. First, login as $USER.
Then use:
@@ -2654,7 +2798,7 @@ If you get "ERROR 2002: Can't connect to local MySQL
server@
"ln -s /var/run/mysqld/mysqld.sock /tmp/mysql.sock"@
so there may be some additional trouble depending on your mysql setup.
@node Performance Tuning
address@hidden Performance Tuning
address@hidden Performance Tuning
For GNUnet, you probably want to set the option
@example
@@ -2673,7 +2817,7 @@ If you want to run the testcases, you must create a
second database
used for testing ("make check").
@node Configuring the Postgres database
address@hidden Configuring the Postgres database
address@hidden Configuring the Postgres database
This text describes how to setup the Postgres database for GNUnet.
@@ -2750,8 +2894,8 @@ $ createdb gnunetcheck # this way you can run "make check"
Now you should be able to start @code{gnunet-arm}.
address@hidden Testing the setup manually
@node Testing the setup manually
address@hidden Testing the setup manually
You may want to try if the database connection works. First, again login as
the user who will run gnunet-arm. Then use,
@@ -2979,6 +3123,49 @@ settings. Just specify the interface to use:@
@node Configuring the wlan transport plugin
@subsection Configuring the wlan transport plugin
+
address@hidden
+* User Manual for the wlan transport plugin::
+* Introduction2::
+* Requirements2::
+* Configuration::
+* Before starting GNUnet::
+* Limitations and known bugs::
+* Configuring HTTP(S) reverse proxy functionality using Apache or nginx::
+* Blacklisting peers::
+* Configuration of the HTTP and HTTPS transport plugins::
+* Configuring system-wide DNS interception::
+* Configuring the GNU Name System::
+* Configuring the GNS nsswitch plugin::
+* Configuring GNS on W32::
+* GNS Proxy Setup::
+* Setup::
+* Testing2::
+* Automatic Shortening in the GNU Name System::
+* Configuring the GNUnet VPN::
+* IPv4 address for interface::
+* IPv6 address for interface::
+* Configuring the GNUnet VPN DNS::
+* Configuring the GNUnet VPN Exit Service::
+* IP Address of external DNS resolver::
+* IPv4 address for Exit interface::
+* IPv6 address for Exit interface::
+* Bandwidth Configuration::
+* Configuring NAT::
+* How to start and stop a GNUnet peer::
+* The Single-User Setup::
+* The Multi-User Setup::
+* Killing GNUnet services::
+* Access Control for GNUnet::
+* Recommendation Disable access to GNUnet services via TCP::
+* Recommendation Run most GNUnet services as system user "gnunet"::
+* Recommendation Control access to GNUnet services using group "gnunet"::
+* Recommendation Limit access to certain SUID binaries by group "gnunet"::
+* Recommendation Limit access to critical gnunet-helper-dns to group
"gnunetdns"::
+* Differences between "make install" and these recommendations::
+* Peer Configuration::
address@hidden menu
+
@node User Manual for the wlan transport plugin
@subsubsection User Manual for the wlan transport plugin
@@ -3903,8 +4090,8 @@ machine. Access to the APIs of these critical services
and their priviledged
helpers must be tightly controlled.
@end table
address@hidden Recommendation: Disable access to GNUnet services via TCP
address@hidden Recommendation: Disable access to GNUnet services via TCP
address@hidden Recommendation Disable access to GNUnet services via TCP
address@hidden Recommendation Disable access to GNUnet services via TCP
GNUnet services allow two types of access: via TCP socket or via UNIX domain
socket. If the service is available via TCP, access control can only be
@@ -3918,8 +4105,8 @@ As of GNUnet 0.9.2, configuration files with TCP access
disabled should be
generated by default. Users can re-enable TCP access to particular services
simply by specifying a non-zero port number in the section of the respective
service.
address@hidden Recommendation: Run most GNUnet services as system user "gnunet"
address@hidden Recommendation: Run most GNUnet services as system user "gnunet"
address@hidden Recommendation Run most GNUnet services as system user "gnunet"
address@hidden Recommendation Run most GNUnet services as system user "gnunet"
GNUnet's main services should be run as a separate user "gnunet" in a special
group "gnunet". The user "gnunet" should start the peer using "gnunet-arm -s"
@@ -3928,8 +4115,8 @@ during system startup. The home directory for this user
should be
the "gnunet" user should have the right to access "/var/lib/gnunet" (mode:
700).
address@hidden Recommendation: Control access to GNUnet services using group
"gnunet"
address@hidden Recommendation: Control access to GNUnet services using group
"gnunet"
address@hidden Recommendation Control access to GNUnet services using group
"gnunet"
address@hidden Recommendation Control access to GNUnet services using group
"gnunet"
Users that should be allowed to use the GNUnet peer should be added to the
group "gnunet". Using GNUnet's access control mechanism for UNIX domain
@@ -3941,16 +4128,16 @@ causing security concerns. Some services, such as DNS,
must NOT be made
accessible to the "gnunet" group (and should thus only be accessible to the
"gnunet" user and services running with this UID).
address@hidden Recommendation: Limit access to certain SUID binaries by group
"gnunet"
address@hidden Recommendation: Limit access to certain SUID binaries by group
"gnunet"
address@hidden Recommendation Limit access to certain SUID binaries by group
"gnunet"
address@hidden Recommendation Limit access to certain SUID binaries by group
"gnunet"
Most of GNUnet's SUID binaries should be safe even if executed by normal users.
However, it is possible to reduce the risk a little bit more by making these
binaries owned by the group "gnunet" and restricting their execution to user of
the group "gnunet" as well (4750).
address@hidden Recommendation: Limit access to critical gnunet-helper-dns to
group "gnunetdns"
address@hidden Recommendation: Limit access to critical gnunet-helper-dns to
group "gnunetdns"
address@hidden Recommendation Limit access to critical gnunet-helper-dns to
group "gnunetdns"
address@hidden Recommendation Limit access to critical gnunet-helper-dns to
group "gnunetdns"
A special group "gnunetdns" should be created for controlling access to the
"gnunet-helper-dns". The binary should then be owned by root and be in group
diff --git a/user.texi b/user.texi
index 89f5a60..181fb9e 100644
--- a/user.texi
+++ b/user.texi
@@ -8,6 +8,16 @@ outside of the scope of this tutorial. Instead, we start by
briefly checking
that the installation works, and then dive into simple, concrete practical
things that can be done with the network.
address@hidden
+* UserIntroduction::
+* Checking the Installation::
+* First steps File-sharing::
+* First steps Using the GNU Name System::
+* First steps Using GNUnet Conversation::
+* First steps Using the GNUnet VPN::
+* File-sharing::
address@hidden menu
+
@node UserIntroduction
@section UserIntroduction
@@ -28,6 +38,13 @@ This chapter describes a quick casual way to check if your
GNUnet installation
works. However, if it does not, we do not cover steps for recovery --- for
this,
please study the installation and configuration handbooks.
+
address@hidden
+* gnunet-gtk::
+* Statistics::
+* Peer Information::
address@hidden menu
+
@node gnunet-gtk
@subsection gnunet-gtk
@c %**end of header
@@ -81,8 +98,8 @@ country of origin (if determined) and address information. If
hardly any peers
are listed and/or if there are very few peers with a green light for
connectivity, there is likely a problem with your network configuration.
address@hidden First steps: File-sharing
address@hidden First steps: File-sharing
address@hidden First steps File-sharing
address@hidden First steps File-sharing
@c %**end of header
This chapter describes first steps for file-sharing with GNUnet. To start, you
@@ -92,6 +109,13 @@ the arrows between the three circles).
As we want to be sure that the network contains the data that we are looking
for
for testing, we need to begin by publishing a file.
+
address@hidden
+* Publishing::
+* Searching::
+* Downloading::
address@hidden menu
+
@node Publishing
@subsection Publishing
@c %**end of header
@@ -188,10 +212,23 @@ respective download and selecting "Abort download" from
the menu.
That's it, you now know the basics for file-sharing with GNUnet!
address@hidden First steps: Using the GNU Name System
address@hidden First steps: Using the GNU Name System
address@hidden First steps Using the GNU Name System
address@hidden First steps Using the GNU Name System
@c %**end of header
+
+
address@hidden
+* Preliminaries::
+* The GNS Tab::
+* Creating a Record::
+* Creating a Business Card::
+* Resolving GNS records::
+* Integration with Browsers::
+* Be Social::
+* What's Next?::
address@hidden menu
+
@node Preliminaries
@subsection Preliminaries
@c %**end of header
@@ -403,8 +440,8 @@ to use GNS to have a private conversation with your friend.
Finally, help us
with the next GNUnet release for even more applications using this new
public key infrastructure.
address@hidden First steps: Using GNUnet Conversation
address@hidden First steps: Using GNUnet Conversation
address@hidden First steps Using GNUnet Conversation
address@hidden First steps Using GNUnet Conversation
@c %**end of header
Before starting the tutorial, you should be aware that
@@ -413,6 +450,13 @@ tool and that the call quality tends to be abysmal. There
are also some awkward
steps necessary to use it. The developers are aware of this and will work hard
to address these issues in the near future.
+
address@hidden
+* Testing your Audio Equipment::
+* GNS Zones::
+* Future Directions::
address@hidden menu
+
@node Testing your Audio Equipment
@subsection Testing your Audio Equipment
@c %**end of header
@@ -433,6 +477,12 @@ associated with GNUnet's audio tools.
have a GNS zone created before using it. Information about how to create GNS
zones can be found here.
+
address@hidden
+* Picking an Identity::
+* Calling somebody::
address@hidden menu
+
@node Picking an Identity
@subsubsection Picking an Identity
@c %**end of header
@@ -506,10 +556,19 @@ Note that we do not envision people to use
gnunet-conversation like this
forever. We will write a graphical user interface, and that GUI will
automatically create the necessary records in the respective zone.
address@hidden First steps: Using the GNUnet VPN
address@hidden First steps: Using the GNUnet VPN
address@hidden First steps Using the GNUnet VPN
address@hidden First steps Using the GNUnet VPN
@c %**end of header
+
address@hidden
+* Preliminaries2::
+* Exit configuration::
+* GNS configuration::
+* Accessing the service::
+* Using a Browser::
address@hidden menu
+
@node Preliminaries2
@subsection Preliminaries2
@c %**end of header
@@ -626,8 +685,21 @@ In this chapter, we will first look at the various
concepts in GNUnet's
file-sharing implementation. Then, we will discuss specifics as to how they
impact users that publish, search or download files.
address@hidden File-sharing: Concepts
address@hidden File-sharing: Concepts
+
+
address@hidden
+* File-sharing Concepts::
+* File-sharing Publishing::
+* File-sharing Searching::
+* File-sharing Downloading::
+* File-sharing Directories::
+* File-sharing Namespace Management::
+* File-Sharing URIs::
+* GNS Configuration::
address@hidden menu
+
address@hidden File-sharing Concepts
address@hidden File-sharing Concepts
@c %**end of header
Sharing files in GNUnet is not quite as simple as in traditional file sharing
@@ -642,6 +714,19 @@ reputation. Furthermore, GNUnet allows updates to certain
content to be made
available. This section is supposed to introduce users to the concepts that are
used to achive these goals.
+
address@hidden
+* Files::
+* Keywords::
+* Directories::
+* Pseudonyms::
+* Namespaces::
+* Advertisements::
+* Anonymity level::
+* Content Priority::
+* Replication::
address@hidden menu
+
@node Files
@subsubsection Files
@c %**end of header
@@ -764,8 +849,8 @@ always push the block with the highest replication level
into the network, and
then decrement the replication level by one. If all blocks reach replication
level zero, the selection is simply random.
address@hidden File-sharing: Publishing
address@hidden File-sharing: Publishing
address@hidden File-sharing Publishing
address@hidden File-sharing Publishing
@c %**end of header
The command @code{gnunet-publish} can be used to add content to the network.
@@ -774,6 +859,12 @@ The basic format of the command is
$ gnunet-publish [-n] [-k KEYWORDS]* [-m TYPE:VALUE] FILENAME
@end example
+
address@hidden
+* Important command-line options::
+* Indexing vs. Inserting::
address@hidden menu
+
@node Important command-line options
@subsubsection Important command-line options
@c %**end of header
@@ -828,8 +919,8 @@ knowledge of the existence of the file, even if it is still
(encrypted) on the
drive and the adversary is able to crack the encryption (e.g. by guessing the
keyword.
address@hidden File-sharing: Searching
address@hidden File-sharing: Searching
address@hidden File-sharing Searching
address@hidden File-sharing Searching
@c %**end of header
The command @code{gnunet-search} can be used to search for content on GNUnet.
@@ -875,8 +966,8 @@ The second line contains the description of the file; here
this is
"The GNU Public License" and the mime-type (see the options for gnunet-publish
on how to specify these).
address@hidden File-sharing: Downloading
address@hidden File-sharing: Downloading
address@hidden File-sharing Downloading
address@hidden File-sharing Downloading
@c %**end of header
In order to download a file, you need the three values returned by
@@ -907,8 +998,8 @@ You may want to use the @code{-V} switch (must be added
before the @code{--}) to
turn on verbose reporting. In this case, @code{gnunet-download} will print the
current number of bytes downloaded whenever new data was received.
address@hidden File-sharing: Directories
address@hidden File-sharing: Directories
address@hidden File-sharing Directories
address@hidden File-sharing Directories
@c %**end of header
Directories are shared just like ordinary files. If you download a directory
@@ -921,8 +1012,8 @@ retrieve the file. The meta data typically includes the
mime-type, description,
a filename and other meta information, and possibly even the full original file
(if it was small).
address@hidden File-sharing: Namespace Management
address@hidden File-sharing: Namespace Management
address@hidden File-sharing Namespace Management
address@hidden File-sharing Namespace Management
@c %**end of header
THIS TEXT IS OUTDATED AND NEEDS TO BE REWRITTEN FOR 0.10!
@@ -931,6 +1022,15 @@ The gnunet-pseudonym tool can be used to create
pseudonyms and to advertise
namespaces. By default, gnunet-pseudonym simply lists all locally available
pseudonyms.
+
address@hidden
+* Creating Pseudonyms::
+* Deleting Pseudonyms::
+* Advertising namespaces::
+* Namespace names::
+* Namespace root::
address@hidden menu
+
@node Creating Pseudonyms
@subsubsection Creating Pseudonyms
@c %**end of header
@@ -990,6 +1090,15 @@ GNUnet (currently) uses four different types of URIs for
file-sharing. They all
begin with "gnunet://fs/". This section describes the four different URI types
in detail.
+
address@hidden
+* Encoding of hash values in URIs::
+* Content Hash Key (chk)::
+* Location identifiers (loc)::
+* Keyword queries (ksk)::
+* Namespace content (sks)::
address@hidden menu
+
@node Encoding of hash values in URIs
@subsubsection Encoding of hash values in URIs
@c %**end of header
@@ -1053,6 +1162,13 @@ to some kind of index or other entry point into the
namespace.
@subsection GNS Configuration
@c %**end of header
+
+
address@hidden
+* DNS Services Configuration::
+* The GNU Name System::
address@hidden menu
+
@node DNS Services Configuration
@subsubsection DNS Services Configuration
@c %**end of header
@@ -1064,6 +1180,7 @@ The special strings "localhost4" and "localhost6" are
expanded to the IPv4 and
IPv6 address of the exit interface respectively.
@node The GNU Name System
address@hidden The GNU Name System
@c %**end of header
The GNU Name System (GNS) is secure and decentralized naming system.
--
To stop receiving notification emails like this one, please contact
address@hidden
- [GNUnet-SVN] [gnunet-texinfo] branch master updated (cc13ef6 -> 6abc704),
gnunet <=