cosmetic: use ad_close_metadata after ad_metadata

[netatalk.git] / doc / README.platforms

diff --git a/doc/README.platforms b/doc/README.platforms
index 6b29299180195317cf95378499b91d3e58c8e2e4..10e823b6bd0eab47c1f3bd87959db65a09fd12bc 100644 (file)
--- a/doc/README.platforms
+++ b/doc/README.platforms
@@ -1,12 +1,13 @@
 This is a README for the major platforms where Netatalk is in use. 
 
 Platforms Covered:
-A. Linux
-B. Tru64
-C. Solaris
-D. *BSD
-E. SunOS
-F. Generic
+A.   Linux
+B.   Tru64
+C.   Solaris
+D.I  OpenBSD
+D.II Other BSDs
+E.   SunOS
+F.   Generic
 
 ----------------------------------------------------------------
 
@@ -57,6 +58,9 @@ For more complete information about the Linux kernel see the
 Kernel-HOWTO:
 http://www.linuxdoc.org/HOWTO/Kernel-HOWTO.html
 
+A note for RedHat users: You may need to install the glibc-devel
+package to be able to compile Netatalk correctly.
+
 ----------------------------------------------------------------
 
 B. TRU64
@@ -108,7 +112,7 @@ This is the Tru64 README file for netatalk.
     and is enough to stop the bug from occurring. This is the easiest
     workaround and would merely alter the standard compilation steps to
 
-    ./configure --with-cflags="-DHAVE_GCC_MEMCPY_BUG"
+    CFLAGS="-DHAVE_GCC_MEMCPY_BUG" ./configure [...]
     make
     make install
 
@@ -123,10 +127,10 @@ C. SOLARIS
 
 1.  SELECT COMPILER.  This distribution is configured to build with
     gcc.  It should also work with cc. At the present time only cc
-    v5.0 and above can build the 64-bit kernel module.
+    v5.0 and gcc 3.1 and above can build the 64-bit kernel module.
 
-1a. SELECT KERNEL TYPE.  Edit sys/solaris/Makefile and set KCFLAGS to
-     include sparcv9 support if you run a 64-bit kernel, or leave it
+1a. SELECT KERNEL TYPE.  Edit sys/solaris/Makefile.kernel and set KCFLAGS
+     to include sparcv9 support if you run a 64-bit kernel, or leave it
      commented out for a 32-bit kernel. Only UltraSPARC systems
      running Solaris 7 and above support a 64-bit kernel. If you're
      not sure what kernel you use, run "isainfo -v". You're running a
@@ -148,7 +152,7 @@ C. SOLARIS
 3.  INSTALL DRIVER.  Since the STREAMS ddp driver must be installed as
     root, we've separated that portion of the build.  Type
 
-       make kinstall
+       make -f Makefile.kernel kinstall
 
     to install the driver.  This copies the driver and its config file
     into /usr/kernel/drv and /usr/kernel/strmod, runs "add_drv ddp" to
@@ -157,7 +161,8 @@ C. SOLARIS
     If you see something like
       devfsadm: driver failed to attach: ddp
       Warning: Driver (ddp) successfully added to system but failed to attach
-    then recheck sys/solaris/Makefile and/or try a different compiler.
+    then recheck sys/solaris/Makefile.kernel and/or try a different
+    compiler.
 
 4.  ATALKD.CONF.  Under Solaris, you must create atalkd.conf, since
     Solaris provides no method for determining the names of the
@@ -192,12 +197,56 @@ C. SOLARIS
 
 ----------------------------------------------------------------
 
-D. *BSD
+D.I OpenBSD
+
+1.  KERNEL SUPPORT. Note that kernel support for netatalk appears in
+    OpenBSD 2.2,  or openbsd-current dated after Aug 1, 1997. But the
+    'comment out' character must be removed and the kernel must be
+    recompiled.
+
+    The kernel file that needs to be edited is usually located in:
+    /usr/src/sys/conf
+
+    Remove the first comment (#) from this line:
+    # option          NETATALK        # AppleTalk
+
+    Generally this is the GENERIC kernal. If you decide to rename 
+    the kernel, don't forget to go to 
+    /usr/src/sys/arch/<your arch>/conf/NEWNAME, and change the 
+    ../../../conf/GENERIC line to your NEWNAME. See 
+    http://www.openbsd.org/faq/faq5.html for more information on 
+    compiling a new kernel.
+
+2.  STARTING NETATALK. The rc scripts that come with openbsd to
+    start netatalk are specific to an older version of netatalk.
+    So, if you use the initscript provided in a current netatalk's
+    distrib/initscripts directory, you must either add the lines
+    from rc.atalk.bsd by hand into /etc/rc.local (or wherever you
+    want to launch the daemons from) or modify your /etc/rc.local
+    file to read: 
+
+    (currently says)
+
+    # Netatalk stuff
+    if [ -f /etc/netatalk/rc.atalk ]; then
+            . /etc/netatlk/rc.atalk
+    fi
+
+    (change to) 
+
+    # Netatalk stuff
+    if [ -f /etc/rc.atalk ]; then
+            . /etc/rc.atalk
+    fi
+
+    and copy netatalk/distrib/initscripts/rc.atalk.bsd to /etc/rc.atalk.
+
+D.II Other BSDs
 
-Note that kernel support for netatalk appears in FreeBSD 2.2-current
-dated after 12 September 1996.
+1.  KERNEL SUPPORT. Note that kernel support for netatalk appears in
+    FreeBSD 2.2-current dated after 12 September 1996.
 
-1.  KERNEL.  Add the line
+    Add the line
 
         options NETATALK