morrison@nucsrl.UUCP (Vance Morrison) (12/31/87)
Hello,
Several weeks ago I sent out a request for information concerning CAP
and AUFS. Charlie C. Kim <cck@cunixc.columbia.edu> was kind enough
to reply. His responce was a REAME file that tells where to get CAP
off the network.
Several people have written since I made my plea wanting to know the
results. Obviously this information is of general interest, so I
am posting the reply I got. I hope this is of use to those of you
who are interested in CAP.
Vance Morrison
Northwestern Univ.
morrison@accuvax.nwu.edu
#######################################################################
Note:
Information about CAP is posted to comp.protocols.appletalk on usenet
and the mailing list info-appletalk. You can request to be added to
the mailing list by sending mail to:
info-appletalk-request#@andrew.cmu.edu
File is README:
CAP - Columbia AppleTalk Package for UNIX (4.2 BSD).
(For use with AppleTalk/Ethernet bridge)
Copyright (c) 1986, 1987, 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 &
Bill Schilit, 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.
ABSTRACT
--------
CAP is written under UNIX BSD 4.2 and implements a portion of Apple
Computer's AppleTalk protocols. In order to use this package you need
an AppleTalk/Ethernet bridge (e.g. Kinetics FastPath box).
CAP 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.
RELEASE NOTES
-------------
See RELEASE for the current description of the AppleTalk Unix Package.
------------------------------------------------
File is RELEASE:
CAP - Columbia AppleTalk Package for UNIX (4.2 BSD).
(For use with AppleTalk/Ethernet bridge)
o RELEASE NOTES
o CAP Pre-release (Distribution 4.00), March 1987
Patch 5: May 30, 1987
Patch 6: August 25, 1987
Patch 7: August 25, 1987
Intro
-----
This Pre-release is being issued to allow asp, atp, pap client and
server applications to be developed.
The 10/86 or 2/87 Revision of the UDP software developed by Bill Croft
at SUMEX, Stanford University is required.
Notice
------
Copyright (c) 1986, 1987, 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 &
Bill Schilit, 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) 1986 Bolt Beranek and Newman Inc. All rights
reserved. This software is distributed in an 'as is' condition
without any guaranteess to usability, fitness of purpose, or
otherwise.
This software cannot be sold or distributed commercially without
prior permission from BB&N.
--
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.
Prerequisties
------------
o Kinetics FastPath box running the 10/86 or 2/87 Revision of the UDP
software developed by Bill Croft at SUMEX, Stanford University is
required.
o host system: Ultrix 2.0. Should work under BSD 4.2, BSD 4.3,
Ultrix 1.0, Ultrix 1.1, Ultrix 1.2, Sun OS 3.2, and ACIS 4.2
(some of these have been tested, but not very throughly).
Distribution
------------
Distribution is via anonymous FTP from CU20B.COLUMBIA.EDU
[128.59.32.128]. The directory is: US:[US.CCK.CAP.D4] and the files
are:
o MODIFICATION - list of modifications (ascii, 4KB)
o RELEASE - this file - note the versions of this file in the
below four files are out of date (ascii, 8KB)
o cap.tar - standard tar file (Binary, 870KB)
o cap.shar - shell archive (ascii, 860KB)
o compacted-cap.tar - cap.tar "compacted"ed using "compact" (binary, 580KB)
o compressed-cap.tar - cap.tar "compress"ed using "compress" (binary, 350KB)
o pat5.shar - patches for cap distribution 4. (ascii, 40kb)
o pat6.shar - more patches for cap distribtion 4. (ascii, 160KB)
o pat6.Z - "compress"ed copy of pat6.shar (binary, 71KB)
o pat7.shar - updated copy of afp files for cap distribution 4. (ascii, 365KB)
***WARNING*** The entire Aufs directory is replaced ********
o pat7.Z - "compress"ed copy of pat7.shar (binary, 140KB)
In parenthesis, we specify whether the file is binary or ascii and the
approximate size in kilobytes. WARNING: this distribution is about
double the size of distribution 3. You must specify "tenex" if you
are transferring a binary file from a non TOPS-20 machine (e.g. unix)
or you will end up with garbage.
Alternative, you can get the files from the info mac archives at
sumex.stanford.edu from the directory ps:<info-mac> as:
o at-cap.shar (cap.shar above)
o at-cap.rel (RELEASE above)
o at-cap4.patch5 (pat5.shar above)
o at-cap4.patch6 (pat6.shar above)
o at-pat4.patch7 (pat7.shar above)
o at-cap.mod (MODIFICATIONS above)
o at-kip.shar (source for required Stanford UDP code for KFPS)
o at-gw.srec (compiled Stanford UDP code for KFPS)
The CAP distribution is available via BITNET from CUVMA (Columbia).
You can get a directory of all the available files by typing:
tell listserv at cuvma index cap
You can retrieve a file by typing:
tell listserv at cuvma get <file>
(for example: tell listserve at cuvma get pat6 shar)
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. [The '#' part of the address
is currently optional, but it helps speed up delivery.]
What's in CAP
-------------
The AppleTalk Package consists of a library "libcap.a" built from the
following files in lib/:
abnet.c - Unix glue
abmisc.c - Various routines
abqueue.c - General queue handling
ablap.c - Link Access Protocol (LAP) routines
abddp.c - Datagram Delivery Protocol (DDP) routines
abatp.c - AppleTalk Transaction Protocol (ATP) routines
abatpaux.c - Merged into abatp as of Release 4.0
abnbp.c - Name Binding Protocol (NBP) routines. See
doc/cap.notes for more information.
abpap.c - Printer Access Protocol (PAP) routines
abpapaux.c - [not in second distribution, merged into abpap.c]
abpapc.c - PAP client only routines (PAPOpen, PAPStatus)
abpaps.c - PAP server only routines (SLInit, GetNextJob, etc.)
abpp.c - Some unix style read and write routines for pap
abasp.c - appletalk session protocol
atalkdbm.c - Appletalk routing table handler (SUMEX)
The following files in etc/ are to be installed into /etc/ or
/usr/local/lib/cap (or an alterative directory you can specify).
atis.c - AppleTalk Information Server. It must run as a root process.
nisaux.c - Part of atis.c. Manages the names table.
Some documentation is available in doc/ including "installation".
This document purports to help people install cap :-).
The following example programs are included in sample/:
look.c - Find AppleTalk entities and print information
- note: look.c contains the code for looks and pinger
looks - Find AppleTalk LaserWriters and print status
pinger - Utilizes the echo protocol to "ping" hosts
lwpr.c - Send file to AppleTalk LaserWriter
- note: lwpr also contains the code for iwpr
iwpr - send file to appletalk imagewriter
papif.c - UNIX lpd filter for spooling to appletalk
- also includes sample filter and printcap entry
- Note: this is a very bare bones filter
tlw.c - Talks to LaserWriter "Interactive Executive"
lsrv.c - Sample PAP Server for LaserWriter (needs mucho work).
isrv.c - Sample Server for ImageWriter (experimental)
lwsrv.c - Sample LaserWriter spooler (experimental)
efsd.c - cap implementation of EFS (UNIX side only)
(lucasfilm/SU/BBN/Columbia)
In extras, we have:
cap.printers - only needed for papif.c - maps unix to laserwriter names
- something like this will always be needed. Note: the
format of the names has changed
- this file is expected to be /etc
iwif.c - input filter for BSD LPD for Imagewriter hooked up via
a serial line
printcap.sampleiw - sample printcap entry for ImageWriter hooked up via
a serial line
printcap.sample1 - sample printcap for LaserWriter spooled via papif
printcap.sample2 - sample printcap for LaserWriter spooled via papif
that uses the Adobe TransScript pstext program
to allow text printing
LWFonts - Font list file for LaserWriter (for lwsrv)
LWPlusFonts - Font list file for LaserWriter Plus (for lwsrv)
lnof.c - simple output filter for use with papif or iwif
efds.pyr - patches to allow efsd to run on a pyramid
att_getopt.c - an getopt from mod.sources for lwsrv and aufs
In afp we have all the file relating to the AppleTalk Filing Protocol.
There are three major directories in afp.
afpc - contains client code library for unix
afpc.c - primary library
afpc.mss - documentation for afpc.c
afpcc.c - set of "easy" access routines (not documented)
probs - noted problems with appleshare client
afpcommon - code common to client and server
afpcmd.c - packing and unpacking routines for afp pkts
afperr.c - error messages, etc. for afp
afppacks.c - definition for various afp pkts
aufs - AppleTalk Filing Protocol Unix File Server
NOTE: You must have the AppleShare 1.0 or 1.1 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.
too many files to enumerate. Some of the more important ones:
README - brief overview
user.doc - designed to help users to get started
todo - things done and not done
design.notes - some of the design considerations.
samples - sample programs with client code.
ash.c - sample afp client - allows a few things to be done
with appleshare servers
instappl.c - allows an application to be installed into a unix
aufs volume
Bug Reports
-----------
Send bug report, comments, etc. to bug-cap@columbia.edu (arpa),
rutgers!columbia!bug-cap (uucp), or bug-cap@cucca (bitnet).
Notes
-----
Hasn't been checked on anything except Ultrix 1.2 and BSD 4.3.
LAP - will probably never be implemented
DDP - don't try to use it directly
Documentation - in very short supply
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. Waiting. May not be needed under KIP.
h) Start RTMP work. Not need under KIP.
i) miscellanous other fixes and cleanup
---- UUCP INFO ----
Sender: @po5.andrew.cmu.edu:aw0g#infoatalk.errors@andrew.cmu.edu
Date: 31 Aug 87 17:46:06 GMT
From: <@andrew.cmu.edu:phri!roy@nyu.arpa> (Roy Smith)
Organization: Public Health Research Institute, NYC, NY
Subject: CAP distribution now available via "anonymous uucp"
Sender: info-appletalk-request@andrew.cmu.edu
To: info-appletalk@andrew.cmu.edu
The CAP distribution is now available via "anonymous uucp" from
phri. To get a copy, you should set up a temporary uucp connection to us
(see instructions below) and then just do "uucp phri!capfile localfile" where
"capfile" is one of the following:
-rw-r--r-- 1 root 813636 Aug 31 11:13 cap4
-rw-r--r-- 1 root 340063 Aug 31 11:24 cap4.Z
-rw-r--r-- 1 root 41110 Aug 31 11:14 cap4.patch5
-rw-r--r-- 1 root 20049 Aug 31 11:21 cap4.patch5.Z
-rw-r--r-- 1 root 149580 Aug 31 11:14 cap4.patch6
-rw-r--r-- 1 root 67937 Aug 31 11:21 cap4.patch6.Z
-rw-r--r-- 1 root 352315 Aug 31 11:14 cap4.patch7
-rw-r--r-- 1 root 149883 Aug 31 11:22 cap4.patch7.Z
There are 4 basic shar files of interest; cap4 is the version 4.00
distribution of CAP and the cap4.patch[567] files are the three published
patches to cap4. Everybody should have patches 5 and 6. Patch 7 only has
to do with the aufs (AppleShare) code, so don't bother getting it if you
aren't going to run aufs. Each of these files has a compressed version,
indicated by the ".Z" suffix. These files were prepared with compress
version 4.0 using 16-bit coding. Since you are paying for the phone call,
I highly recommend you get the compressed versions. If, by some chance,
you don't have compress 4.0, you can get:
-rw-r--r-- 1 root 55434 Aug 31 12:52 compress
which is a shar file containing the source to compress 4.0.
Please note that we are only distributing these files as a favor to
the CAP uucp community and don't have anything to do with maintaining the
code. If you have questions about CAP itself, they are best directed to
cck@columbia.edu.
To set up a temporary link to phri, just put the following in your
L.sys file:
phri Wk2300-0700,Sa,Su ACU 2400 2125780890 ogin: Uanon word: ArchServ
phri Wk2300-0700,Sa,Su ACU 1200 2125780890 "" \r ogin: Uanon word: ArchServ
You must call us; we will not call you. We request that you only
call between 11:00 PM and 7:00 AM (Eastern Time) during the week, or all
day on weekends. We talk both 1200 and 2400 baud. We answer at 2400 by
default; send a CR or BREAK to cycle to 1200. Please do *not* use this
login for regular uucp traffic; it is intended only for this anonymous uucp
archive service.
These files are also available from other sites via anonymous ftp
on the Internet and via something-or-other on BITNET. Details we recently
announced on this newsgroup; I don't know anything furthur about those
access methods.
--
Roy Smith, {allegra,cmcl2,philabs}!phri!roy
System Administrator, Public Health Research Institute
455 First Avenue, New York, NY 10016