--- /dev/null
+Netatalk Frequently Asked Questions
+($Id: FAQ,v 1.1 2001-03-06 19:32:48 lancel Exp $)
+
+Compilation -----------------------------------------------------------------
+
+Installation ----------------------------------------------------------------
+
+Execution -------------------------------------------------------------------
+
+Q: I get a "socket: Invalid argument" error when trying to start netatalk
+ under Linux. What is causing this?
+A: The "appletalk" and "ipddp" kernel modules have to be installed under
+ linux for netatalk to function. The appletalk module can be automatically
+ loaded by adding the line "alias net-pf-5 appletalk" to the
+ /etc/modules.conf file. Issuing the command "modprobe (module)" will
+ load the module for the current session.
+
+Q: netatalk works over Appletalk, but my IP connections are refused, even
+ though I have enabled them in the configuration files.
+A: If tcp_wrappers support is compiled into netatalk, access has to be
+ granted in /etc/hosts.allow for netatalk to successfully accept IP
+ connections. This can be done by the addition of the line:
+ afpd: 127. xxx.xxx.xxx. (whatever other subnets)
+
--- /dev/null
+$Id: README,v 1.1 2001-03-06 19:32:48 lancel Exp $
+
+This is the README file for netatalk.
+
+Contents:
+ o A Brief Description
+ o Building & Installing
+ o Getting Help
+
+netatalk is an implementation of the AppleTalk Protocol Suite. 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 on a BSD-derived system:
+
+ 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 runs on five operating systems:
+
+ OS Versions Hardware Notes
+ -- -------- -------- -----
+ Solaris 2.5 Sparc
+ Linux 1.3.x,2.x PC
+ FreeBSD 2.2-current PC after 12 Sept 96
+ SunOS 4.1+ Sparc kernel must have VDDRV
+ option installed
+ Ultrix 4.[1-4] 3100,5000
+
+Instructions for installing the kernel portions of netatalk and system
+dependent FAQs are in the README file for your system, e.g.
+INSTALL/README.SUNOS, INSTALL/README.ULTRIX.
+
+Building netatalk (versions up to 1.4b2+asun2.1.4):
+
+0. To build afpd for use with an AFS filesystem, first follow the
+ instructions in INSTALL/README.AFS, then complete 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. (If you do not want all binaries to go under
+ DESTDIR, you can instead set SBINDIR, BINDIR, ETCDIR, and LIBDIR,
+ to control the locations of the individual sections.)
+
+2. When you've completed the configuration, type "make" at the root of
+ the source. This will make all binaries.
+
+Building netatalk (1.5 and up):
+
+0. Be sure to have the following utilities installed before attemping
+ to build netatalk (*=required, +=optional):
+ * GNU autoconf
+ * GNU automake
+ * GNU libtool
+ * GCC or another ANSI C compliant compiler
+ + OpenSSL or another SSL library to enable crypto support
+ + tcp_wrappers to enable IP filtering support
+
+1. Run "./configure --help" to give a list of all of the available
+ configuration options. You can then use "./configure (options)" to
+ generate the build structure for netatalk. This system will
+ automatically determine many things about your system to aid in the
+ build process.
+
+2. Type "make all" at the root of the source to build everything.
+
+Installing netatalk (versions up to 1.4b2+asun2.1.4):
+
+1. To install the binaries, type "make install" at the root of the
+ source tree. This will install all of the binaries.
+
+2. Sample config files for the daemons are in the config directory,
+ e.g. config/AppleVolumes.system. Install these files, or a version
+ of these files, in ETCDIR (as distributed DESTDIR/etc), e.g.
+ ETCDIR/AppleVolumes.system. See the daemon's man page for a
+ description of it's configuration file.
+
+3. psf uses the script SBINDIR/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 ETCDIR. It should be called
+ from your /etc/rc file, e.g. "sh ETCDIR/rc.atalk". For more
+ information on what this script does, read the man pages for the
+ appropriate commands.
+
+Installing netatalk (1.5 and up):
+
+1. Type "make install" or "make install-strip" to install binaries on
+ the system. To install in a "fake" tree (like installing all /etc
+ files in /var/tmp/tree/etc and all /usr files in /var/tmp/tree/usr),
+ use "make DESTDIR=(path) install" or "make DESTDIR=(path) install-strip".
+
+2. 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.
+
+Please read the FAQ for netatalk if you are having problems
+
+You might be interested in looking at the netatalk home page at
+http://www.umich.edu/~rsug/netatalk, which contains netatalk information
+up to version 1.4b2. It has an archive of patches, trouble shooting
+hints, and some links to other netatalk and file service related sites.
+
+For more recent information on netatalk, visit the homepage at
+http://netatalk.sourceforge.net/
+
+Development is currently carried out on the netatalk-devel list on
+sourceforge (netatalk-devel@lists.sourceforge.net).
+
+You may wish to join the netatalk-admins@umich.edu (moderated) mailing
+list. It 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
+
+Amended 07 Feb 2001 jeff b <jefF@univrel.pr.uconn.edu>
--- /dev/null
+this version of netatalk represents changes i have made to incorporate
+AFP 2.2 (AppleShare TCP/IP) support. it is based upon 1.4b2 and is not
+currently supported by umich. i hope to eventually get it incorporated
+into a future version.
+
+i hope you find this code useful. as such, i am releasing my changes
+under a copyright similar to the rest of the netatalk code.
+
+i would appreciate users of my patches letting me know of any problems
+or difficulties they have with it. i can only tested it on a limited
+number of machines. as a result, improved compatability and fixes can
+only come if i hear of problems. you can find my patches at
+<ftp://ftp.cobaltnet.com/pub/users/asun>.
+
+the patches currently include the following features:
+ AFP/TCP
+ 64-bit clean
+ large volume support -- you'll need at least 3.7.2seed3
+ and os > 7.6.1 for this to to be used.
+
+ If your compiler can't generate 64-bit
+ ints, you'll need to disable this
+ feature. add -DNO_LARGE_VOL_SUPPORT to
+ the DEFS line in your system's
+ Makefile. NOTE: gcc can generate
+ 64-bit ints.
+
+ ADDITIONAL NOTE: gcc sometimes has
+ problems with 64-bit ints. i already
+ have a workaround in the code to deal
+ with this issue.
+
+ server messages -- at this point, there is no mechanism to send
+ an arbitrary server message.
+
+ all of AFP 2.2. All of AFP 2.1 except for FPCatSearch is
+ is implemented if fixed id support is compiled in.
+
+ tcp wrapper support. if TCPWRAPDIR is uncommented in the
+ main Makefile, tcp wrapper support will get built.
+ i recommend building w/ it to enable host restrictions.
+
+ a number of bug fixes (SO_BROADCAST, server info, file/dir
+ case insensitive comparisons, and more probably)
+
+ working quota support for linux and bsd4.4. nfs rquota support
+ is also available. it hasn't been extensively tested on all
+ the platforms yet. NOTE: there's bug in the linux kernel code
+ pre-2.2.8 and pre-2.0.37 that prevents quota support from working
+ properly under linux.
+
+ you can now specify server options in an afpd.conf file. it's
+ pretty useless unless you want to start multiple servers up.
+ anyways, look at config/afpd.conf to see what's available.
+ in addition, you can use kill -HUP to force a re-read of
+ afpd.conf. as the first kill -HUP turns off connections,
+ you'll have to send another one to force a re-read.
+
+ i've also merged a slightly modified version of redhat's pam
+ patches. you need to make sure that the PAMDIR entry in the main
+ Makefile is uncommented and pointing to the right directory for
+ this to work. in case you don't know what pam is, it stands for
+ pluggable authentication modules. for more information, here's
+ a web page: <http://www.redhat.com/linux-info/pam/>
+
+ i've merged in <shirsch@ibm.net>'s apple II ProDOS support.
+
+ i've added Randnum and 2-Way Randnum support. part of the code is
+ compliments of<shirsch@ibm.net>. as afp doesn't do the
+ fallback thing in case of failure, Randnum and 2-Way Randnum
+ are only available via afpd.conf. To get them to work, each
+ user must have a ~/.passwd file (not read-/writeable by anyone
+ else) with a password. this is a potential security problem as
+ root can read the password. this may be compensated, to some
+ extent, by the fact that your password never goes onto the wire
+ when mounting a volume.
+
+ NOTE: you will need to get a copy of the des library if you
+ don't already have one for this option to work. i got mine
+ from <ftp://ftp.psy.uq.oz.au/pub/Crypto/DES/libdes-x.xx.tar.gz>
+
+ A Diffie-Hellman-based UAM is also available. This requires
+ libcrypto from either the SSLeay package (available at the
+ above site) or OpenSSL (ftp.openssl.org).
+
+ ADDITIONAL NOTE: the absence of a /dev/urandom or running out
+ of entropy will result a non truly-random number being used as
+ the challenge. you have been warned. for all intents and
+ purposes, however, linux' /dev/urandom should provide a
+ sufficiently random number to be considered secure even when
+ the entropy pool gets drained. it certainly does a much better
+ job than gettimeofday(); random().
+
+ the bad file descriptor bug should now be fixed. thanks to
+ bsmith@h-e.com for tracking this down.
+
+ this patchset should not have a problem with "dancing icons."
+ if you are still having a problem with this, it's highly
+ likely that files in your .AppleDouble directory have gotten
+ corrupted.
+
+ you can now login in with your "real" user name as specified
+ in your password entry. if you don't want to do this, just add
+ -DNO_REAL_USER_NAME to your DEFS line.
+
+ byte locks should now work. if you want to enable the old way
+ of doing things, add -DUSE_FLOCK_LOCKS.
+
+ you can now specify whether or not you want uservolume files
+ to be read. add -nouservol to afpd.conf if you don't want user-
+ specified .AppleVolumes files to be read.
+
+ afpd now will report the number of kilobytes read/written during
+ a session (from the server's perspective).
+
+ i have merged against netatalk-990130. this includes an
+ improved STREAMS driver and some changes to libatalk. the
+ STREAMS driver still doesn't do setsockopt correctly, but it's
+ supposed to be much more stable. contact the folks at umich if
+ you have questions about it.
+
+ fixed a problem with sys/netatalk/ddp_input.c reported by
+ <abs@anim.dreamworks.com>.
+
+ AppleVolumes.* now has many more configuration options. You
+ can specify newline translation (crlf) on a per-volume basis,
+ utilize a codepage translation file for compatibility with
+ other file serving programs, and restrict access to particular
+ volumes. Please read config/AppleVolumes.default for more
+ information.
+
+platforms compiled on:
+ linux/intel,sparc
+ linux/axp
+ *bsd
+ sunos4.1.4/sparc
+ ultrix/mips
+ solaris 2.5.x, 2.6, and 2.7.
+
+problems with appletalk:
+ certain ethernet card/drivers don't deal well with the fact
+ that appletalk aggressively uses hardware multicast. here are
+ a few ones that may cause problems:
+ ne2000 clones
+ 3Com501 cards (maybe others)
+ intel etherexpress/pro
+ set multicast_filter_limit=3 in linux if you're having
+ problems with this card. to do that, add the following
+ line to /etc/conf.modules:
+ options eepro100 multicast_filter_limit=3
+
+Acknowledgements:
+ i would like to thank leland wallace at apple for a lot of
+ helpful advice on interpreting the appleshare ip documentation.
+
+ i would also like to thank the numerous people who have helped
+ test this program. they greatly improved the compatability of
+ the code.
+
+ REALM Information provided financial support for the
+ AppleDouble v2 and CNID database work.
+
+adrian sun
+asun@cobaltnet.com
projects / netatalk.git / commitdiff