+++ /dev/null
-Netatalk Frequently Asked Questions
-($Id: FAQ,v 1.1 2001-02-09 16:08:10 rufustfirefly 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.5 2001-02-27 21:32:10 rufustfirefly 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