Vous ne pouvez pas sélectionner plus de 25 sujets Les noms de sujets doivent commencer par une lettre ou un nombre, peuvent contenir des tirets ('-') et peuvent comporter jusqu'à 35 caractères.

andna 5.6KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160
  1. NAME
  2. ANDNA - Abnormal Netsukuku Domain Name Anarchy
  3. DESCRIPTION
  4. ANDNA is the distributed, non hierarchical and decentralised system of
  5. hostname management in Netsukuku. It substitutes the DNS. The ANDNA
  6. database is scattered inside all the Netsukuku net and in the worst case
  7. every node will have to use about some hundreds Kb of memory.
  8. In order to join ANDNA it is necessary to be hooked at Netsukuku with
  9. the ntkd(8) daemon.
  10. For more information about ANDNA visit: <http://netsukuku.freaknet.org>
  11. USAGE
  12. First of all be sure to have the ntkd(8) daemon up and running.
  13. HOSTNAME REGISTRATION
  14. You can register up to 256 hostnames. Each hostname can be a string of
  15. maximum 512 bytes, which contains a newline (\n) only at its end.
  16. The hostnames to be registered must be listed, one per line, in the
  17. andna_hostnames file, which is by default in
  18. /etc/netsukuku/andna_hostnames.
  19. The ntkd(8) daemon reads it when it is started and when it receives the
  20. SIGHUP signal. So if you've added a hostname while ntkd was running,
  21. just do:
  22. killall -HUP ntkd
  23. All the hostnames, which are already registered by other nodes, are
  24. added in the queue, in this way, when the other nodes won't update them,
  25. your hostnames will automatically be the first in the queue.
  26. An hostname expires after 3 days, if it isn't updated. ntkd
  27. automatically updates the registered hostnames, therefore your hostnames
  28. will expire only if you aren't present in the Netsukuku for 3 entire
  29. days.
  30. If you want to know the result of a registration read the ntkd logs.
  31. HOSTNAME RESOLUTION
  32. The ntkd(8) daemon runs also a DNS wrapper which receives standard DNS
  33. queries for hostnames resolution. The hostnames are resolved in ANDNA,
  34. then the DNS wrapper will reply to the requester.
  35. When the ntkd(8) daemon is started it copies /etc/resolv.conf in
  36. /etc/resolv.conf.bak and adds in the first line of /etc/resolv.conf the
  37. "nameserver 127.0.0.1" string. When it is closed it moves back
  38. /etc/resolv.conf.bak to /etc/resolv.conf. Use the -R option if you want
  39. to disable this behaviour.
  40. All the resolved hostnames are kept, until their expiration date, in the
  41. "resolved hostnames cache". The entire cache is flushed each time the
  42. ntkd(8) daemon receives the SIGALRM signal.
  43. That's all.
  44. IP RESOLUTION
  45. It is possible to know the list of hostnames registered by a node. You
  46. have to simply reverse resolve its ip. For example:
  47. dig -x 127.0.0.2
  48. This command shows your currently registered hostnames. You can use it
  49. to know what hostnames have been already registered. Note the 127.0.0.2
  50. ip. If you use 127.0.0.1 you get only the local hostname written in
  51. /etc/hosts.
  52. SCATTERED NAME SERVICE DISGREGATION
  53. The Scattered Name Service Disgregation is the ANDNA equivalent of the
  54. SRV Record of the Internet Domain Name System. For a complete
  55. description of the SNSD read the NTK_RFC 0009:
  56. <http://lab.dyne.org/Ntk_SNSD>
  57. SNSD NODE REGISTRATION
  58. * Modify the /etc/netsukuku/snsd_nodes file.
  59. * Copy the needed public keys
  60. * Send a SIGHUP to the NetsukukuD of the register node:
  61. SNSD NODE DELETION
  62. Not implemented
  63. SNSD HNAME RESOLUTION
  64. The utility ntk-resolv(8) can be used to resolve SNSD hostnames.
  65. Examples:
  66. ntk-resolv -s 53/udp host
  67. ntk-resolv -s http host
  68. SIGNALS
  69. When the SIGHUP signal is sent to ntkd(8), the andna_hostnames and
  70. snsd_nodes files will be reloaded and it will try to register all the
  71. new added hostnames and snsd records.
  72. When the SIGALRM signal is sent to ntkd(8), the resolved hostnames cache
  73. will be flushed.
  74. FILES
  75. /etc/netsukuku/andna_hostnames
  76. It is the file where the hostnames to be registerd in ANDNA are kept
  77. one per line. It's location can be changed by modifying its option
  78. in the netsukuku.conf file.
  79. /etc/netsukuku/snsd_nodes
  80. The snsd_nodes file keeps the list of the SNSD records which will be
  81. register in ANDNA.
  82. /usr/share/netsukuku/andna_lcl_keyring
  83. In this keyring your ANDNA public and secret keys are saved. Handle
  84. this file with care: without it, you won't be able to update your
  85. hostnames, thus you'll definitely lose them.
  86. /usr/share/netsukuku/andna_cache
  87. /usr/share/netsukuku/andna_lcl_cache
  88. /usr/share/netsukuku/andna_rh_cache
  89. /usr/share/netsukuku/andna_counter_cache
  90. They are the saved ANDNA caches. Their locations can be changed in
  91. netsukuku.conf.
  92. BUGS
  93. { Don't panic! }
  94. If you encounter any bug, please report it. Use the online bug track
  95. system: <http://bugs.dyne.org/>
  96. or the mailing list: <http://lists.dyne.org/netsukuku/>
  97. and explain what the problem is and if possible a way to reproduce it.
  98. CONTACTS
  99. Subscribe to the netsukuku mailing to get help, be updated on the latest
  100. news and discuss on its development.
  101. To subscribe to the list, send a message to:
  102. netsukuku-subscribe@lists.dyne.org
  103. We live night and day in IRC, come to see us in: #netsukuku on the
  104. FreeNode irc server (irc.freenode.org).
  105. AUTHORS
  106. Main authors and maintainers:
  107. Andrea Lo Pumo aka AlpT <alpt@freaknet.org>
  108. Main contributors:
  109. Andrea Leofreddi <andrea.leofreddi@gmail.com>, Katolaz
  110. <katolaz@freaknet.org>, Federico Tomassini <effetom@gmail.com>
  111. For a complete list read the AUTHORS file or visit:
  112. <http://netsukuku.freaknet.org/?p=Contacts>
  113. SEE ALSO
  114. For more information about Netsukuku visit:
  115. <http://netsukuku.freaknet.org>
  116. ntkd(8), ntk-wifi(8), iproute2(8), route(8)