]> arthur.barton.de Git - netatalk.git/blobdiff - doc/README.platforms
for .xx files don't set invisible bit if create by netatalk
[netatalk.git] / doc / README.platforms
index 6b29299180195317cf95378499b91d3e58c8e2e4..890183a52fe47fa016e2c4dd18493356808604a1 100644 (file)
@@ -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,43 +127,23 @@ 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.
-
-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
-     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
-     64-bit kernel if the result includes 64-bit (sparcv9), otherwize
-     it's 32-bit.
+    v5.0 and gcc 3.1 and above can build the 64-bit kernel module.
 
-     NOTE: If you want both the 32-bit and 64-bit kernel modules to be
-     installed, first compile and install the version appropriate to
-     the kernel that you're currently running, then make clean,
-     compile and install the other version.
-
-2.  EDIT NETCONFIG.  Add the following line to /etc/netconfig:
-
-       ddp tpi_clts - appletalk ddp /dev/ddp -
-
-    This makes the socket library aware of the AppleTalk protocol
-    family.
-
-3.  INSTALL DRIVER.  Since the STREAMS ddp driver must be installed as
-    root, we've separated that portion of the build.  Type
+2.  INSTALL DRIVER.  Since the STREAMS ddp driver must be installed as
+    root, we've separated that portion of the build.  Go to the 
+    sys/solaris directory and type
 
        make 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
-    make the kernel aware of the new driver, and adds an rc file to
-    /etc/rc?.d. Watch out for error messages after it runs  add_drv.
+    make the kernel aware of the new driver.
     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 try a different compiler.
 
-4.  ATALKD.CONF.  Under Solaris, you must create atalkd.conf, since
+3.  ATALKD.CONF.  Under Solaris, you must create atalkd.conf, since
     Solaris provides no method for determining the names of the
     available interfaces.  It is sufficent to name the available
     interfaces in atalkd.conf, one per line.  E.g.
@@ -168,7 +152,7 @@ C. SOLARIS
 
     on a line by itself on many Suns. hme0 on Ultras.  See atalkd(8).
 
-5.  PRINTING.  Netatalk can use any postscript printer that has been set
+4.  PRINTING.  Netatalk can use any postscript printer that has been set
     up for use by Solaris. If you haven't already set up a printer,
     type admintool then select Browse --> Printers, and then Edit --> Add
     and fill in the form for either a local or remote printer. If adding
@@ -192,12 +176,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