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