ipx.txt

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