IVI-v0.5 kernel patch release

1. INTRODUCTION

   IVI gives the kernel the address mapping and packet translation
   function between IPv4 and IPv6 networks.
   This is IVI kernel patch only for linux kernel 2.6.12.
   Please refer to
   <http://www.kernel.org/pub/linux/kernel/v2.6/linux-2.6.12.tar.gz>.

2. INSTALL

   1) Apply the patch using `patch -p1 < [patch-2.6.12-IVI-v0.5]'
       in kernel 2.6.12 root directory.

   2) Config the kernel. IPv6 Protocol must be built in(not module!).

           Networking -->
               Networking Options -->
                   [*] IVI(test only)
                   <*> The IPv6 protocol

   3. Build and install the kernel as usual.

3. USAGE

   1) Make sure that the machine has as least two NICs. One is for IPv4,
      the other is for IPv6.

   2) Open the forwarding option for both IPv4 and IPv6 and config the
      routing table.

   3) For every mapped network in IPv6, one specific route should be
      added in IPv6 routing table. DO NOT use default IPv6 route for
      mapped address from IPv4 side.

   4) Use `mroute' program to config the IPv4-to-IPv6 mapping route.
      Usage:
              mroute [IPv4 network] [netmask] [gateway] [interface] [source
                      prefix] [destination prefix]
      Notice:
              Different gateway addresses should be used for every entry.
              Refer to the example for more information.

   5) Use `mroute6' program to config the IPv6-to-IPv4 mapping route.
       Usage:
               mroute6 [IPv6 network] [prefix length]
       Refer to the example for more information.

4. EXAMPLE

   This is an example of IVI configuration.

   #!/bin/bash
   # open forwarding
   echo 1 > /proc/sys/net/ipv6/conf/all/forwarding
   echo 1 > /proc/sys/net/ipv4/conf/all/forwarding

   # config route for IVI6 = 2001:da8:ffca:2661:cc00::/70,
   #                  IVI4 = 202.38.97.204/30

   # configure IPv6 route
   route add -A inet6 2001:da8:ffca:2661:cc00::/70 gw \
   2001:da8:aaae::206 dev eth0

   # config mapping for      source-PF = 2001:da8::/32
   # config mapping for destination-PF = 2001:da8::/32

   # for each mapping, a unique pseudo-address (10.0.0.x/8)
   # should be configured.
   ip addr add 10.0.0.1/8 dev eth0

   # IPv4-to-IPv6 mapping, multiple mappings can be done via multiple
   # commands.
   # mroute IVI4-network IVI4-mask pseudo-address interface \
   # source-PF destination-PF
   mroute 202.38.97.204 255.255.255.252 10.0.0.1 eth0 2001:da8:: 2001:da8::

   # IPv6-to-IPv4 mapping
   # mroute6 destination-PF destination-PF-pref-len
   mroute6 2001:da8:ff00:: 40

   # all things done!

5. CONTACT

   Please refer to IVI website:
   <http://v6s.6test.edu.cn>
   <http://www.ipivi.org>