This is the README file for netatalk-1.3b.  DO NOT REDISTRIBUTE THIS
SOFTWARE.

Contents:
	    o A Brief Description
	    o Known Problems
	    o Building/Installing
	    o Getting Help

netatalk is an implementation of the AppleTalk Protocol Suite for
BSD-derived systems.  The current release contains support for
EtherTalk Phase I and II, DDP, RTMP, NBP, ZIP, AEP, ATP, PAP, ASP, and
AFP.  The complete stack looks like this:

    AFP
     |
    ASP    PAP
      \   /
       ATP RTMP NBP ZIP AEP
	|    |   |   |   |
   -+---------------------------------------------------+- (kernel boundary)
    |                    Socket                         |
    +-----------------------+------------+--------------+
    |                       |     TCP    |    UDP       |
    |          DDP          +------------+--------------+
    |                       |           IP              |
    +-----------------------+---------------------------+
    |                Network-Interface                  |
    +---------------------------------------------------+

DDP is in the kernel.  "atalkd" implements RTMP, NBP, ZIP, and AEP.  It
is the AppleTalk equivalent of Unix "routed".  There is also a
client-stub library for NBP.  ATP and ASP are implemented as
libraries.  "papd" allows Macs to spool to "lpd", and "pap" allows Unix
machines to print to AppleTalk connected printers.  "psf" is a
PostScript printer filter for "lpd", designed to use "pap".  "psorder"
is a PostScript reverser, called by "psf" to reverse pages printed to
face-up stacking printers.  "afpd" provides Macs with an interface to
the Unix file system.  Refer to the appropriate man pages for
operational information.

netatalk-1.3 beta runs on two operating systems:

	OS	Versions	Hardware	Notes
	--	--------	--------	-----
	SunOS	4.1+		Sparc		kernel must have VDDRV
						option installed
	Ultrix	4.[1-3]		3100,5000

Some code is still missing.  If I haven't integrated your changes, feel
free to ask me about them.  Things that don't work yet:

	o afpd
	    - unix quotas
	    - spurious "trash can" warnings
	    - file locking
	    - kerberos byte ordering
	    - guest login symantics

	o atalkd
	    - rewriting config file
	    - rtmp rdr
	    - zip notify

	o kernel
	    - unnecessary probes

Building netatalk:  (Note: To make afpd for use with AFS, follow the
instructions in README.AFS before completing these instructions.)

1.  Set DESTDIR in the root Makefile.  DESTDIR is the directory below
    which all binaries will be installed.  Setting it causes all
    installation-relative pathnames to be set correctly.  You may also
    wish to set MANDIR.

2.  Look in include/atalk/paths.h.  This file contains non-relative
    pathnames which you may need to set.  Check and set all pathnames.
    Pay particular attention to:

	_PATH_TROFF2PS          Called by psf (see etc/psf/README for
				more information) to convert troff
				input to PostScript

	_PATH_PAPDSPOOLDIR      Default directory for input to "papd",
				should be set the same as the default
				spool directory for "lpd"

	_PATH_PAPDPROCSETS      Directory where Macintosh LaserPreps
				are stored

3.  When you've completed the configuration, type "make" at the root of
    the source.  This will make all binaries.

Installing netatalk:

1.  To install the binaries, type "make install" at the root of the
    source tree.  This will install all of the binaries in the
    directory specified by DESTDIR.

2.  Sample config files for the daemons are in each daemons' source
    directory.  You may wish to install these files in DESTDIR/etc.
    Each file includes comments.  (NOTE: Pre-1.3 atalkd.conf won't
    work, as the syntax has changed.)

3.  Add the contents of services.atalk to your /etc/services database.
    If you're using NIS (YP), add the contents of services.atalk to the
    NIS master's maps and push them.

4.  The file rc.atalk is installed in DESTDIR/etc.  It should be called
    from your /etc/rc file, e.g "sh DESTDIR/etc/rc.atalk".  For more
    information on what this script does, read the man pages for the
    appropriate commands.

Instructions for installing the kernel portions of netatalk are in the
README file for your system, e.g. README.SUN, README.ULTRIX.

We have set up two mailing lists.  The first is for you to get help.
It is called netatalk@umich.edu.  Send any questions, comments, or
problems you have with netatalk to this list.  We will do our best to
help you.

The second list carries announcements of new releases and general
discussion.  You can join (or resign from) this list by sending mail to
netatalk-admins-request@umich.edu.  Submissions (not requests to join
or resign) to this list should be sent to netatalk-admins@umich.edu.

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
