OLD/ipx.txt

   1 TITLE:          Using the IPX protocol on an LFS system
   2 LFS VERSION:    any (tested with 3.1 and 4.0)
   3 AUTHOR:         Leslie Polzer <leslie.polzer@gmx.net>
   4
   5 SYNOPSIS:
   6         Guide to configuring IPX interfaces on LFS.
   7
   8 HINT:
   9
  10 Contents
  11 --------
  12 1 Overview
  13         1.1 ChangeLog
  14         1.2 What is IPX?
  15         1.3 Why IPX?
  16         1.4 Notes
  17
  18 2 Kernel matters
  19         2.1 Configuration
  20         2.2 Files in /proc/net
  21
  22 3 Software requirements and build process
  23         3.1 Fixing ipx.h
  24         3.2 Downloading, unpacking and building
  25         3.3 Installing
  26                 3.3.1 For SysVInit boot scripts
  27                 3.3.2 For BSD boot scripts
  28
  29 4 References and pointers
  30
  31
  32
  33 1 Overview
  34 ==========
  35
  36 1.1 ChangeLog
  37 -------------
  38         * 2003-07-24: New patch for kernel 2.4.18 headers by
  39                 Izzy Blacklock <izzyb@ecn.ab.ca>
  40
  41
  42 1.2 What is IPX?
  43 ----------------
  44 IPX is a networking protocol, much like TCP/IP, introduced by Novell and used
  45 in their Netware products.
  46
  47
  48 1.3 Why IPX?
  49 ------------
  50 IPX is still very common with games - and, of course, Netware boxes.
  51
  52
  53 1.4 Notes
  54 ---------
  55 I make the following assumptions:
  56
  57         - you have only one ethernet interface by the name of 'eth0'
  58         - this interface is configured for TCP/IP and up
  59         - you want the standard (though obsolete) frame type 802.2
  60         - you are able to consult the IPX-Howto (see section 4 for a link)
  61                 if you want to know more
  62
  63 You should meet these requirements if you followed the LFS installation.
  64 Please note also that I won't cover the installation of ncpfs.
  65
  66
  67 2 Kernel matters
  68 ================
  69
  70 2.1 Configuration
  71 -----------------
  72 Enable 'Networking options' -> 'The IPX protocol' (CONFIG_IPX, that is),
  73 then compile and install your kernel.
  74
  75
  76 2.2 Files in /proc/net
  77 ----------------------
  78 Now you got three new files in /proc/net, all starting with 'ipx':
  79
  80 - ipx
  81         The list of open IPX sockets.
  82
  83 - ipx_route
  84         The list of routing table entries.
  85
  86 - ipx_interface
  87         The list of configured IPX interfaces.
  88
  89
  90 3 Software requirements and build process
  91 =========================================
  92
  93 3.1 Fixing ipx.h
  94 ----------------
  95 We must fix the header file ipx.h.
  96 There are two patches for it, an old one and a new one. For LFS 4.0 and up
  97 use the new one.
  98
  99         Old Patch: http://linuxfromscratch.org/~timothy/misc/linux_ipx_h_old.patch
 100         New Patch: http://linuxfromscratch.org/~timothy/misc/linux_ipx_h_new.patch
 101
 102 Apply it with (I assume the patch file is also in /usr/include/linux):
 103
 104         cd /usr/include/linux &&
 105         patch < linux_ipx_h.patch
 106
 107
 108 3.2 Downloading, unpacking and building
 109 ---------------------------------------
 110 Now we can build the IPX tools. Get the tarball from:
 111
 112         ftp://sunsite.unc.edu/pub/Linux/system/filesystems/ncpfs/ipx.tgz
 113
 114 And unpack the archive:
 115
 116         tar xvfz ipx.tgz
 117         cd ipx-1.0/
 118
 119 Compile the package by typing
 120
 121         make CFLAGS="-O2 -w"
 122
 123 You shouldn't get any errors.
 124
 125
 126 3.3 Installing
 127 --------------
 128
 129 3.3.1 For SysVInit boot scripts
 130 -------------------------------
 131 The makefile will install sysvinit bootscripts, yet be careful:
 132 If you have an LFS-system before 3.2-RC1 (3.1 or earlier, that is), you
 133 got no /etc/rc.d directory but all the sysvinit-bootcrap in /etc.
 134 Either make a symlink in /etc:
 135
 136         cd /etc &&
 137         ln -sf . rc.d
 138
 139 -or- adjust the Makefile in the top-level source dir:
 140
 141         cat Makefile | sed -e "s/\/etc\/rc.d\//\/etc\//g" > Makefile
 142
 143 Then adjust the man path in the Makefile:
 144
 145         cat Makefile | sed -e "s/\/usr\/man\//\/usr\/share\/man\//" > Makefile
 146
 147 and type
 148
 149         su -c "make install"
 150
 151 to install the binaries, the man pages and the bootscripts.
 152
 153 The last step is to activate the configuration in /etc/sysconfig/ipx:
 154
 155         su -c 'cat /etc/sysconfig/ipx | sed -e "s/IPX_CONFIGURED=no/IPX_CONFIGURED=yes/" > /etc/sysconfig/ipx'
 156
 157
 158 3.3.2 For BSD boot scripts
 159 --------------------------
 160 Install the binaries and man pages with:
 161
 162         for i in 'ipx_configure ipx_interface ipx_internal_net ipx_route'
 163     do
 164                 install --strip $i /sbin
 165                 install $i.8 /usr/share/man/man8
 166         done
 167
 168 Then adjust your network init script(s).
 169 If you followed the BSD-init hint, these are:
 170
 171         /etc/rc.d/rc.2
 172         /etc/rc.d/rc.3
 173
 174 Find the line where eth0 is configured ('ifconfig eth0 [...]') and
 175 write below it:
 176
 177         /sbin/ipx_interface add -p eth0 802.2 0x00000001
 178
 179 This assumes you want frame type 802.2 and IPX network address 1.
 180 Note that Microsoft Windows boxes use 0 as the default, which is an
 181 invalid address. If you want these computers to talk to your Linux box,
 182 you must manually adjust the properties of the IPX/SPX protocol in the
 183 network properties dialog.
 184
 185
 186 4 References and pointers
 187 =========================
 188 [1] The IPX-HowTo - http://www.tldp.org/HOWTO/IPX-HOWTO.html