This is the RIPE RPSL Object Library (RPSL-OL), a set of routines for
parsing and manipulating RPSL objects.

This library is included in the RIPE Whois Server, and is used by that
software, so applications that use this API are insured maximum
compatibility.  However, this release is separate and there are no
dependencies.

The library requires the GLib 1.2 library, and the POSIX thread
library (even for single-threaded applications).  GLib is part of the
GIMP Toolkit:

http://www.gtk.org/

GNU Make is required to build the library:

http://www.gnu.org/software/make/make.html


To compile and install the RPSL-OL:

1. Edit Makefile.site, which contains the compiler definition and
   target flags.  For most systems, no changes are necessary.  FreeBSD
   users will need to make small changes, documented in the file.

2. Run "make" and "make install". (Make sure the "ar" command is in
   your path.  This is in /usr/ccs/bin on Solaris systems, which is
   not in the default PATH.)

You may also compile and run a simple program:

3. Run "make test".  (Make sure that any dynamic libraries required
   are available, via LD_LIBRARY_PATH.  Find out where GLib is
   installed and add it to the LD_LIBRARY_PATH if you see an error
   about libglib-x.y.so.0 or something similiar.)  FreeBSD users
   should ignore warnings from the compile.


To build an application:

#include <glib.h>
#include <syntax_api.h>
   .
   .
   .


To compile an application:

$ cc `glib-config --cflags` -c foo.c
$ cc -o foo foo.c `glib-config --libs` -lpthread -lrpsl


A Perl module is also present.  It requires Perl 5.6.0 or later.  To
build and install it:

% cd perl
% perl Makefile.PL
% make
% make install


Documentation on the C API is in the file "doc/manual.txt", and
Perl documentation is in perldoc in the installed RPSL.pm module.

For information on the RPSL definitions, please see the file
"defs/README".  Note that Java is required to modify the definitions.

This library has been compiled and tested on a variety of systems;
please contact <ripe-dbm@ripe.net> for comments and bug reports.

