home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-2.iso / Unix / network / system / cap.5.0.README < prev    next >
Encoding:
Text File  |  1993-07-17  |  8.2 KB  |  224 lines
  1.  
  2.      CAP - Columbia AppleTalk Package for UNIX (4.2 BSD).
  3.            (For use with AppleTalk/Ethernet bridge)
  4.  
  5.     o RELEASE NOTES
  6.     o CAP Distribution 5.00, May 1988
  7.  
  8. Introduction
  9. ------------
  10.  
  11. This distribution should allow asp, atp, pap client and server
  12. applications to be developed.
  13.  
  14. The 10/86, 2/87, 9/87 or 1/88 Revision of the UDP software, known as
  15. "KIP", developed by Bill Croft at SUMEX, Stanford University is
  16. required.  Revision 1/88 or later is preferred.
  17.  
  18. Notice
  19. ------
  20.  
  21. Copyright (c) 1986, 1987, 1988, The Trustees of Columbia University in
  22. the City of New York.  Charlie C. Kim, User Services Group, Academic
  23. Information Services Division, Libraries and Center for Computing
  24. Activities and Bill Schilit, formerly of Computer Research Facilities,
  25. Computer Science Department.
  26.  
  27. Permission is granted to any individual or institution to use, copy,
  28. or redistribute this software so long as it is not sold for profit,
  29. provided that this notice and the original copyright notices are
  30. retained.  Columbia University makes no representations about the
  31. suitability of this software for any purpose.  It is provided "as is"
  32. without express or implied warranty.
  33.  
  34. --
  35.  
  36. Portions Copyright (c) 1985, Stanford Univ. SUMEX project.
  37. May be used but not sold without permission.
  38.  
  39. Portions Copyright (c) 1984, Apple Computer Inc.
  40. Gene Tyacke, Alan Oppenheimer, G. Sidhu, Rich Andrews.
  41.  
  42. Modules copyright in part or whole by any other entity than Columbia
  43. University are clearly marked as such.
  44.  
  45. --
  46.  
  47. Portions are of the CAP distribution are public domain software.  The
  48. specific item is:
  49.     extras/att_getopt.c
  50.  
  51. Portions of the CAP distribution are contributed by other sites including:
  52.     Rob Chandhok, Computer Science Department, Carnegie Mellon University
  53.     Paul Campbell
  54.  
  55.  
  56. ABSTRACT
  57. --------
  58.  
  59. CAP is written for BSD 4.2 Unix and derivatives.  CAP implements a
  60. library containing a portion of Apple Computer's AppleTalk protocols.
  61. In order to use this package you need an AppleTalk/Ethernet bridge
  62. (e.g. Kinetics FastPath box).  CAP includes a number of applications
  63. that can be used to print to a LaserWriter, spool for a LaserWriter,
  64. and act as Unix based AppleShare compatible file server (no support
  65. for AppleShare PC).  CAP also includes a number of sample programs and
  66. contributed software.
  67.  
  68. CAP library routines are structured, for the most part, the same as
  69. the Apple routines described in "Inside AppleTalk" and "Inside
  70. LaserWriter."  Refer to the Apple documents and the procedure comments
  71. for a complete description of the routines and how to call them.
  72.  
  73. Bill Croft's original work in this area provided the inspiration for
  74. CAP.
  75.  
  76. Prerequisties
  77. ------------
  78.  
  79.  o Kinetics FastPath box running the 10/86, 2/87, 9/87, or 1/88
  80.    Revision of the UDP software, known as "KIP", developed by Bill
  81.    Croft at SUMEX, Stanford University is required.
  82.  
  83.  o baseline host system: Ultrix 2.0-1.  Most will work under BSD 4.2,
  84.    BSD 4.3, Ultrix 1.0-1.2, Sun OS 3.2 or higher, ACIS 4.2, A/UX, and
  85.    other systems with BSD like networking facilities with varying
  86.    levels of functionality.  Under certain systems, only portions will
  87.    work.
  88.  
  89. Information
  90. -----------
  91.  
  92. There is no CAP mailing list.  Instead, notices and information about
  93. CAP are posted to the mailing list info-appletalk which is gatewayed
  94. with the USENET news group comp.protocols.appletalk.  If you don't
  95. have access to comp.protocols.appletalk and have access to the
  96. ARPANET, you can get on the mailing list by sending mail to
  97. info-appletalk-request#@andrew.cmu.edu.  [The '#' part of the address
  98. is currently optional, but it helps speed up delivery.]
  99.  
  100.  
  101. Important documentation resides in:
  102.     NOTES - installation notes: READ THIS BEFORE STARTING INSTALLATION
  103.     PORTING - notes on porting CAP to machines it doesn't know about
  104.     MANIFEST - a list of files that comprise CAP
  105.     doc/installation.ms - stepwise installation document: assumes
  106.       you have read NOTES and this document
  107.  
  108. What's in CAP
  109. -------------
  110.  
  111. The Columbia AppleTalk Package consists of a number of libraries, a
  112. number of programs, and associated documentation.  Following is a list
  113. of the main parts along with a brief description.  
  114.  
  115.  o NOTES for a general overview of installation and some overview
  116.    material.
  117.  o PORTING for information about making CAP work on systems not listed
  118.    in NOTES
  119.  
  120.  netat - general header files used by various parts of CAP
  121.  man - man pages for some of the programs
  122.  doc - documentation
  123.  lib/cap - main appletalk libraries: ASP, PAP, ATP, NBP, DDP
  124.  lib/afp - generic AppleTalk Filing Protocol (AFP) routines
  125.  lib/afpc - AFP client libraries
  126.  etc - support programs: only atis - support program for NBP
  127.  extras - code and materials not necessarily related to AppleTalk
  128.  samples - sample programs: allow simple interaction with lw, appleshare
  129.     server, etc.  See README there.
  130.  contrib - contributed programs
  131.  applications - main applications.
  132.  
  133. The following programs in applications are in regular use at Columbia
  134. and are a main part of the reason we work on CAP:
  135.   papif        - UNIX lpd "input" filter for spooling to appletalk
  136.         - also includes sample "output" filter and printcap entry
  137.         - Note: this is a very bare bones filter
  138.   lwsrv        - Simple LaserWriter spooler suitable for extension
  139.   aufs        - AppleTalk Filing Protocol Unix File Server
  140.         - Note: does NOT support AppleShare PC
  141.     NOTE: You must have the AppleShare 1.0 or 1.1 client code installed in
  142.       your Macintosh to use this.  You must obtain this from Apple -
  143.       we do not and do not plan to supply this.  The client code is
  144.       a lot of work and Apple's already done an excellent job here - well
  145.       worth paying for.
  146.  
  147. Bug Reports
  148. -----------
  149.  
  150. Send bug report, comments, etc. to bug-cap@columbia.edu (arpa),
  151. rutgers!columbia!bug-cap (uucp), or bug-cap@cucca (bitnet).
  152.  
  153. Notes
  154. -----
  155. Hasn't been througly checked out on any system except Ultrix 2.0.
  156. It it known to have run or should be able to run under: BSD 4.2, BSD
  157. 4.3, Ultrix 1.0, 1.1, 1.2, 2.2, Sun OS 3.2 or higher, Pyramid's Unix
  158. under the BSD universe, ACIS 4.2 or 4.3 for the IBM RT PC, A/UX, HP-UX
  159. for the series 9000 (release 6.0), Convex Unix V6.1, Sequents, and the
  160. Encore Multimax.
  161.  
  162. LAP - will probably never be implemented
  163. DDP - don't try to use it directly
  164. Documentation - in shorter supply than it should really be
  165.  
  166.  
  167. TODO list
  168. ---------
  169. a) Complete NBP - completed.
  170. b) Complete PAP - completed.  
  171. c) Complete ATP - completed.
  172. d) Complete DDP - essentially completed, but some minor parts missing.
  173. e) Complete ASP - completed.
  174. f) Start AFP - client side needs to be redone, server side okay.
  175. g) Start ZIP work.  KIP modified to allow under rev 1/88.
  176. h) Start RTMP work.  Not need under KIP.
  177. i) miscellanous other fixes and cleanup
  178.  
  179.  
  180. Credits
  181. -------
  182.  
  183. Thanks to the User Services staff at Columbia University Center for
  184. Computing Activies for patiently testing all the broken software that
  185. was foisted on them as "working" with special thanks going to:
  186.     Rob Cartolano for testing Aufs beyond the call of duty
  187.     Alan Crosswell for making papif die more than anyone else and
  188.         letting me use his RT.
  189.     Lisa Covi and Jeff Eldredge for living with the software in
  190.         our Mac MicroLab
  191.     Mark Kennedy, Tom Chow, and Richard Sacks for giving Charlie
  192.         the support and time to work on CAP
  193. and Father Larry "Mac" McCormick from the Columbia University
  194. Macintosh Users Group for his inspiration and support.
  195.  
  196. And to the following list of people for their
  197. support, help, commentary, and bug fixes:
  198.     Bill Croft, SUMEX, Stanford University
  199.     Janet Tornow, Apple Computer
  200.     Dan Tappan, Bolt Beranek and Newman
  201.     Rakesh Patel, Rutgers University
  202.     Charles Hedrick, Rutgers University
  203.     Robert Elz, Munnari, Australia
  204.     Dan Sahlin, Swedish Institute of Computer Science, Sweden
  205.     Scooter Morris, Genentech
  206.     Mike Byron, Adobe Systems Incorporated
  207.     Tom Mallory, Adobe Systems Incorporated
  208.     Phil Farrell, School of Earth Sciences, Stanford University
  209.     Mark Davies, VUW, New Zeland
  210.     Roy Smith, Public Health Research Institute, NYC
  211.     Ritch Ruff, Oregeon State
  212.     Dan Lanciani, Harvard University
  213.     Ravinder (Rob) Chandhok, Carnegie Mellon University
  214.     Dwight Mckay, Purdue University
  215.     Steve Fram, CITI, University of Michigan
  216.     Paul Campbell, Unisoft
  217.     Edward Moy, WSSG, University of California at Berkelely
  218.     Tharen Debold, Georgia Tech
  219.     Jim Guyton, The Rand Corporation
  220.     and any we might accidently left out of this list
  221. our thanks!
  222.  
  223.  
  224.