This is the README file for netatalk-1.3.3.

Contents:
	    o A Brief Description
	    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 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
	Linux	1.3.x		PC

Building netatalk:

0.  To build afpd for use with an AFS filesystem, 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.  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, e.g. etc/afpd/etc.afpd.conf.  You may wish to install
    these files in DESTDIR/etc, e.g. DESTDIR/etc/afpd.conf.  See the
    daemon's man page for a description of the configuration file.
    Each file also includes comments.  (NOTE:  Pre-1.3 atalkd.conf
    won't work, as the syntax has changed.)

3.  psf uses the script DESTDIR/etc/etc2ps to convert anything it
    doesn't understand to PostScript.  If you have a troff or dvi to
    PostScript filter on your machine, you might wish to edit etc2ps,
    to use your locally installed PostScript utilities.

4.  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.

5.  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.

You might be interested in looking at the netatalk home page at
http://www.umich.edu/~rsug/netatalk.  It has an archive of patches,
trouble shooting hints, and some links to other netatalk and file
service related sites.

We have set up two mailing lists.  The first is for you to get help and
report bugs.  It is called netatalk@umich.edu.  If you're reporting
bugs, you MUST use the format provided in the BUGS file!  We will do
our best to help you.

The second (moderated) 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
