README

   1 blockfinder by Jacob Appelbaum <jacob@appelbaum.net>
   2
   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]
   5
   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:
   9
  10     https://ftp.arin.net/pub/stats/arin/delegated-arin-extended-latest
  11     https://ftp.ripe.net/pub/stats/ripencc/delegated-ripencc-latest
  12     https://ftp.afrinic.net/pub/stats/afrinic/delegated-afrinic-latest
  13     https://ftp.apnic.net/stats/apnic/delegated-apnic-latest
  14     https://ftp.lacnic.net/pub/stats/lacnic/delegated-lacnic-latest
  15
  16 The list of ISO codes is ISO 3166-1 as found here:
  17
  18     https://web.archive.org/web/20161122071627if_/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
  20
  21 blockfinder has two methods of operation:
  22
  23     Update the lists of network object allocations
  24     Returning a list of all netblocks (or asn, etc) for a given country
  25
  26 To use blockfinder, first create or update the cache:
  27
  28     blockfinder -i
  29
  30 Once you have a proper cache, search for the desired resource in the country
  31 of your choice:
  32
  33     ./blockfinder -v -t mm
  34
  35 Additionally, to filter results for a specific protocol you can use a selector:
  36
  37     ./blockfinder -v -t mm:ipv4
  38
  39
  40 On Windows (in cmd, PowerShell and 4nt) one may find blockfinder.bat useful:
  41
  42   blockfinder.bat
  43
  44 [0] http://www.rollingstone.com/culture/news/17389/192242