    MPLS for Linux (version 2.3)
    ============================

INSTALLING A MODIFIED KERNEL
----------------------------

 1. Untar a linux 2.3.99-pre7 (or 2.4.0) kernel tree and apply the 
    relevant MPLS kernel patch. For example,
     $ tar xzf linux-2.3.99-pre7.tar.gz
     $ cd linux
     $ patch -p1 < ../mpls-2.3/linux-2.3.99-pre7-patch

 2. Configure the kernel (eg. 'make xconfig'). You should enable MPLS support
    under the 'Networking Options' tab. If you wish to use differentiated 
    forwarding, you should also select the relevant options under 
    'QoS / Fair Queueing'.

 3. Build and install the kernel in the usual way.

 4. If you built MPLS support as a module, you'll need to 
    '/sbin/modprobe mpls' as root after booting the kernel.


INSTALLING THE COMMAND-LINE UTILITY
-----------------------------------

 1. Edit the Makefile at the root of this distribution, setting the LINUXDIR
    variable to point at the base of your modified Linux tree.

 2. Type 'make'.

 3. You can run the 'mpls' utility in place, or install it somewhere on your
    PATH (eg. /usr/local/bin).


UPDATING THE IPROUTE2 PACKAGE
-----------------------------

 A small patch ('iproute2-patch') should be applied to the current release of 
 the iproute2 utilities distribution. The distribution is available from
 ftp://ftp.inr.ac.ru/ip-routing/iproute2-current.tar.gz

 The patch allows you to specify 'protocol mpls' when setting up traffic
 classifiers, fixing a bug in version 1.0 of MPLS for Linux. See the users'
 guide for a small example.


FURTHER INFORMATION
-------------------

 LaTeX source is included for building full postscript documentation for this
 distribution. To create the documentation, enter the 'doc' subdirectory and
 type 'make'. Note that the documentation is formatted for A4 paper.


LICENSE
-------

 MPLS-for-Linux is distributed under the GNU GPL. See the file COPYING for
 further details.


BUG REPORTS AND GENERAL QUERIES
-------------------------------

 Email me at Keir.Fraser@cl.cam.ac.uk


 -- Keir Fraser (22/1/01)