IPAS Documentation

AN IP address to Autonomous System Number Converter

[Documentation]

IPAS

AN IP address to Autonomous System Number Converter

Ipas is a small package to translate IP addresses into Autonomous System numbers. It can operate in two ways:

As a client/server architecture. The program making the translation requests packages one or more requests into a message and sends it to the server. The server sends a reply message which contains the AS number.
As an embedded translator. The database is loaded into memory and requests are translated within the same program.

The client server approach is faster for a small number of requests and uses less memory. It also allows a remote database to be used, such as the one maintained by NLANR/MOAT. The embedded translator has a high startup time (while the database is loaded) but, in most cases, has a lower overhead per translation request.

Example C and perl programs which make requests are provided in ipas.c and ipas.pl. ipas.pl can only operate in client/server mode, while ipas.c can operate in both modes.

When linking ipas you should include usage.o and util.o. If you want ipas to operate as a client you should also include socket.o. If you want ipas to operate as an embedded translator, load embed.o and tree.o. See the Makefile for an example.

There is a server (configured as the default) at ipas.nlanr.net. The map there is updated weekly from the Route Views project (http://antc.uoregon.edu/route-views/).

If you run your own server you can get it to reload the as_map by sending it a HUP signal. If you have debugging enabled (see ipas.h), it will print the tree when you send it a USR1 signal.

Acknowledgement:

This NLANR project, located at the University of California, San Diego and its San Diego Supercomputer Center is based on work sponsored by the National Science Foundation and its ANIR division under Cooperative Agreement No. ANI-9807479.