+++ /dev/null
-# Makefile.am for INSTALL/
-
-EXTRA_DIST = README.AFS README.FREEBSD README.GENERIC README.LINUX README.NETBSD README.OPENBSD README.SOLARIS README.SUNOS README.ULTRIX
+++ /dev/null
-This is the AFS README file for netatalk.
-
-NOTE: You'll need to have the AFS server libraries and include files.
-These are different than the client libraries and include files. Also,
-you will need the Kerberos v4 (patch level 10) libraries and include
-files.
-
-1. CONFIGURE FOR AFS. Edit the root Makefile to include the pathname
- to both the AFS and Kerberos libraries and include files. There
- are brief instructions at the top of the Makefile.
-
-2. ADD AFP PRINCIPAL TO YOUR SRVTAB. afpd requires an entry in your
- /etc/srvtab to do Kerberos authentication. This entry is of the
- form
-
- afpserver.NBPNAME@REALM
-
- So, if you want your afp server to be called "bob" and your realm
- is "camelot", you would need a principal
-
- afpserver.bob@camelot
-
- If you don't have an incorrect /etc/srvtab, Macs attempting to
- authenticate with "Kerberos IV UAM"/"AuthMan UAM" will get a
- "remote configuration" error and afpd will log "krb4_logincont:
- krb_rd_req: Can't decode authenticator". NOTE: nbpname MUST match
- the kerberos principal name in order for authentication to
- succeed. If afpd's default nbpname (see the afpd man page) does
- not match your site's method for generating principal names, then
- you must use the "-n" option when starting afpd.
-
-3. CLIENT SOFTWARE. There are several pieces of Mac software that you
- will need. The first, "AuthMan UAM", is an alternate UAM which
- does authentication with afpd for AFS. AuthMan UAM requires the
- second, AuthMan. AuthMan requires MacTCP. The third, AFS
- Privileges, allows the Mac user to display the AFS acls on afp
- mounted directories. "AuthMan UAM" and "AFS Privileges" are
- available via anonymous ftp from terminator.rs.itd.umich.edu in
- ~ftp/unix/netatalk/kerberos-AFS.sit.hqx. AuthMan is available via
- anonymous ftp from monet.ccs.itd.umich.edu in ~ftp/pub. The
- revision as of this writing is 1.0.9A.
-
-4. AFS HELP. For more information about AFS, you should contact
- afs-sales@transarc.com.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wesley Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the FreeBSD README file for netatalk.
-
-Note that kernel support for netatalk appears in FreeBSD 2.2-current
-dated after 12 September 1996.
-
-1. KERNEL. Add the line
-
- options NETATALK
-
- to the config file for your kernel. Rebuild and install your
- kernel. Reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-The generic system profile is for use on systems that don't have native
-appletalk support. For those systems, it should still be possible to get
-the AFP/tcp portion of netatalk to still work.
-
-To do that, you will need the following information:
- 1) Endian order: If your machine does not specify the
- byte-order in netinet/in.h, you may need to modify
- netatalk/endian.h.
-
- 2) Integer sizes: If your machine does not define intX_t and
- u_intX_t, you will need to define them in
- netatalk/endian.h. To ease matters, you can specify
- _ISOC9X_SOURCE if you have inttypes.h, HAVE_64BIT_LONGS for
- 64 bit machines, or HAVE_32BIT_LONGS for 32 bit
- machines. NOTE: you should only use HAVE_32/64BIT_LONGS on
- machines that don't have a header file somewhere with the
- integer sizes. If you have a file with all the relevant
- bits, modify netatalk/endian.h to include it.
-
- 3) Quota/statfs information: You may be able to get away with
- either BSD4_4 or __svr4__, but that's unlikely if your os
- is some bizarre hybrid. If you don't have quota support,
- just specify NO_QUOTA_SUPPORT. In addition, if you'll need
- to specify the include file that gets statfs() (usually
- either USE_VFS_H or USE_STATFS_H although BSD4_4 and
- __svr4__ bring in a set of include files for that). Look at
- etc/afpd/quota.c, unix.c, and unix.h for more information.
- Finally, if you have a really old version of rquota, you
- can define USE_OLD_RQUOTA as well.
-
- 4) path information for lock/spool/printer files. you'll need
- to specify -D_PATH_LOCKDIR if include/atalk/paths.h doesn't
- have the correct paths specified for printer info and lock
- files.
-
-Beyond that, you should make sure that your operating system looks and
-smells like a Un*x POSIXy operating system. The only operating systems
-that netatalk supports that don't quite fit that description are
-sunos 4 and ultrix. If your operating system is peculiar, you may need
-to add in compatibility routines (libatalk/compat,
-include/atalk/compat.h) to make it look more like the others.
-
-If you would like native AppleTalk support, you will need kernel support
-for your operating system. Look at the Solaris STREAMS module if your
-operating system supports that framework. Otherwise, look at the ddp
-code in FreeBSD, NetBSD, or OpenBSD if your operating system is BSDish
-in nature. If your operating system looks different than these two
-cases, you'll have to roll your own implementation.
-
+++ /dev/null
-This is the Linux README file for netatalk.
-
-We no longer include linux kernel code with netatalk, since Linux now
-includes AppleTalk support.
-
-1. UIO.H. On older versions of Linux, you may need to make a link from
- /usr/include/sys/uio.h to ../linux/uio.h. In particular, this file
- changed from linux 1.2.x to 1.3.x, so if, for instance, you've
- installed Slackware 3.0.0, and upgraded your kernel to 1.3.x,
- you'll need to fix this.
-
-2. MAKE CONFIG. Configure your kernel with "make config". Answer yes
- to "AppleTalk DDP" support.
-
-3. INSTALL KERNEL. Make and install your kernel. Be sure to update
- your boot blocks!
-
-4. If you are using libc.so.5, you will need to comment out the
- -lcrypt and the -lrpcsvc in sys/linux/Makefile. If you're using PAM,
- make sure you declare -DUSE_PAM and have -lpam -ldl.
-
-5. Quota support should work under linux now. If you're using glibc
- 2.x or libc > 5.4.34, you can comment out the
- -DNEED_QUOTACTL_WRAPPER in sys/linux/Makefile.
-
-6. Linux 2.2.x provides the sendfile() call. This reduces overhead
- when sending/copying files. This option will be autoconfigured on
- compile. NOTE: you might run into problems if you have this option
- compiled in and you switch to a machine running an os < 2.2.x.
-
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the NetBSD README file for netatalk.
-
-Note that kernel support for netatalk appears in NetBSD 1.3, and in
-NetBSD 1.2D dated after April 5, 1997.
-
-1. KERNEL. If not already present, add the line
-
- options NETATALK
-
- to the config file for your kernel. Rebuild and install your
- kernel. Reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the OpenBSD README file for netatalk.
-
-Note that kernel support for netatalk appears in OpenBSD 2.2, or
-openbsd-current dated after Aug 1, 1997.
-
-1. KERNEL. Add the line
-
- options NETATALK
-
- to the config file for your kernel. Rebuild and install your
- kernel. Reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the Solaris README file for netatalk.
-
-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.
-
- 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
-
- make kinstall
-
- to install the driver. This copies the driver and it's 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.
-
-4. 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.
-
- le0
-
- on a line by itself, on many Suns. See atalkd(8).
-
-5. PRINTING. To quote my Solaris documentation, "Setting up printing
- services using the LP print service command-line interface is
- complicated and error-prone." See your Solaris documentation for
- similarly helpful statements.
-
- Presuming that the Solaris print filters are installed (see your
- helpful Solaris documentation), the following command adds the
- printer named "bob" your to system and enables printing:
-
- lpadmin -p bob -i /usr/local/atalk/etc/lp2pap.sh \
- -I postscript -v /dev/null -T PS
- enable bob
-
- This creates the directory /etc/lp/bob, in which you should create
- a file called ".paprc" containing the NBP name of the printer. See
- the "pap" man page for more information.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the SunOS README file for netatalk.
-
-1. KERNEL MODULE. This version of netatalk requires that your kernel
- be configured with
-
- options VDDRV
-
- The loadable kernel module is made and installed during the normal
- make and make install. NOTE: Unloading the kernel module may not
- work correctly and may cause your kernel to panic, hang, or do
- other nasty things.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wesley Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the Ultrix README file for netatalk.
-
-1. REMOVE PREVIOUS NETATALK. If this is the first release of netatalk
- you've used, skip to step (2). If you've installed netatalk
- before, you will need to remove the old patches.
-
- There are two easy ways to remove the old patches. The simplist,
- is to apply the old patches in reverse. E.g. for netatalk-1.3 or
- later
-
- patch -s -d /sys -R -p0 < sys/ultrix/kpatch-<vers>
-
- Note that the old patches are not included in this distribution.
-
- If you haven't saved the old patches, it is possible that the old
- versions of the patched files are still in your file system. When
- patch changes a file, it saves the original file as <file>.orig.
- netatalk-1.3 or later leaves these files
-
- conf/files
- data/af_data.c
- data/if_to_proto_data.c
- data/uipc_domain_data.c
- net/net/conf_net.c
- net/net/netisr.h
-
- Finally, if there is no way to regenerate the old version of the
- patched files, you can apply the new patches by hand, skipping the
- next section. There are two versions of the patches, kpatch-4.1
- for Ultrix 4.1 and kpatch-4.2 for both 4.2 and 4.3.
-
-2. PATCH FILES IN KERNEL BUILDING AREA. The simplest way to install the
- kernel patches is with the command
-
- make kpatch
-
- This command will determine your system type and apply patches to
- the following files
-
- conf/files
- data/af_data.c
- data/if_to_proto_data.c
- data/uipc_domain_data.c
- net/net/conf_net.c
- net/net/netisr.h
-
- To apply these patches by hand, type
-
- patch -s -d /sys -p0 < sys/ultrix/kpatch-<vers>
-
- where <vers> is the version of Ultrix you are running.
-
-3. POPULATE /sys/net/netatalk. Do this with
-
- make kinstall
-
- This makes a directory called /sys/net/netatalk and copies all
- pertinent files. To do this by hand,
-
- mkdir /sys/net/netatalk
- cp sys/netatalk/*.[ch] /sys/net/netatalk
- cp sys/ultrix/*.[ch] /sys/net/netatalk
-
- These files are the complete source for AppleTalk in 4.3BSD kernels
- and Ultrix.
-
-4. CREATE KERNEL. You should probably start by copying the config file
- for GENERIC to, for instance, NETATALK. You'll need to add the
- lines
-
- options ATALK
- pseudo-device atalk
-
- to the NETATALK config file, config the kernel, and then make. You
- don't have to call your kernel NETATALK, but be sure NOT to call it
- ATALK, since the name of the kernel and kernel options are part of
- the same name-space. When your build is finished, save your old
- kernel, install the new kernel, and reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943