use ipaddr as a fallback for old pythons
[blockfinder.git] / README
blob3ef74f9470c3f6bb9ba2ad9c5fd3e7b757fced83
1 blockfinder by Jacob Appelbaum <jacob@appelbaum.net>, David <db@d1b.org>
3 "All that Blockfinder does is allow you to identify, contact and potentially
4 hack into every computer network in the world." - Rolling Stone, August 2010 [0]
6 Contrary to popular media claims, blockfinder is a simple text based console
7 tool that returns a list of netblocks for a given country.  It does this by
8 fetching the following lists of allocations:
10     ftp://ftp.arin.net/pub/stats/arin/delegated-arin-latest
11     ftp://ftp.ripe.net/ripe/stats/delegated-ripencc-latest
12     ftp://ftp.afrinic.net/pub/stats/afrinic/delegated-afrinic-latest
13     ftp://ftp.apnic.net/pub/stats/apnic/delegated-apnic-latest
14     ftp://ftp.lacnic.net/pub/stats/lacnic/delegated-lacnic-latest
16 The list of ISO codes is ISO 3166-1 as found here:
18     http://www.iso.org/iso/home/standards/country_codes/country_names_and_code_elements_txt-temp.htm
19     http://en.wikipedia.org/wiki/ISO_3166-1
21 blockfinder has two methods of operation:
23     Update the lists of network object allocations
24     Returning a list of all netblocks (or asn, etc) for a given country
26 To use blockfinder, first create or update the cache:
28     blockfinder -i
30 Once you have a proper cache, search for the desired resource in the country
31 of your choice:
33     ./blockfinder -v -t mm
35 Additionally, to filter results for a specific protocol you can use a selector:
37     ./blockfinder -v -t mm:ipv4 
40 On Windows (in cmd, PowerShell and 4nt) one may find blockfinder.bat useful:
42   blockfinder.bat
44 [0] http://www.rollingstone.com/culture/news/17389/192242