Content-type: text/html
Manpage of NetsukukuD
NetsukukuD
Section: (8)
Updated: 2006-01-31
Index
Return to Main Contents
NAME
netsukuku_d - Netsukuku protocol daemon
SYNOPSIS
netsukuku_d [-hvadrD46] [-i net_interface] [-c conf_file]
DESCRIPTION
Netsukuku is a mesh network or a P2P net system that generates and sustains
itself autonomously. It is designed to handle an unlimited number of nodes with
minimal CPU and memory resources. Thanks to this feature it can be easily
used to build a worldwide distributed, anonymous and anarchical network,
separated from the Internet, without the support of any servers, ISPs or
authority controls.
Keep in mind that it is a _physical network_, it isn't built upon any other
existing net, therefore there must be computers linked _physically_ each
other, then Netsukuku will build the routes.
For more information read the section ``2.4 So, WTF is it?'' of the
document.
In order to join to Netsukuku you have to use netsukuku_d, which is the
daemon implenting the Npv7 protocol.
The daemon at startup takes the list of all the network interfaces which are
currently UP and it uses all of them to send and receive packets. If you want
to force the daemon to use specific interfaces you should use the -i
option.
The ports it listens to are: 269-udp, 269-tcp, 271-udp, 277-udp, 277-tcp. So
be sure to open them in the firewall.
For more information about Netsukuku visit:
<http://netsukuku.freaknet.org>
OPTIONS
- -4, --ipv4
-
Forces the daemon to use ipv4 addresses only
- -6, --ipv6
-
Forces the daemon to use ipv6 addresses only. Warning, this is still
experimental.
- -i interface, --iface interface
-
Specifies the network interface the daemon will use to join Netsukuku, i.e.
wlan0. You can use more than one interface by specifying multiple times the
-i option. For example: netsukuku_d -i wlan0 -i eth0 -i wifi1 -i eth1
- -a, --no_andna
-
Forces netsukuku_d to don't run the ANDNA daemon when started.
- -R, --no_resolv
-
When NetsukukuD starts it modifies /etc/resolv.conf writing in the first
line the string ``nameserver 127.0.0.1''. The old /etc/resolv.conf is copied in
/etc/resolv.conf.bak. When the daemon is closed /etc/resolv.conf is
restored. If you want to disable this set use the -R option.
- -r, --restricted
-
With this option the daemon will run in restricted mode as specified in
the Npv7, only IPs of the private class will be choosen. It is used for
Internet compatibility.
- -I, --share-inet
-
Tells NetsukukuD to run in restricted mode (see -r) and to share your
Internet connection. Please check the relative options in
/etc/netsukuku/netsukuku.conf
- -D, --no_daemon
-
This option tells netsukuku_d to don't detach to background and
daemonizing itself. The daemon will run on foreground instead.
- -c configuration_file, --conf configuration_file
-
Specifies the name of the configuration file. The
default is /etc/netsukuku/netsukuku.conf. netsukuku_d will not start
without a configuration file.
- -d, --debug
-
With this option the daemon will run with displaying its debug messages.
The more -d you specify the more debug messages you'll get. Sometimes it's
cool to use it, but be careful and don't go insane ;)
- -h, --help
-
Display a the list of available options and their brief description.
- -v, --version
-
Displays the version of the netsukuku_d daemon.
EXAMPLES
Usually you'll just want to use netsukuku_d with a wifi device:
netsukuku_wifi wlan0
netsukuku_d -i wlan0
If you one to use more than one network interface:
netsukuku_d -i eth0 -i wlan0 -i wifi1 -i eth2
SIGNALS
When the SIGHUP signal is sent to netsukuku_d, the andna_hostnames file
is reloaded and the daemon tries to register all the new added hostnames.
When the SIGALRM signal is sent to netsukuku_d, the resolved hostnames
cache is flushed.
LOGS
If netsukuku_d is started as a daemon (without the -D option), all the
logs are sent to syslog under the LOG_DAEMON category.
If the no-daemon option (-D) is used, all the logs are printed to
stderr.
FILES
- /etc/netsukuku/netsukuku.conf
-
It is the default path for the netsukuku_d configuration file. It's
possible to choose another file using the -c option.
- /etc/netsukuku/andna_hostnames
-
It is the file where the hostnames to be registerd in ANDNA are kept one per
line. It's location can be changed by modifying its option in the
netsukuku.conf file.
- /usr/share/netsukuku/ext_map_file
-
- /usr/share/netsukuku/int_map_file
-
- /usr/share/netsukuku/bnode_map_file
-
They are the Netsukuku maps saved by the daemon. Their locations can be
changed in netsukuku.conf.
- /usr/share/netsukuku/andna_cache
-
- /usr/share/netsukuku/lcl_cache
-
- /usr/share/netsukuku/rh_cache
-
- /usr/share/netsukuku/counter_cache
-
They are the saved ANDNA caches. Their locations can be
changed in netsukuku.conf.
- /etc/netsukuku/ip_masquerade.sh
-
This script is launched by NetsukukuD, at its start, when it shares the Internet
connection.
KERNEL DEPENDENCIES
On Linux be sure to have the following options set in your kernel .config.
These options are taken from linux-2.6.14.
#
# Networking options
#
CONFIG_PACKET=y
CONFIG_UNIX=y
CONFIG_INET=y
CONFIG_IP_MULTICAST=y
CONFIG_IP_ADVANCED_ROUTER=y
CONFIG_IP_MULTIPLE_TABLES=y
CONFIG_IP_ROUTE_MULTIPATH=y
CONFIG_NET_IPIP=y
CONFIG_NETFILTER=y
#
# IP: Netfilter Configuration
#
CONFIG_IP_NF_CONNTRACK=y
CONFIG_IP_NF_FTP=y
CONFIG_IP_NF_IPTABLES=y
CONFIG_IP_NF_FILTER=y
CONFIG_IP_NF_TARGET_REJECT=y
CONFIG_IP_NF_NAT=y
CONFIG_IP_NF_NAT_NEEDED=y
CONFIG_IP_NF_TARGET_MASQUERADE=y
CONFIG_IP_NF_NAT_FTP=y
If you are using modules you have to load them before launching the daemon.
BUGS
{ Don't panic! }
If you encounter any bug, please report it to netsukuku@freaknet.org or
contacts any author explaining what the problem is and if possible a way to
reproduce it.
CONTACTS
Subcrive to the netsukuku mailing to get help, be updated on the latest news
and discuss on its development.
To subscribe to the list, send a message to:
<netsukuku-subscribe@freaknet.org>
We live night and day in IRC, come to see us in:
#netsukuku
on the FreeNode irc server (irc.freenode.org).
AUTHORS
Main authors and maintainers:
Andrea Lo Pumo aka AlpT <alpt@freaknet.org>
Main contributors:
Andrea Leofreddi <andrea.leofreddi@gmail.com>, Katolaz <katolaz@freaknet.org>,
Federico Tomassini <effetom@gmail.com>
For a complete list read the AUTHORS file or visit:
<http://netsukuku.freaknet.org/?p=Contacts>
SEE ALSO
For more information about Netsukuku visit:
<http://netsukuku.freaknet.org>
netsukuku_wifi(8), andna(8), iproute2(8), route(8)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- SIGNALS
-
- LOGS
-
- FILES
-
- KERNEL DEPENDENCIES
-
- BUGS
-
- CONTACTS
-
- AUTHORS
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 03:38:02 GMT, January 31, 2006