Mercurial > hg > anonet-resdb
changeset 1250:c1c77f37ca5f draft
deleted: README.txt
author | Passive <passive@21.50.0.1> |
---|---|
date | Sun, 08 Dec 2019 12:15:34 -0600 |
parents | d46d12ef124d |
children | 084aeb361608 b144c060246d |
files | README.txt |
diffstat | 1 files changed, 0 insertions(+), 65 deletions(-) [+] |
line wrap: on
line diff
--- a/README.txt Sun Dec 08 11:01:26 2019 -0600 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,65 +0,0 @@ ---- ResDB structure (As written by Sarah.ano 10/March/2014) -When I 'joined' anonet I was told to update the resdb. -This in itself isnt all that hard to do if someone helps you. -But when that isnt the case youre kind of stuck. -There isnt a helpful README that says exactly what to do, or even what is necesary. -As of writing, there isnt anything on the anonet wiki about it either. -Maybe this can be that README? - --- ResDB in a nutshell -ResDB is where people write down what they own. -If its not in the ResDB, people wont know its yours. -Things like tinydns use the db/dom directory to find relevant DNS servers. -Chakra in #anonet uses all information to answer requests. (try @asowner <num>) - --- A smallish disclaimer -Do not blindly run anything you find in ResDB. -Someone could have edited, well, anything, to include a rm -rf / (or worse) -Everything is written in human readable languages. So just cat the scripts and read them. -You might even learn something. - --- What are all these things? -Short explanation on what everything in resdb is. -doc/ Where people put documentation. A bit sparse. Also where this file should be. -db/ Ill get to that later. Its the important bit. -contrib/ Full of a lot of misc things that people found useful enough to include. Most of it is not documented. Run with care. -scripts/ Mostly scripts directly related to working with ResDB. Again, run with care. - -The executables are related to running your own git and serving your modified ResDB. -./configure will configure git commit relevant stuff, and also configure gitd. -./gitd will run the git server. Optimally you would use this to serve your modified ResDB to others. Once someone else has it, it will usually spread fast. -./git-commit will commit whatever canges you made. You should always do this when done fucking with resdb. People cant pull uncommited changes. - -Once you want to announce your changes, just go to #anonet and tell people to pull from git://<yourgitdip>/ -Note that many people set up a proper git server to serve ResDB and other things. The included gitd is a bootstrap and potential hazard. (Since future commits might put bad things in there.) - --- DB Structure -- db/as/ -Every claimed AS has a directory here. Inside is a single file called 'owner'. -That file simply contains the handle of whoever owns that AS. -To add yourself, either create these things manually or use a script. (scripts/add_as) - -- db/dom/ -Inside is a directory for each TLD in use. In each TLD directory are domain names. -Each domain name directory contains another 'owner' file, and a ns directory. -The ns directory should contain a file named 'a.ns.<domain>.<tld>' or something similar. -In that file should be a valid anonet ip to a DNS server. This DNS server will be asked about your domain and is required. -There is also a script for this (scripts/add_dom), but take care to give a valid ns as argument too or your domain will be broken. - -- db/ip and db/ip6 -Nested directories for each byte of an IP. At the end of that chain is, again, an owner file and a cidr file. -Doing this manually might cause confusion, headaches and sudden death. -Id recommend using a script. (scripts/add_ip) - -- db/usr -Kind of freeform. A directory for every handle that cares to add itself. -Inside, you can put pretty much whatever information you want. -An adress to your git server, contact information. The filenames should be short and descriptive. -Just check a few folders yourself and youll get the idea. Maybe find something useful. - --- So what do? -Well, if you are reading this, I assume you are already peered. So you should know your information. -So go and add it to the relevant places as explained. -If you are still confused (as you should be) head to #anonet and seek help. You should say Hi anyway. -Help on other related things (like tinydns) can be found on the wiki or asked for. -If something doesnt work, fuck around with it untill it does.