freebsd-dev

History

Robert Watson a9d2f8d84f Second-to-last commit implementing Capsicum capabilities in the FreeBSD kernel for FreeBSD 9.0: Add a new capability mask argument to fget(9) and friends, allowing system call code to declare what capabilities are required when an integer file descriptor is converted into an in-kernel struct file *. With options CAPABILITIES compiled into the kernel, this enforces capability protection; without, this change is effectively a no-op. Some cases require special handling, such as mmap(2), which must preserve information about the maximum rights at the time of mapping in the memory map so that they can later be enforced in mprotect(2) -- this is done by narrowing the rights in the existing max_protection field used for similar purposes with file permissions. In namei(9), we assert that the code is not reached from within capability mode, as we're not yet ready to enforce namespace capabilities there. This will follow in a later commit. Update two capability names: CAP_EVENT and CAP_KEVENT become CAP_POST_KEVENT and CAP_POLL_KEVENT to more accurately indicate what they represent. Approved by: re (bz) Submitted by: jonathan Sponsored by: Google Inc		2011-08-11 12:30:23 +00:00
..
cnode.h	Synchronize Coda kernel module definitions in our coda.h to Coda 6's	2010-04-05 20:12:54 +00:00
coda_fbsd.c	Remove unit2minor() use from kernel code.	2008-09-26 14:19:52 +00:00
coda_io.h	Since we're now actively maintaining the Coda module in the FreeBSD source	2008-02-10 11:18:12 +00:00
coda_opstats.h	Since we're now actively maintaining the Coda module in the FreeBSD source	2008-02-10 11:18:12 +00:00
coda_pioctl.h	Since we're now actively maintaining the Coda module in the FreeBSD source	2008-02-10 11:18:12 +00:00
coda_psdev.c	Second-to-last commit implementing Capsicum capabilities in the FreeBSD	2011-08-11 12:30:23 +00:00
coda_psdev.h	Since we're now actively maintaining the Coda module in the FreeBSD source	2008-02-10 11:18:12 +00:00
coda_subr.c	Synchronize Coda kernel module definitions in our coda.h to Coda 6's	2010-04-05 20:12:54 +00:00
coda_subr.h	Synchronize Coda kernel module definitions in our coda.h to Coda 6's	2010-04-05 20:12:54 +00:00
coda_venus.c	Properly bounds check ioctl/pioctl data arguments for Coda:	2010-08-07 08:08:14 +00:00
coda_venus.h	Synchronize Coda kernel module definitions in our coda.h to Coda 6's	2010-04-05 20:12:54 +00:00
coda_vfsops.c	Synchronize Coda kernel module definitions in our coda.h to Coda 6's	2010-04-05 20:12:54 +00:00
coda_vfsops.h	Synchronize Coda kernel module definitions in our coda.h to Coda 6's	2010-04-05 20:12:54 +00:00
coda_vnops.c	Remove prtactive variable and related printf()s in the vop_inactive	2010-11-19 21:17:34 +00:00
coda_vnops.h	Rather than having the Coda module use its own namecache, use the global	2008-02-13 13:06:22 +00:00
coda.h	Properly bounds check ioctl/pioctl data arguments for Coda:	2010-08-07 08:08:14 +00:00
README
TODO	Add "Make MPSAFE" to the Coda todo list.	2008-02-26 09:27:47 +00:00

README

$FreeBSD$

                Announcing the Availability of the
                        Coda Distributed
                           Filesystem
                              for
                         BSD Unix Systems

        Coda is a distributed filesystem like NFS and AFS.  It is
freely available, like NFS.  But it functions much like AFS in being a
"stateful" filesystem.  Coda and AFS cache files on your local
machine to improve performance.  But Coda goes a step further than AFS
by letting you access the cached files when there is no available
network, viz. disconnected laptops and network outages.  In Coda, both
the client and server are outside the kernel which makes them easier
to experiment with.

To get more information on Coda, I would like to refer people to
        http://www.coda.cs.cmu.edu
There is a wealth of documents, papers, and theses there.  There is
also a good introduction to the Coda File System in
        http://www.coda.cs.cmu.edu/ljpaper/lj.html

Coda was originally developed as an academic prototype/testbed.  It is
being polished and rewritten where necessary.  Coda is a work in
progress and does have bugs.  It is, though, very usable.  Our
interest is in making Coda available to as many people as possible and
to have Coda evolve and flourish.

The bulk of the Coda filesystem code supports the Coda client
program, the Coda server program and the utilities needed by both.
All these programs are unix programs and can run equally well on any
Unix platform.  Our main development thrust is improving these
programs.  There is a small part of Coda that deals with the kernel to
filesystem interface.  This code is OS specific (but should not be
platform specific).

Coda is currently available for several OS's and platforms:
        Freebsd-2.2.5: i386
        Freebsd-2.2.6: i386
	Freebsd -current: i386
        linux 2.0: i386 & sparc
        linux 2.1: i386 & sparc
        NetBSD 1.3: i386
	NetBSD -current: i386
The relevant sources, binaries, and docs can be found in
        ftp://ftp.coda.cs.cmu.edu/pub/coda/

We intend to come out with new Coda releases often, not daily.  We
don't want to slight any OS/platform not mentioned above.  We are just
limited in our resources as to what we can support internally.  We
will be happy to integrate OpenBSD support as well as other OS
support.  Also, adding platform support should be relatively easy and
we can discuss this.  The only difficulty is that Coda has a light weight
process package.  It does some manipulations in assembler which would
have to be redone for a different platform.

There are several mailing lists @coda.cs.cmu.edu that discuss coda:
coda-announce and linux-coda.  We are going to revise linux-coda to be
OS neutral, since it is mainly Coda we want to discuss.  We appreciate
comments, feedback, bug reports, bug fixes, enhancements, etc.