aklog-obsd-20051221
[openafs.git] / README
diff --git a/README b/README
index ee7c8b6..ad359bf 100644 (file)
--- a/README
+++ b/README
@@ -33,28 +33,23 @@ A. Creating the proper directory structure.
       alpha_dux40
       alpha_dux50 (only tested on 5.0A, does not work with 5.1)
       i386_fbsd_42, i386_fbsd_43, i386_fbsd_44, i386_fbsd_45,
-             i386_fbsd_46, i386_fbsd_47, i386_fbsd_50, i386_fbsd_51,
-             i386_fbsd_52
-      i386_linux22
-      i386_linux24
-      i386_umlinux22
-      i386_umlinux24
-      i386_obsd31, i386_obsd32, i386_obsd33, i386_obsd34
+         i386_fbsd_46, i386_fbsd_47, i386_fbsd_50, i386_fbsd_51,
+         i386_fbsd_52, i386_fbsd_53, i386_fbsd_60
+      i386_linux22, i386_linux24, i386_linux26
+      i386_umlinux22, i386_umlinux24
+      i386_obsd31, i386_obsd32, i386_obsd33, i386_obsd34, i386_obsd35,
+         i386_obsd36, i386_obsd37, i386_obsd38
       rs_aix42
       sgi_65 (file server not tested)
       sun4_413 (No client support, no fileserver support, db servers only)
       sun4x_56, sun4x_57, sun4x_58, sun4x_59 (logging UFS not supported 
-             for mixed-use partitions containing client cache)
-      ppc_darwin_13, ppc_darwin_14, ppc_darwin_60 (file server not tested)
-      ppc_linux22
-      ppc_linux24
-      alpha_linux22 
-      alpha_linux24 
-      ia64_linux24
-      sparc_linux22
-      sparc_linux24
-      sparc64_linux22
-      sparc64_linux24
+         for mixed-use partitions containing client cache)
+      ppc_darwin_70
+      ppc_linux22, ppc_linux24
+      alpha_linux22, alpha_linux24 
+      ia64_linux24, ia64_linux26
+      sparc_linux22, sparc_linux24
+      sparc64_linux22, sparc64_linux24
       hp_ux110 (See notes below for information on getting missing header)
       hp_ux102 (Client port possible, but db servers and utilities work)
 
@@ -62,16 +57,9 @@ A. Creating the proper directory structure.
       AFS system type, providing the necessary flags:
       % ./configure --with-afs-sysname=sun4x_58 --enable-transarc-paths
 
-      For Linux systems you need also provide the path in which your
-      kernel headers for your configured kernel can be found. This should
-      be the path of the directory containing a child directory named
-      "include". So if your version file was 
-      /usr/src/linux/include/linux/version.h you would invoke:
-      % ./configure --with-afs-sysname=i386_linux24 --with-linux-kernel-headers=/usr/src/linux
-
-      Currently you can build for only one Linux kernel at a time,
-      and the version is extracted from the kernel headers in the root
-      you specify.
+      For some systems you need also provide the path in which your kernel
+      headers for your configured kernel can be found.  See the
+      system-specific Notes sections below for details.
 
       Be prepared to provide the switches --enable-obsolete and
       --enable-insecure if you require the use of any bundled but obsolete
@@ -132,9 +120,20 @@ C  Problems
 
 D  Linux Notes
 
+   For Linux systems you need also provide the path in which your
+   kernel headers for your configured kernel can be found. This should
+   be the path of the directory containing a child directory named
+   "include". So if your version file was 
+   /usr/src/linux/include/linux/version.h you would invoke:
+   % ./configure --with-afs-sysname=i386_linux24 --with-linux-kernel-headers=/usr/src/linux
+
+   Currently you can build for only one Linux kernel at a time,
+   and the version is extracted from the kernel headers in the root
+   you specify.
+
    To build for another Linux kernel version:
    the system type defined in step A1.
-      % ./configure --with-afs-sysname=i386_linux22 --with-linux-kernel-headers=/usr/src/linux-2.2.19-i686
+      % ./configure --with-afs-sysname=i386_linux24 --with-linux-kernel-headers=/usr/src/linux-2.2.19-i686
       % make 
 
    Your dest tree will now include an additional kernel module for your
@@ -155,6 +154,12 @@ E  HP-UX 11.0 Notes
 
 F  OpenBSD Notes
 
+   We recommend you build with the following options to configure:
+     --enable-namei-fileserver
+     --enable-largefile-fileserver
+     --enable-supergroups
+     --with-krb5
+
    You need kernel source installed to build OpenAFS.  Use the
    --with-bsd-kernel-headers= configure option if your kernel source is not
    in /usr/src/sys.
@@ -162,7 +167,8 @@ F  OpenBSD Notes
    There is a package builder in src/packaging/OpenBSD.  "sh buildpkg.sh"
    should make a package for the client.  Use pkg_add to install.  The
    package will install using transarc-paths, regardless of how you
-   configured.
+   configured.  The package builder does not work on OpenBSD 3.5 and later
+   due to the incompatible re-write of pkg_create.
 
    There is no server package, but I am told that "make install" will put
    server binaries in /usr/afs.
@@ -178,6 +184,9 @@ G  FreeBSD Notes
    The FreeBSD client is very new and untested.  Do not trust it for
    production work.
 
+   We recommend you build with --enable-namei-fileserver and
+   --enable-largefile-fileserver options.
+
    You need kernel source installed to build OpenAFS.  Use the
    --with-bsd-kernel-headers= configure option if your kernel source is not
    in /usr/src/sys.
@@ -186,8 +195,12 @@ G  FreeBSD Notes
    include file.  Use the --with-bsd-kernel-build= configure option if your
    kernel build is not GENERIC in the standard place.
 
-   There is no client package, but you may be able to modify the OpenBSD
-   package builder (see "OpenBSD Notes" above) or install by hand.
+   There is a package builder in src/packaging/OpenBSD.  "sh buildpkg.sh"
+   should make a package for the client.  Use pkg_add to install.  The
+   package will install using transarc-paths, regardless of how you
+   configured.  The builder uses an old version of the /usr/vice/etc/rc file
+   that probably won't work.  You might be able to replace it with something
+   like "kldload libafs.ko; /usr/vice/etc/afsd".
 
    There is no server package, but I am told that "make install" will put
    server binaries in /usr/afs.