mirror of https://github.com/mabam/CAP.git
340 lines
13 KiB
Plaintext
340 lines
13 KiB
Plaintext
The purpose of setting up CAP on GitHub is to build an AppleTalk
|
|
protocol stack for OS X 10.6 and newer that is compatible with
|
|
Classic Mac OS. That is, AFP-version up to 2.x and transport via DDP
|
|
(despite Apple removing DDP from OS X since 10.6).
|
|
|
|
This will enable AppleTalk networking with emulated machines running
|
|
Classic Mac OS as well as printing on non-IP, AppleTalk-only printers.
|
|
|
|
See also this forum discussion:
|
|
http://www.emaculation.com/forum/viewtopic.php?t=8589#p50155
|
|
|
|
- 'mabam', March 2015
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
CAP Distribution 6.0, Patch Level 198 + 'asip1', March 1999
|
|
|
|
In 'CAP.faq' it is stated that the following interim patches are
|
|
available for download from munnari.OZ.AU and can be reversed once
|
|
patch 199 is completed:
|
|
|
|
asip.patch - AppleShareIP support
|
|
cicon.patch - Color Desktop Icon support
|
|
extnd.patch - Extended volume size support
|
|
desktop.patch - Desktop tool color icon support
|
|
|
|
It appears that patch 199 has never been released and the interim
|
|
patches are not available anymore at munnari.OZ.AU.
|
|
|
|
They are, however, available for download at
|
|
ftp://iubio.bio.indiana.edu/util/cap/ (log in as guest)
|
|
with the first patch substituted for a fixed version called
|
|
'asip1.patch'.
|
|
In this therefore unofficial, though fully patched version of CAP 6.0
|
|
these patches have been applied in the required, above stated order on
|
|
top of the patches 001 to 198.
|
|
|
|
See also 'cap60.pl198+asip.README' for the original information by
|
|
Don Gilbert from the Department of Biology, Indiana University
|
|
Bloomington.
|
|
|
|
- 'mabam', March 2015
|
|
|
|
----------------------------------------------------------------------
|
|
|
|
CAP - Columbia AppleTalk Package for UNIX
|
|
|
|
o RELEASE NOTES
|
|
o CAP Distribution 6.0, Patch Level 198, June 1996
|
|
|
|
Notice
|
|
------
|
|
|
|
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.
|
|
|
|
--
|
|
|
|
Portions Copyright (c) 1985, Stanford Univ. SUMEX project.
|
|
May be used but not sold without permission.
|
|
|
|
Portions Copyright (c) 1984, Apple Computer Inc.
|
|
Gene Tyacke, Alan Oppenheimer, G. Sidhu, Rich Andrews.
|
|
|
|
Portions Copyright (c) 1990 - 1996 The University of Melbourne
|
|
|
|
Modules copyright in part or whole by any other entity than Columbia
|
|
University are clearly marked as such.
|
|
|
|
--
|
|
|
|
Portions are of the CAP distribution are public domain software. The
|
|
specific items are:
|
|
extras/att_getopt.c
|
|
extras/des.c
|
|
|
|
Portions of the CAP distribution are contributed by other sites including:
|
|
Rob Chandhok, Computer Science Department, Carnegie Mellon University
|
|
Ed Moy, University of California at Berkeley
|
|
David Hornsby, The University of Melbourne
|
|
Rakesh Patel, Rutgers University
|
|
Paul Campbell
|
|
|
|
|
|
ABSTRACT
|
|
--------
|
|
|
|
CAP was written for BSD 4.2 Unix and derivatives. CAP implements a
|
|
library containing a portion of Apple Computer's AppleTalk protocols.
|
|
In order to use this package you may need an AppleTalk/Ethernet bridge
|
|
(e.g. Shiva FastPath, Webster MultiPort Gateway). CAP includes a number
|
|
of applications that can be used to print to a LaserWriter, spool for a
|
|
LaserWriter, and act as Unix based AppleShare compatible file server.
|
|
CAP also includes a number of sample programs and contributed software.
|
|
|
|
CAP library routines are structured, for the most part, the same as
|
|
the Apple routines described in "Inside AppleTalk" and "Inside
|
|
LaserWriter." Refer to the Apple documents and the procedure comments
|
|
for a complete description of the routines and how to call them.
|
|
|
|
Bill Croft's original work in this area provided the inspiration for CAP.
|
|
|
|
Prerequisties
|
|
------------
|
|
|
|
o CAP as originally shipped needs a gateway capable of supporting
|
|
IPTalk (the transmission of AppleTalk DDP packets inside IP UDP packets)
|
|
to translate (gateway) IPTalk packets to/from EtherTalk or LocalTalk.
|
|
Suitable candidates include ...
|
|
|
|
* Webster MultiPort Gateway
|
|
* Cayman Gatorbox
|
|
* Shiva FastPath
|
|
* Cisco Router
|
|
|
|
o This CAP version supports Native EtherTalk, UAR (Phase 1 or Phase 2) and
|
|
Kernel AppleTalk, UAB (Phase 1) on certain hosts. A gateway as listed
|
|
above is only required to access LocalTalk services.
|
|
|
|
o baseline host system: Ultrix 2.0-1. Most will work under BSD 4.2,
|
|
BSD 4.3, Ultrix 1.0-1.2, Sun OS 3.2 or higher, ACIS 4.2, A/UX, IBM
|
|
RISC 6000, IRIS/IRIX, HP/Apollo Domain (BSD environment), OSF/Alpha,
|
|
386/BSD, FreeBSD and other systems with BSD like networking
|
|
facilities with varying levels of functionality. Under certain
|
|
systems, only portions will work.
|
|
|
|
Where
|
|
-----
|
|
|
|
CAP can be obtained by anonymous FTP from
|
|
|
|
munnari.OZ.AU mac/{cap60.pl100.tar.Z,cap.patches/*}
|
|
ftp-ns.rutgers.EDU pub/cap/{cap60.pl100.tar.Z,cap.patches/*}
|
|
gatekeeper.DEC.COM pub/net/appletalk/cap/{cap60.pl100.tar.Z,cap.patches/*}
|
|
ftp.kuis.kyoto-u.AC.JP net/cap/{cap60.pl100.tar.Z,cap60.patches/*.Z}
|
|
src.doc.ic.AC.UK packages/multigate/{cap60.pl100.tar.Z,cap.patches/*}
|
|
|
|
Please choose an appropriate site and an off-peak time for the transfer.
|
|
|
|
The patches are available individually or as the files "patches.1-100.tar.Z",
|
|
"patches.101-126.tar.Z", "patches.127-143.tar.Z", "patches.144-154.tar.Z",
|
|
"patches.155-162.tar.Z", "patches.163-182.tar.Z" & "patches.183-192.tar.Z".
|
|
Additionally, for new users, a partially patched source file is available
|
|
as "cap60.pl100.tar.Z" (beware: the file cap60.tar.Z is totally unpatched).
|
|
|
|
Patches
|
|
-------
|
|
|
|
To make the process of patching easier, you should get the 'patch' utility
|
|
written by Larry Wall, it is normally available from sites that archive
|
|
comp.sources.unix in volume7/patch2 and at GNU archive sites as
|
|
patch-2.1.tar.gz (which requires gzip-1.2.2.tar for unpacking).
|
|
|
|
For each of the patches, run 'patch -p < cap60.patchNNN' 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 (look for the strings
|
|
"rej", "failed", "offset", "fuzz" - should be none). To remove the *.orig
|
|
files that patch leaves behind (containing the original version of the file),
|
|
run 'make spotless' from the top level directory (note that spotless also
|
|
removes all makefiles so gen.makes needs to be run to regenerate them).
|
|
|
|
Information
|
|
-----------
|
|
|
|
There is no CAP mailing list. Instead, notices and information about
|
|
CAP are posted to the mailing list info-appletalk which is gatewayed
|
|
with the USENET news group comp.protocols.appletalk. If you don't
|
|
have access to comp.protocols.appletalk and have access to the
|
|
ARPANET, you can get on the mailing list by sending mail to
|
|
info-appletalk-request@andrew.cmu.edu.
|
|
|
|
Information about CAP and related UNIX AppleTalk packages is available
|
|
via the World Wide Web using
|
|
|
|
http://www.cs.mu.OZ.AU/appletalk/atalk.html
|
|
|
|
The CAP FAQ (Frequently Asked Questions) file is available via FTP
|
|
from munnari.OZ.AU as the file
|
|
|
|
mac/CAP.faq
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Important documentation resides in:
|
|
|
|
doc/install.ms - stepwise installation document: assumes
|
|
you have read NOTES and this document
|
|
doc/print.cookbook - simple steps to implement CAP printing
|
|
man/* - UNIX manual entries for the various CAP programs
|
|
NOTES - installation notes: READ THIS BEFORE STARTING INSTALLATION
|
|
PORTING - notes on porting CAP to machines it doesn't know about
|
|
|
|
What's in CAP
|
|
-------------
|
|
|
|
The Columbia AppleTalk Package consists of a number of libraries, a
|
|
number of programs, and associated documentation. Following is a list
|
|
of the main parts along with a brief description.
|
|
|
|
o NOTES for a general overview of installation and some overview material.
|
|
|
|
o PORTING for information about making CAP work on systems not listed
|
|
in NOTES
|
|
|
|
netat - general header files used by various parts of CAP
|
|
man - man pages for some of the programs
|
|
doc - documentation
|
|
lib/cap - main appletalk libraries: ASP, PAP, ATP, NBP, DDP
|
|
lib/afp - generic AppleTalk Filing Protocol (AFP) routines
|
|
lib/afpc - AFP client libraries
|
|
lib/xenix - compatibility routines for XENIX use
|
|
etc - support programs: only atis - support program for NBP
|
|
extras - code and materials not necessarily related to AppleTalk
|
|
samples - sample programs: allow simple interaction with lw, appleshare
|
|
server, etc. See README there.
|
|
contrib - contributed programs
|
|
support - alterative LAP delivery support, Native EtherTalk,
|
|
Kernel AppleTalk and UAB.
|
|
applications - main applications.
|
|
|
|
The following programs in applications are in regular use at Columbia
|
|
and are a main part of the reason we work on CAP:
|
|
papif - UNIX lpd "input" filter for spooling to appletalk
|
|
- also includes sample "output" filter and printcap entry
|
|
- Note: this is a very bare bones filter
|
|
lwsrv - Simple LaserWriter spooler suitable for extension
|
|
aufs - AppleTalk Filing Protocol Unix File Server
|
|
|
|
NOTE: You must have the AppleShare 1.1 or 2.0 client code installed in
|
|
your Macintosh to use this. You must obtain this from Apple -
|
|
we do not and do not plan to supply this. The client code is
|
|
a lot of work and Apple's already done an excellent job here.
|
|
|
|
Bug Reports
|
|
-----------
|
|
|
|
Send bug report, comments, etc. to cap@munnari.OZ.AU or uunet!munnari!cap
|
|
|
|
Notes
|
|
-----
|
|
Hasn't been througly checked out on any system except Ultrix 2.0 & SunOS.
|
|
It it known to have run or should be able to run under: BSD 4.2, BSD
|
|
4.3, Ultrix 1.0, 1.1, 1.2, 2.2, Sun OS 3.2 or higher, Pyramid's Unix
|
|
under the BSD universe, ACIS 4.2 or 4.3 for the IBM RT PC, A/UX, HP-UX
|
|
for the series 9000 (release 6.0), Convex Unix V6.1, Sequents, IBM AIX
|
|
on the RISC 6000, Silicon Graphics IRIS/IRIX, HP/Apollo Domain (BSD),
|
|
OSF/1 Alpha, 386/BSD, FreeBSD and the Encore Multimax.
|
|
|
|
LAP - will probably never be implemented
|
|
DDP - don't try to use it directly
|
|
Documentation - in shorter supply than it should really be
|
|
|
|
|
|
TODO list
|
|
---------
|
|
a) Complete NBP - completed.
|
|
b) Complete PAP - completed.
|
|
c) Complete ATP - completed.
|
|
d) Complete DDP - essentially completed, but some minor parts missing.
|
|
e) Complete ASP - completed.
|
|
f) Start AFP - client side needs to be redone, server side okay.
|
|
g) Start ZIP work. KIP modified to allow under rev 1/88.
|
|
h) Start RTMP work. Not need under KIP.
|
|
i) miscellanous other fixes and cleanup
|
|
|
|
|
|
Credits
|
|
-------
|
|
|
|
Thanks to the User Services staff at Columbia University Center for
|
|
Computing Activies for patiently testing all the broken software that
|
|
was foisted on them as "working" with special thanks going to:
|
|
Rob Cartolano for testing Aufs beyond the call of duty
|
|
Alan Crosswell for making papif die more than anyone else and
|
|
letting me use his RT.
|
|
Lisa Covi and Jeff Eldredge for living with the software in
|
|
our Mac MicroLab
|
|
Mark Kennedy, Tom Chow, and Richard Sacks for giving Charlie
|
|
the support and time to work on CAP
|
|
and Father Larry "Mac" McCormick from the Columbia University
|
|
Macintosh Users Group for his inspiration and support.
|
|
|
|
And to the following list of people for their
|
|
support, help, commentary, and bug fixes:
|
|
Bill Croft, SUMEX, Stanford University
|
|
Janet Tornow, Apple Computer
|
|
Dan Tappan, Bolt Beranek and Newman
|
|
Rakesh Patel, Rutgers University
|
|
Charles Hedrick, Rutgers University
|
|
Robert Elz, University of Melbourne, Australia
|
|
Dan Sahlin, Swedish Institute of Computer Science, Sweden
|
|
Scooter Morris, Genentech
|
|
Mike Byron, Adobe Systems Incorporated
|
|
Tom Mallory, Adobe Systems Incorporated
|
|
Phil Farrell, School of Earth Sciences, Stanford University
|
|
Mark Davies, VUW, New Zealand
|
|
Roy Smith, Public Health Research Institute, NYC
|
|
Ritch Ruff, Oregeon State
|
|
Dan Lanciani, Harvard University
|
|
Ravinder (Rob) Chandhok, Carnegie Mellon University
|
|
Dwight Mckay, Purdue University
|
|
Steve Fram, CITI, University of Michigan
|
|
Paul Campbell, Unisoft
|
|
Edward Moy, WSSG, University of California at Berkelely
|
|
Tharen Debold, Georgia Tech
|
|
Jim Guyton, The Rand Corporation
|
|
and any we might accidently left out of this list
|
|
our thanks!
|
|
|
|
|
|
Further CAP 6.0 thanks to
|
|
William Roberts, Queen Mary & Westfield College, UK
|
|
Edward Moy, University of California at Berkeley
|
|
Steve P. Andrewartha, University of Tasmania
|
|
Tom Evans, Webster Computer Corp.
|
|
Phil Budne, Shiva
|
|
Rakesh Patel, Rutgers University
|
|
Chip Salzenberg, Teltronics/TCT
|
|
Dan Oscarsson, Lund Institute of Technology, Sweden
|
|
Bridget Rogers, University of MN, Duluth
|
|
Matthew Lewis, University of Amsterdam
|
|
Max Tardiveau, University of St. Thomas
|
|
and lots of nice people at the University of Melbourne, Australia.
|