+++ /dev/null
-This is the AFS README file for netatalk.
-
-NOTE: You'll need to have the AFS server libraries and include files.
-These are different than the client libraries and include files. Also,
-you will need the Kerberos v4 (patch level 10) libraries and include
-files.
-
-1. CONFIGURE FOR AFS. Edit the root Makefile to include the pathname
- to both the AFS and Kerberos libraries and include files. There
- are brief instructions at the top of the Makefile.
-
-2. ADD AFP PRINCIPAL TO YOUR SRVTAB. afpd requires an entry in your
- /etc/srvtab to do Kerberos authentication. This entry is of the
- form
-
- afpserver.NBPNAME@REALM
-
- So, if you want your afp server to be called "bob" and your realm
- is "camelot", you would need a principal
-
- afpserver.bob@camelot
-
- If you don't have an incorrect /etc/srvtab, Macs attempting to
- authenticate with "Kerberos IV UAM"/"AuthMan UAM" will get a
- "remote configuration" error and afpd will log "krb4_logincont:
- krb_rd_req: Can't decode authenticator". NOTE: nbpname MUST match
- the kerberos principal name in order for authentication to
- succeed. If afpd's default nbpname (see the afpd man page) does
- not match your site's method for generating principal names, then
- you must use the "-n" option when starting afpd.
-
-3. CLIENT SOFTWARE. There are several pieces of Mac software that you
- will need. The first, "AuthMan UAM", is an alternate UAM which
- does authentication with afpd for AFS. AuthMan UAM requires the
- second, AuthMan. AuthMan requires MacTCP. The third, AFS
- Privileges, allows the Mac user to display the AFS acls on afp
- mounted directories. "AuthMan UAM" and "AFS Privileges" are
- available via anonymous ftp from terminator.rs.itd.umich.edu in
- ~ftp/unix/netatalk/kerberos-AFS.sit.hqx. AuthMan is available via
- anonymous ftp from monet.ccs.itd.umich.edu in ~ftp/pub. The
- revision as of this writing is 1.0.9A.
-
-4. AFS HELP. For more information about AFS, you should contact
- afs-sales@transarc.com.
-
-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
+++ /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
+++ /dev/null
-This is the FreeBSD README file for netatalk.
-
-Note that kernel support for netatalk appears in FreeBSD 2.2-current
-dated after 12 September 1996.
-
-1. KERNEL. Add the line
-
- options NETATALK
-
- to the config file for your kernel. Rebuild and install your
- kernel. Reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-The generic system profile is for use on systems that don't have native
-appletalk support. For those systems, it should still be possible to get
-the AFP/tcp portion of netatalk to still work.
-
-To do that, you will need the following information:
- 1) Endian order: If your machine does not specify the
- byte-order in netinet/in.h, you may need to modify
- netatalk/endian.h.
-
- 2) Integer sizes: If your machine does not define intX_t and
- u_intX_t, you will need to define them in
- netatalk/endian.h. To ease matters, you can specify
- _ISOC9X_SOURCE if you have inttypes.h, HAVE_64BIT_LONGS for
- 64 bit machines, or HAVE_32BIT_LONGS for 32 bit
- machines. NOTE: you should only use HAVE_32/64BIT_LONGS on
- machines that don't have a header file somewhere with the
- integer sizes. If you have a file with all the relevant
- bits, modify netatalk/endian.h to include it.
-
- 3) Quota/statfs information: You may be able to get away with
- either BSD4_4 or __svr4__, but that's unlikely if your os
- is some bizarre hybrid. If you don't have quota support,
- just specify NO_QUOTA_SUPPORT. In addition, if you'll need
- to specify the include file that gets statfs() (usually
- either USE_VFS_H or USE_STATFS_H although BSD4_4 and
- __svr4__ bring in a set of include files for that). Look at
- etc/afpd/quota.c, unix.c, and unix.h for more information.
- Finally, if you have a really old version of rquota, you
- can define USE_OLD_RQUOTA as well.
-
- 4) path information for lock/spool/printer files. you'll need
- to specify -D_PATH_LOCKDIR if include/atalk/paths.h doesn't
- have the correct paths specified for printer info and lock
- files.
-
-Beyond that, you should make sure that your operating system looks and
-smells like a Un*x POSIXy operating system. The only operating systems
-that netatalk supports that don't quite fit that description are
-sunos 4 and ultrix. If your operating system is peculiar, you may need
-to add in compatibility routines (libatalk/compat,
-include/atalk/compat.h) to make it look more like the others.
-
-If you would like native AppleTalk support, you will need kernel support
-for your operating system. Look at the Solaris STREAMS module if your
-operating system supports that framework. Otherwise, look at the ddp
-code in FreeBSD, NetBSD, or OpenBSD if your operating system is BSDish
-in nature. If your operating system looks different than these two
-cases, you'll have to roll your own implementation.
-
+++ /dev/null
-This is the Linux README file for netatalk.
-
-We no longer include linux kernel code with netatalk, since Linux now
-includes AppleTalk support.
-
-1. MAKE CONFIG. Configure your kernel with "make config". Answer yes
- to "AppleTalk DDP" support.
-
-2. INSTALL KERNEL. Make and install your kernel. Be sure to update
- your boot blocks!
-
-3. Linux 2.2.x provides the sendfile() call. This reduces overhead
- when sending/copying files. This option will be autoconfigured on
- compile. NOTE: you might run into problems if you have this option
- compiled in and you switch to a machine running an os < 2.2.x.
-
-
-Netatalk supplies two different types of Appletalk servers and both
-can run at the same time. Classic Appletalk requires afpd and
-atalkd. Appletalk over IP only requires afpd.
-
-Classic Appletalk on GNU/Linux requires that CONFIG_ATALK is compiled
-into the kernel or as a kernel module. To check to see if the kernel
-has Appletalk installed:
-
-$> dmesg | grep Apple
-This just parses the boot messages for any line containing
-'Apple'.
-
-To see all the loaded modules (as root):
-$> lsmod
-
-If you don't find it, you may have to compile a kernel and turn on
-Appletalk in Networking options -> Appletalk DDP. You have an option
-to install as a module or directly into the kernel.
-
-Some default distribution kernels have already compiled Appletalk DDP
-as a module, you may have to edit your /etc/modules.conf to include:
-"alias net-pf-5 appletalk ".
-
-Note: check your distribution documentation about editing
-/etc/modules.conf.
-
-For more complete information about the Linux kernel see the
-Kernel-HOWTO:
-http://www.linuxdoc.org/HOWTO/Kernel-HOWTO.html
+++ /dev/null
-This is the NetBSD README file for netatalk.
-
-Note that kernel support for netatalk appears in NetBSD 1.3, and in
-NetBSD 1.2D dated after April 5, 1997.
-
-1. KERNEL. If not already present, add the line
-
- options NETATALK
-
- to the config file for your kernel. Rebuild and install your
- kernel. Reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the OpenBSD README file for netatalk.
-
-Note that kernel support for netatalk appears in OpenBSD 2.2, or
-openbsd-current dated after Aug 1, 1997.
-
-1. KERNEL. Add the line
-
- options NETATALK
-
- to the config file for your kernel. Rebuild and install your
- kernel. Reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
+++ /dev/null
-This is the Solaris README file for netatalk.
-
-1. SELECT COMPILER. This distribution is configured to build with
- gcc. It should also work with cc. At the present time only cc
- v5.0 and above can build the 64-bit kernel module.
-
-1a. SELECT KERNEL TYPE. Edit sys/solaris/Makefile and set KCFLAGS to
- include sparcv9 support if you run a 64-bit kernel, or leave it
- commented out for a 32-bit kernel. Only UltraSPARC systems
- running Solaris 7 and above support a 64-bit kernel. If you're
- not sure what kernel you use, run "isainfo -v". You're running a
- 64-bit kernel if the result includes 64-bit (sparcv9), otherwize
- it's 32-bit.
-
- NOTE: If you want both the 32-bit and 64-bit kernel modules to be
- installed, first compile and install the version appropriate to
- the kernel that you're currently running, then make clean,
- compile and install the other version.
-
-2. EDIT NETCONFIG. Add the following line to /etc/netconfig:
-
- ddp tpi_clts - appletalk ddp /dev/ddp -
-
- This makes the socket library aware of the AppleTalk protocol
- family.
-
-3. INSTALL DRIVER. Since the STREAMS ddp driver must be installed as
- root, we've separated that portion of the build. Type
-
- make kinstall
-
- to install the driver. This copies the driver and its config file
- into /usr/kernel/drv and /usr/kernel/strmod, runs "add_drv ddp" to
- make the kernel aware of the new driver, and adds an rc file to
- /etc/rc?.d. Watch out for error messages after it runs add_drv.
- If you see something like
- devfsadm: driver failed to attach: ddp
- Warning: Driver (ddp) successfully added to system but failed to attach
- then recheck sys/solaris/Makefile and/or try a different compiler.
-
-4. ATALKD.CONF. Under Solaris, you must create atalkd.conf, since
- Solaris provides no method for determining the names of the
- available interfaces. It is sufficent to name the available
- interfaces in atalkd.conf, one per line. E.g.
-
- le0
-
- on a line by itself on many Suns. hme0 on Ultras. See atalkd(8).
-
-5. PRINTING. Netatalk can use any postscript printer that has been set
- up for use by Solaris. If you haven't already set up a printer,
- type admintool then select Browse --> Printers, and then Edit --> Add
- and fill in the form for either a local or remote printer. If adding
- a local printer, set the Printer Type to PostScript. Then find a
- postscript file and test your printer from the command line. For
- example if you created a printer called "fred" your print command
- would be something like: lp -d fred some_file.ps
-
- Once you have a printer that works under Solaris, you need to create
- a papd.conf file. For example
-
- MacLaserjet:\
- :pr=|/usr/bin/lp -d fred:\
- :op=nobody:\
- :pd=/usr/local/etc/HPLJ_4M.PPD:
-
- See doc/CONFIGURE for more information on papd.conf.
- Once you have this set up, and assuming netatalk starts up after
- /etc/rc2.d/S79atalk start
- you should be able to see the printer from the Macintosh Chooser.
+++ /dev/null
-This is the SunOS README file for netatalk.
-
-1. KERNEL MODULE. This version of netatalk requires that your kernel
- be configured with
-
- options VDDRV
-
- The loadable kernel module is made and installed during the normal
- make and make install. NOTE: Unloading the kernel module may not
- work correctly and may cause your kernel to panic, hang, or do
- other nasty things.
-
-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
+++ /dev/null
-This is the Tru64 README file for netatalk.
-
-1. Unfortunately, AppleTalk is not available for Digital Unix or Tru64.
- The reason for this is the kernel patches which Netatalk requires
- cannot be ported to Tru64. If anyone has the kernel source of Tru64
- they are welcomed to port the AppleTalk modules themselves.
-
- As a result, only AppleShare over IP (ASIP) works with Tru64. That
- is, the program afpd. papd and atalkd compile, but doesn't really
- work. Anything that requires AppleTalk doesn't work.
-
-2. Netatalk compiles on Tru64 V4.0D or higher using either the built-in
- DEC C compiler or GCC V2.95.3. Also, either the Tru64 make command or
- GNU make can be used. Netatalk supports Tru64's Security Integration
- Architecture (SIA) and runs on machines configured for Base (BSD) or
- Enhanced (OSFC2) Security without recompilation.
-
-3. A peculiar bug in Netatalk has been noticed on a single Tru64
- machine. However, because other Tru64 machines have not affected, a
- patch will not be forthcoming until the circumstances where the bug
- hits is isolated and a more elegant and appropriate patch can be
- found. In the meantime, there is a description of the bug below. Any
- users affected can attempt the workarounds provided. The user is
- urged to report this to the mailing list so that this bug can be
- isolated and removed.
-
- HAVE_GCC_MEMCPY_BUG
- Description -
- It appears that memcpy() under Tru64 can fail under some
- circumstances. This maybe due to the fact that Netatalk is compiled
- with gcc, but since only gcc can compile Netatalk, this is a mute
- point.
-
- Symptoms -
- The symptoms of this bug is that a 18432 byte file uploaded to
- the server would upload correctly, but a 18433 byte file would
- result in a sparse file many megabytes big (16MB+). However, due to
- the low-level nature of memcpy(), there is no reason why other
- symptoms could not occur.
-
- Workarounds -
- There are two known workarounds at this stage.
- - The first is to #define the macro HAVE_GCC_MEMCPY_BUG. This forces
- netatalk to use bcopy() in a few (but not all) cases within the code
- and is enough to stop the bug from occurring. This is the easiest
- workaround and would merely alter the standard compilation steps to
-
- ./configure --with-cflags="-DHAVE_GCC_MEMCPY_BUG"
- make
- make install
-
- - The second workaround is to manually remove the optimisation flag
- "-O2" from within configure and/or configure.in. Although, this
- isn't the preferred workaround, it shows that the compiler is
- (at least) partially at fault.
-
+++ /dev/null
-This is the Ultrix README file for netatalk.
-
-1. REMOVE PREVIOUS NETATALK. If this is the first release of netatalk
- you've used, skip to step (2). If you've installed netatalk
- before, you will need to remove the old patches.
-
- There are two easy ways to remove the old patches. The simplist,
- is to apply the old patches in reverse. E.g. for netatalk-1.3 or
- later
-
- patch -s -d /sys -R -p0 < sys/ultrix/kpatch-<vers>
-
- Note that the old patches are not included in this distribution.
-
- If you haven't saved the old patches, it is possible that the old
- versions of the patched files are still in your file system. When
- patch changes a file, it saves the original file as <file>.orig.
- netatalk-1.3 or later leaves these files
-
- conf/files
- data/af_data.c
- data/if_to_proto_data.c
- data/uipc_domain_data.c
- net/net/conf_net.c
- net/net/netisr.h
-
- Finally, if there is no way to regenerate the old version of the
- patched files, you can apply the new patches by hand, skipping the
- next section. There are two versions of the patches, kpatch-4.1
- for Ultrix 4.1 and kpatch-4.2 for both 4.2 and 4.3.
-
-2. PATCH FILES IN KERNEL BUILDING AREA. The simplest way to install the
- kernel patches is with the command
-
- make kpatch
-
- This command will determine your system type and apply patches to
- the following files
-
- conf/files
- data/af_data.c
- data/if_to_proto_data.c
- data/uipc_domain_data.c
- net/net/conf_net.c
- net/net/netisr.h
-
- To apply these patches by hand, type
-
- patch -s -d /sys -p0 < sys/ultrix/kpatch-<vers>
-
- where <vers> is the version of Ultrix you are running.
-
-3. POPULATE /sys/net/netatalk. Do this with
-
- make kinstall
-
- This makes a directory called /sys/net/netatalk and copies all
- pertinent files. To do this by hand,
-
- mkdir /sys/net/netatalk
- cp sys/netatalk/*.[ch] /sys/net/netatalk
- cp sys/ultrix/*.[ch] /sys/net/netatalk
-
- These files are the complete source for AppleTalk in 4.3BSD kernels
- and Ultrix.
-
-4. CREATE KERNEL. You should probably start by copying the config file
- for GENERIC to, for instance, NETATALK. You'll need to add the
- lines
-
- options ATALK
- pseudo-device atalk
-
- to the NETATALK config file, config the kernel, and then make. You
- don't have to call your kernel NETATALK, but be sure NOT to call it
- ATALK, since the name of the kernel and kernel options are part of
- the same name-space. When your build is finished, save your old
- kernel, install the new kernel, and reboot.
-
-Research Systems Unix Group
-The University of Michigan netatalk@umich.edu
-c/o Wes Craig +1-313-764-2278
-535 W. William St.
-Ann Arbor, Michigan
-48103-4943
projects / netatalk.git / commitdiff