CAP FAQ
-------
Last update:
Sun Mar  8 20:15:16 EST 1992


> What is CAP ?

The Columbia AppleTalk Package (CAP) implements the AppleTalk protocol
stack on a variety of UNIX machines. The main applications provide an
AppleShare 2.0 compatible server (aufs), a LaserWriter Spooler (lwsrv),
a program to print to LaserWriters (papif). The latter can be used to talk
to EtherTalk LaserWriters, LocalTalk LaserWriters on Dayna EtherPrint cards
or on a LocalTalk/EtherTalk gateway.


> What extra hardware is required for CAP ?

On a SUN or ULTRIX machine, CAP can talk Phase 1 or Phase 2 EtherTalk
packets using packet filters based on the Stanford ENET model. Where
available, CAP can also use kernel based AppleTalk. On other UNIX boxes
you need to have a gateway that can translate IPTalk packets.  Suitable
candidates are Shiva FastPath, Cayman GatorBox or Webster MultiPort Gateway.


> What machines will CAP run on ?

The CAP Configure script has specific support for the following
Operating Systems:

	sunos - SUN SunOS
	ultrixnn - DEC Ultrix 1.2, 2.0, 4.N
	irix - Silicon Graphics IRIS/IRIX
	aix - IBM AIX System V
	hpux - HP HP-UX 8.0
	uts - Amdahl UTS
	aux - Apple A/UX 2.0
	encore - Encore MultiMax BSD
	pyr - Pyramid (BSD Universe)
	next - NeXT/MACH
	dynix - Sequent Balance
	newsos - Sony NEWS
	bsd - BSD 4.2, 4.3


> What is the current CAP version ?

CAP is at version 6.0 with (currently) 100 patches to be applied, most of
which add extra functionality to the original. To determine the current
patch level of your sources, check the cap60/README file for a line of
the form

	o CAP Distribution 6.0, Patch Level 100, March 1992


> Where can I get CAP ?

CAP can be obtained by anonymous FTP from

rutgers.EDU		src/{cap60.tar.Z,cap60.patches/*}
munnari.OZ.AU		mac/{cap60.tar.Z,cap.patches/*}
gatekeeper.DEC.COM	pub/net/appletalk/cap/{cap60.tar.Z,cap.patches/*}
ftp.kuis.kyoto-u.AC.JP	net/cap/{cap60.tar.Z,cap60.patches/*.Z}
src.doc.ic.AC.UK	mac/multigate/{cap60.tar.Z,cap.patches/*}

Please choose a site that is topologically "close".

The patches are available individually or as the files "patches.1-75.tar.Z"
and "patches.76-100.tar.Z".  Additionally, for new users, a patched source
file is available as "cap60.pl100.tar.Z".


> How do I apply the patches ?

To make the process of patching easier, you should get the 'patch' utility
written by Larry Wall, it is normally archived at sites that archive
comp.sources.unix in volume7/patch2. If you can't find anywhere closer it
is on munnari.OZ.AU.  CAP Version 6.1 will be 6.0 with all the patches
applied and will appear when the number of patches stabilizes.

For each of the patches, run 'patch -p < cap60.patch0NN' from the top level
cap60 directory, for example, in csh

		foreach i (../cap60.patches/cap60.patch*)
		patch -p < $i >>& /tmp/patches
		end

and check the /tmp/patches file for patching errors.


> I picked up CAP 6.0 from rutgers.edu, but our Unix system administrator
> refuses to install it because there are 74 patches (can't say I blame him)!

Sigh, see above

% date
Sat Mar  7 23:51:05 EST 1992
% touch /tmp/patches
% foreach i (cap60.patches/cap60.patch*)
? patch -p < $i >>& /tmp/patches
? end
% grep rej /tmp/patches
% date
Sat Mar  7 23:54:26 EST 1992

It took just 3:11 to apply 75 patches to the raw CAP tar source. The extra
overhead is the time to FTP 3 files, cap60.tar.Z, patches.1-74.tar.Z and
cap60.patch075 and uncompress them. The total time spent on this ... 8:02.


> Is CAP Public Domain ?

No, CAP is distributed with the following condition on its use:

  Copyright (c) 1986, 1987, 1988, The Trustees of Columbia University in
  the City of New York.  Charlie C. Kim, User Services Group, Academic
  Information Services Division, Libraries and Center for Computing
  Activities and Bill Schilit, formerly of Computer Research Facilities,
  Computer Science Department.

  Permission is granted to any individual or institution to use, copy,
  or redistribute this software so long as it is not sold for profit,
  provided that this notice and the original copyright notices are
  retained.  Columbia University makes no representations about the
  suitability of this software for any purpose.  It is provided "as is"
  without express or implied warranty.

Some portions of CAP have other copyrights and are suitably marked.


> Is there a version of CAP available that supports Ethertalk Phase 2 ?

Phase 2 support was added in CAP 6.0 patches 25, 28 & 35 for SUN NIT, ULTRIX
4.n and SUN enet driver respectively. NB: There is currently a problem
under ULTRIX 4.2, this will hopefully be fixed soon.


> Can a workstation with 2 ethernet cards running Cap s/w act as a phaseII
> to (phaseI or phaseII) "Gateway"? If so, what patch level of Cap do I need
> to do this?
 
The UNIX AppleTalk Bridge (UAB) is the EtherTalk gateway. It can handle
multiple ethernet interfaces and gateway between them. This is its primary
function but it can also be set up to provide CAP services. But ...


> Does anyone have a patch that will support the phase 2 appletalk protocol
> on UAB (CAP6.0).

UAB is currently Phase 1 only, the reason it doesn't handle Phase 2 is
simply the time required to convert it.


> Is there any standard way yet of implementing a execute only, copy
> protected CAP AUFS server?

The original method of achieving this was to removing read permission from
the data fork of the Application (make it non-zero length if the file is
empty). The current method involves using the Application Manager added in
patch number 61. Either of these methods can be circumvented by knowledgeable/
determined users.


Send CAP FAQ contributions to cap@munnari.OZ.AU