From 6a466f564e090a0f00d17536fcb625776b819156 Mon Sep 17 00:00:00 2001 From: lancel Date: Tue, 6 Mar 2001 19:32:48 +0000 Subject: [PATCH] Moved README.ASUN, README, FAQ to ./INSTALL --- INSTALL/FAQ | 24 +++++++ INSTALL/README | 154 +++++++++++++++++++++++++++++++++++++++++ INSTALL/README.ASUN | 164 ++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 342 insertions(+) create mode 100644 INSTALL/FAQ create mode 100644 INSTALL/README create mode 100644 INSTALL/README.ASUN diff --git a/INSTALL/FAQ b/INSTALL/FAQ new file mode 100644 index 00000000..72b3cfde --- /dev/null +++ b/INSTALL/FAQ @@ -0,0 +1,24 @@ +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) + diff --git a/INSTALL/README b/INSTALL/README new file mode 100644 index 00000000..cdb1eaea --- /dev/null +++ b/INSTALL/README @@ -0,0 +1,154 @@ +$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 diff --git a/INSTALL/README.ASUN b/INSTALL/README.ASUN new file mode 100644 index 00000000..ab6aec58 --- /dev/null +++ b/INSTALL/README.ASUN @@ -0,0 +1,164 @@ +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 +. + +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: + + i've merged in 's apple II ProDOS support. + + i've added Randnum and 2-Way Randnum support. part of the code is + compliments of. 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 + + 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 + . + + 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 -- 2.39.2