IPProcessor User Guide
======================

Release: Version 1.0

Introduction
============

This application is for converting IP ranges to CIDR format.

Usage
=====

ipprocessor <input> <output> -comment
	
        input - if output is ommited then input is treated as a single IP, otherwise its a filename containing a list of IPs
        output - filename to output the CIDR formatted IPs to
        comment - if included a comment line will be outputted as a header to the matching CIDR IPs

Notes
=====

The application takes an IP range and give you it back in CIDR format. It will give you back as many CIDR IPs as necessary to cover the range specified. To run you can use 

java -jar ipprocessor.jar

That will give you arguments. Simply if you give it the IP range on the command line as a single parameter it will output all the CIDRs needed. If you give it an input and output file it will process all the IPs generating all CIDR IPs. If you use the comment option it will output the original IP range between "***" in the output file so you can easily see what was generated for each IP. The IP format accepted is

	(x-x).(x-x).(x-x).(x-x) 
Or 
	x.x.x.x
Or a combination of the above

Eg 
	(128-128).(166-166).(120-222).(0-255) 
Or 	
	128.166.(120-222).(0-255)

A few rules about the IPs. You can use the range specifier ie (x-x) for any octet, including single number ranges. If you specify a range for any octet then all following octets must have the (0-255) specified range otherwise its considered invalid.

Running IPProcessor
===================

The easiest way to run the application is to use the following command, followed by the appropriate parameters.

	java -jar ipprocessor.jar

Copyright © 2002 Antony Scerri