doc/README.LINUX

   1 This is the Linux README file for netatalk.
   2
   3 We no longer include linux kernel code with netatalk, since Linux now
   4 includes AppleTalk support.
   5
   6 1.  UIO.H.  On older versions of Linux, you may need to make a link from
   7     /usr/include/sys/uio.h to ../linux/uio.h.  In particular, this file
   8     changed from linux 1.2.x to 1.3.x, so if, for instance, you've
   9     installed Slackware 3.0.0, and upgraded your kernel to 1.3.x,
  10     you'll need to fix this.
  11
  12 2.  MAKE CONFIG.  Configure your kernel with "make config".  Answer yes
  13     to "AppleTalk DDP" support.
  14
  15 3.  INSTALL KERNEL.  Make and install your kernel.  Be sure to update
  16     your boot blocks!
  17
  18 4.  If you are using libc.so.5, you will need to comment out the
  19     -lcrypt and the -lrpcsvc in sys/linux/Makefile. If you're using PAM,
  20     make sure you declare -DUSE_PAM and have -lpam -ldl.
  21
  22 5.  Quota support should work under linux now. If you're using glibc
  23     2.x or libc > 5.4.34, you can comment out the
  24     -DNEED_QUOTACTL_WRAPPER in sys/linux/Makefile.
  25
  26 6.  Linux 2.2.x provides the sendfile() call. This reduces overhead
  27     when sending/copying files. This option will be autoconfigured on
  28     compile. NOTE: you might run into problems if you have this option
  29     compiled in and you switch to a machine running an os < 2.2.x.
  30
  31
  32 Netatalk supplies two different types of Appletalk servers and both
  33 can run at the same time. Classic Appletalk requires afpd and
  34 atalkd. Appletalk over IP only requires afpd.
  35 Classic Appletalk on GNU/Linux requires that CONFIG_ATALK is compiled
  36 into the kernel or as a kernel module. To check to see if the kernel
  37 has Appletalk installed:
  38
  39 $> dmesg | grep Apple
  40 This just parses the boot messages for any line containing
  41 'Apple'.
  42
  43 To see all the  loaded modules (as root):
  44 $> lsmod
  45
  46 If you don't find it, you may have to compile a kernel and turn on
  47 Appletalk in Networking options -> Appletalk DDP. You have an option
  48 to install as a module or directly into the kernel.
  49
  50 Some default distribution kernels have already compiled Appletalk DDP
  51 as a module, you may have to edit your /etc/modules.conf to include:
  52 "alias net-pf-5 appletalk ".
  53
  54 Note: check your distribution documentation about editing
  55 /etc/modules.conf.
  56
  57 For more complete information about the Linux kernel see the
  58 Kernel-HOWTO:
  59 http://www.linuxdoc.org/HOWTO/Kernel-HOWTO.html