Contents
--------

This directory contains set of unsupported legacy scripts to generate
a list of allocated and assigned IPv4 space in the ranges that a user
specifies. For a more accurate view on RIPE NCC's delegated address space
please look into RIPE NCC's extended delegated stat file which can be 
found at: ftp://ftp.ripe.net/ripe/stats/delegated-ripencc-latest or 
RIPEstat Address Space Usage widget that can be accessed at: 
https://stat.ripe.net/widget/address-space-usage 
or through RIPEstat Data API https://stat.ripe.net/docs/data_api

After running the scripts each /8 will have two files:

    issued-[NET]
    issued-[NET].cidr

The issued file is a list of networks as IP ranges, start to end:

    10.2.3.0 - 10.2.3.5

The issued Classless Inter-Domain Routing (CIDR) file is the same
list of networks, converted to CIDR:

    10.2.3.0/30
    10.2.3.4/31

Note that a network expressed as an IP range may require multiple CIDR
networks to represent it, as in the example.



Caveats
-------

This script queries the RIPE Database and only works with IP allocations 
or assignments registered with the RIPE NCC.

It is extracted from the RIPE Whois Database.  The data is checked
against the internal registration database, but there may be time
periods where allocated space is not visible in Whois, as well as time
when returned space is visible in Whois.


Deatils
-------

Also present are some scripts.  These include:

   networks-issued.pl, the script used to extract the network
     infomation

   range2cidr.pl, the script used to convert ranges to CIDR

   invert-issued.pl, which you can use to convert the list of
     issued space into a list of unissued space

   ripe-issued.sh, which creates the issued files

   invert-ripe-issued.sh, which can be used to invert all of the
     files produced by ripe-issued.sh

The Perl scripts should run on any system with Perl 5.x and an
Internet connection.

