home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume21 / coda / part01 / README < prev    next >
Encoding:
Text File  |  1990-04-08  |  3.6 KB  |  90 lines
  1. Coda, the code distribution aide, is a system to keep source distributions
  2. current across a set of machines.  The model is that the master source
  3. tree is kept on a server host, and client hosts run coda to get themselves
  4. in sync with the server.  This is different from rdist where the server
  5. "pushes" files out to its clients.
  6.  
  7. Coda is not as flexible as rdist(1), but it requires less of the client
  8. machines in that they do not have to be running Berkeley networking
  9. programs or even Unix at all.  The client is simple, and designed to be
  10. easy to port.  It currently runs on these systems:
  11.     BSD, Ultrix, Sun, Masscomp
  12.     VMS with Wollongong networking
  13.     ATT3B2 with Wollongong networking (might be slightly broken)
  14.     ATT6386 with Interlan networking
  15.     Xenix with Excelan networking
  16.  
  17. The server current runs under the INET daemon on a BSD-like system, but
  18. could be ported to other Unix systems, or even VMS, without too much
  19. effort.
  20.  
  21. Because of the coda model, a client has to be told several things:  where
  22. the server is, the user name on the host and where the sources are.  These
  23. can be specified on the command line, or a simple config file can be used
  24. to any set of the necessary parameters.
  25.  
  26. The coda server uses a simple but powerful control file to determine what
  27. files are appropriate for each client.  The client directs the server to
  28. read the file when it connects, so that multiple source trees can be
  29. easily maintained on one server.  In the Codafile, hosts are grouped
  30. into classes.  Directories are grouped into blocks, and patterns are
  31. used to exclude hosts from receiving certain files.  For example:
  32.     sources: _ALL {
  33.         #  Everyone gets all the programs, but no object files
  34.         src/programs
  35.         except    _ALL    "*.o", foo, core, tags a.out;
  36.         except    VMS    Makefile, "*.sh", "*.s", "llib-l*";
  37.         except    UNIX    descrip.mms,  "*.opt", "*.com", "*.mar";
  38.     }
  39.  
  40.     ##  VMS library
  41.     vmslib: VMS {
  42.         src/libvms
  43.     }
  44.  
  45.     ##  Unix library
  46.     unixlib: UNIX {
  47.         src/libunix
  48.         except    _ALL    "*.[oa]", "llib-l*.ln";
  49.     }
  50.  
  51. Installation
  52. ------------
  53. Pick a port number for the service to be running on; to use a port number
  54. other than 1999, edit client.h and rebuild, or make sure to inform your
  55. users about the change.  (The server doesn't care what port it is running
  56. on.)  Edit server.h to set the log file location.  and install the server
  57. binary in the appropriate directory.  (It's shown as ... in the paragraphs
  58. below.)
  59.  
  60. You will have to add the server to any machines where you want to make
  61. sources available.  Add a line like the following to /etc/services:
  62.     coda    1999/tcp     # code distribution
  63. If you're using Yellow Pages don't forget to yppush(8).
  64.  
  65. Next you will have to edit the inetd(8) configuration file.  On a
  66. 4.2BSD-based system, add this line to /etc/inetd.conf:
  67.     coda stream tcp nowait .../codaserver codaserver
  68. On a 4.3BSD-based system or SunOS4 add this line to /etc/inetd.conf:
  69.     coda stream tcp nowait root .../codaserver codaserver
  70. You will then have to send a HUP signal to the inet daemon.
  71.  
  72. On a SunOS3 system, add this line to /etc/servers:
  73.     coda   tcp   .../codaserver
  74. You will then have to kill and restart inetd.
  75.  
  76. The coda server requires the remote user to log in with a name and password
  77. before sending any files.  It then does a setuid to that user.  In order to
  78. do this, it should start out running as root.
  79.  
  80. Enjoy.
  81.  
  82. Coda was written by Rich $alz <rsalz@bbn.com>.
  83.  
  84. It has the following copyright:
  85.     Copyright 1989 BBN Systems and Technologies Corporation.
  86.     All Rights Reserved.
  87.     This is free software, and may be distributed under the terms of the
  88.     GNU Public License; see the file COPYING for more details.
  89.     $Header: README,v 2.0 90/03/23 14:40:54 rsalz Exp $
  90.