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)

