sys/fs/coda/README

   1 $FreeBSD$
   2
   3                 Announcing the Availability of the
   4                         Coda Distributed
   5                            Filesystem
   6                               for
   7                          BSD Unix Systems
   8
   9         Coda is a distributed filesystem like NFS and AFS.  It is
  10 freely available, like NFS.  But it functions much like AFS in being a
  11 "stateful" filesystem.  Coda and AFS cache files on your local
  12 machine to improve performance.  But Coda goes a step further than AFS
  13 by letting you access the cached files when there is no available
  14 network, viz. disconnected laptops and network outages.  In Coda, both
  15 the client and server are outside the kernel which makes them easier
  16 to experiment with.
  17
  18 To get more information on Coda, I would like to refer people to
  19         http://www.coda.cs.cmu.edu
  20 There is a wealth of documents, papers, and theses there.  There is
  21 also a good introduction to the Coda File System in
  22         http://www.coda.cs.cmu.edu/ljpaper/lj.html
  23
  24 Coda was originally developed as an academic prototype/testbed.  It is
  25 being polished and rewritten where necessary.  Coda is a work in
  26 progress and does have bugs.  It is, though, very usable.  Our
  27 interest is in making Coda available to as many people as possible and
  28 to have Coda evolve and flourish.
  29
  30 The bulk of the Coda filesystem code supports the Coda client
  31 program, the Coda server program and the utilities needed by both.
  32 All these programs are unix programs and can run equally well on any
  33 Unix platform.  Our main development thrust is improving these
  34 programs.  There is a small part of Coda that deals with the kernel to
  35 filesystem interface.  This code is OS specific (but should not be
  36 platform specific).
  37
  38 Coda is currently available for several OS's and platforms:
  39         Freebsd-2.2.5: i386
  40         Freebsd-2.2.6: i386
  41         Freebsd -current: i386
  42         linux 2.0: i386 & sparc
  43         linux 2.1: i386 & sparc
  44         NetBSD 1.3: i386
  45         NetBSD -current: i386
  46 The relevant sources, binaries, and docs can be found in
  47         ftp://ftp.coda.cs.cmu.edu/pub/coda/
  48
  49 We intend to come out with new Coda releases often, not daily.  We
  50 don't want to slight any OS/platform not mentioned above.  We are just
  51 limited in our resources as to what we can support internally.  We
  52 will be happy to integrate OpenBSD support as well as other OS
  53 support.  Also, adding platform support should be relatively easy and
  54 we can discuss this.  The only difficulty is that Coda has a light weight
  55 process package.  It does some manipulations in assembler which would
  56 have to be redone for a different platform.
  57
  58 There are several mailing lists @coda.cs.cmu.edu that discuss coda:
  59 coda-announce and linux-coda.  We are going to revise linux-coda to be
  60 OS neutral, since it is mainly Coda we want to discuss.  We appreciate
  61 comments, feedback, bug reports, bug fixes, enhancements, etc.
  62