Content-type: text/html Manpage of ANDNA

ANDNA

Section: (8)
Updated: 2006-01-30
Index Return to Main Contents

NAME

ANDNA - Abnormal Netsukuku Domain Name Anarchy

DESCRIPTION

ANDNA is the distributed, non hierarchical and decentralised system of hostname management in Netsukuku. It substitutes the DNS. The ANDNA database is scattered inside all the Netsukuku and the worst of cases every node will have to use about 355 Kb of memory.

In order to join ANDNA it is necessary to be hooked at Netsukuku with the netsukuku_d(8) daemon.

For more information about ANDNA visit: <http://netsukuku.freaknet.org>

USAGE

First of all be sure to have the netsukuku_d(8) daemon up and running.

HOSTNAME REGISTRATION

You can register up to 256 hostnames. Each hostname can be a string of maximum 512 bytes, which contains a newline (\n) only at its end.

The hostnames to be registered must be listed, one per line, in the andna_hostnames file, which is by default in /etc/netsukuku/andna_hostnames.

The netsukuku_d(8) daemon reads it when it is started and when it receives the SIGHUP signal. So if you've added a hostname while netsukuku_d was running, just do:

# kill -SIGHUP <netsukuku_d pid>

All the hostnames, which are already registered by other nodes, are added in the queue, in this way, when the other nodes won't update them, your hostnames will automatically be the first in the queue.

An hostname expires after 3 days, if it isn't updated. netsukuku_d automatically updates the registered hostnames, therefore your hostnames will expire only if you aren't present in the Netsukuku for 3 entire days.

If you want to know the result of a registration read the netsukuku_d logs.

HOSTNAME RESOLUTION

The netsukuku_d(8) daemon runs also a DNS wrapper which receives standard DNS queries for hostnames resolution. The hostnames are resolved in ANDNA, then the DNS wrapper will reply to the requester.

When the netsukuku_d(8) daemon is started it copies /etc/resolv.conf in /etc/resolv.conf.bak and adds in the first line of /etc/resolv.conf the ``nameserver 127.0.0.1'' string. When it is closed it moves back /etc/resolv.conf.bak to /etc/resolv.conf. Use the -R option if you want to disable this behaviour.

All the resolved hostnames are kept, until their expiration date, in the "resolved hostnames cache". The entire cache is flushed each time the netsukuku_d(8) daemon receives the SIGALRM signal.

That's all.

IP RESOLUTION

It is possible to know the list of hostnames registered by a node. You have to simply reverse resolve its ip. For example:

# dig -x 127.0.0.2

This command shows your currently registered hostnames. You can use it to know what hostnames have been already registered. Note the 127.0.0.2 ip. If you use 127.0.0.1 you get only the local hostname written in /etc/hosts.

MX REGISTRATION and RESOLUTION

It is currently not supported.

SIGNALS

When the SIGHUP signal is sent to netsukuku_d(8), the andna_hostnames file will be reloaded and it will try to register all the new added hostnames.

When the SIGALRM signal is sent to netsukuku_d(8), the resolved hostnames cache will be flushed.

FILES

/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/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.

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>

This document was created by man2html, using the manual pages.
Time: 03:00:30 GMT, January 31, 2006