Merge remote branch 'symm/master'
[blockfinder.git] / README
blob5b17874bfedf5060f92d4be94db2eea0ef54921b
1 blockfinder by Jacob Appelbaum <jacob@appelbaum.net>
3 This is a simple tool that returns a list of netblocks for a given country.
4 It does this by fetching the following lists of allocations:
6     ftp://ftp.arin.net/pub/stats/arin/delegated-arin-latest
7     ftp://ftp.ripe.net/ripe/stats/delegated-ripencc-latest
8     ftp://ftp.afrinic.net/pub/stats/afrinic/delegated-afrinic-latest
9     ftp://ftp.apnic.net/pub/stats/apnic/delegated-apnic-latest
10     ftp://ftp.lacnic.net/pub/stats/lacnic/delegated-lacnic-latest
12 The list of ISO codes is ISO 3166-1 as found here:
14     http://www.iso.org/iso/list-en1-semic-3.txt
15     http://en.wikipedia.org/wiki/ISO_3166-1
17 blockfinder has two methods of operation:
19     Update the lists of network object allocations
20     Returning a list of all netblocks (or asn, etc) for a given country
22 To use blockfinder, first create or update the cache:
24     blockfinder -i
26 Once you have a proper cache, search for the desired resource in the country
27 of your choice:
29     ./blockfinder -v --ipv4 -t mm