==================
			Coda Release 4.6.6
			==================


date: 11/17/98

Instructions on how to run Coda are in a documented titled RUN.
Instructions on how to build Coda are in a document titled
BUILD.FreeBSD.  This release uses the package system for the client,
server, and documentation.

If you want to get more information on Coda or get a newer release of
the software check out:

	http://www.coda.cs.cmu.edu/
		and
	ftp://ftp.coda.cs.cmu.edu/pub/coda/

I. Coda is:

	packages:
		coda-client-4.6.6.1.tgz
		coda-doc-4.6.5.3.tgz
		coda-intro-4.6.6.1.tgz
		coda-server-4.6.6.1.tgz

	ports:
		/usr/ports/net/coda_client
		/usr/ports/net/coda_doc
		/usr/ports/net/coda_intro
		/usr/ports/net/coda_server

	source/distfiles:
		coda-4.6.6.tgz
		coda-doc-4.6.5-3.tgz
		coda-intro-4.6.6.tgz

FOR 2.2.STABLE ENVIRONMENTS, YOU WILL ALSO NEED TO ADD THE CODA KERNEL
SOURCE CODE TO THE FreeBSD KERNEL.

II. Obtaining Packages

You may obtain the newest compiled packages from the Coda site or
other mirrors:

Coda-intro is a quick get started guide to using Coda.
	pkg_add ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/2.2.x/i386/coda-intro-4.6.6.1.tgz

The Coda client is needed by a machine to use the Coda filesystem.
Aprox Size =  4.9 Meg
	pkg_add ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/2.2.x/i386/coda-client-4.6.6.1.tgz

The Coda server is needed by a machine to create and serve the filesystem to
client machines.
Aprox Size = 6.8 Meg
	pkg_add ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/2.2.x/i386/coda-server-4.6.6.1.tgz

Finally, we have a wealth of documentation about Coda and need to generate still more.
Aprox Size = 1.5Meg
	pkg_add ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/2.2.x/i386/coda-doc-4.6.5.3.tgz

NOTE:
pkg_add may fail silently.  Please make sure you have at least 25MB of
free space available in /var/tmp to install the each package.

III. Generating Packages the Hard Way

The ports collection for Coda did not make it into the official release.  You can
fetch ports.coda_4.6.6.tgz and load it into / from:
	ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/2.2.x/i386/ports.coda_4.6.6.tgz

After untar'ing ports.coda_4.6.6.tgz, you can:

	cd /usr/ports/net/coda_intro
		make package
	cd /usr/ports/net/coda_client
		make package
	cd /usr/ports/net/coda_server
		make package
	cd /usr/ports/net/coda_doc
		make package

NOTE: The client and server each need about 85Meg for the work area
and another 15Meg to install.  They are compiled -g for debugging.


IV. The Kernel

The Coda client needs a special kernel while the Coda server does not.
This kernel has support for the Coda VFS layer.  The Coda kernel VFS
layer redirects fs operations to the user level Coda client program.
You should make sure that your kernel or GENERIC (if that's what you
use) was compiled with "options CFS" and "pseudo-device vcfsa"
enabled; this is not done by default.

There are two files for the kernel pieces.  They are both in
	ftp://ftp.coda.cs.cmu.edu/pub/coda/freebsd/2.2.x/i386
The one is:
	 kernel-patch.cfs-4.6.6.tgz
it should be untar'ed into your sys/ directory.  The other is:
	kernel-patch.FreeBSD-4.4.0-2.2.5.gz
THIS FILE IS ONLY NECESSARY FOR FREEBSD RELEASE 2.2.5.  It should be
installed in the sys/ directory by:
	zcat kernel-patch.FreeBSD-4.4.0-2.2.5.gz | patch -p6
This patch fixes a few files in the 2.2.5 Release that needs to know
about Coda, like conf/files and sys/vnode.h.

You should read the BUILD.FreeBSD document to understand how to build
a kernel for Coda.