Because of licensing restrictions imposed by The Open Group (formerly
the Open Software Foundation), the company that distributes DCE,
we are unable to provide a ready-to-run copy of FreeDCE for Linux.
However, we've tried to make it as easy as possible by supplying a
script that does most of the work of unpacking, patching, and
building FreeDCE.

1. Download the DCE 1.2.2 distribution from The Open Group.  You should
read the license and terms of use first at
http://www.opengroup.org/dce/download/, and then download the files from
ftp.opengroup.org.  The files you need are:

	/pub/dce122/ode/src.tar.gz
	/pub/dce122/src/src/SVR4.tar.gz
	/pub/dce122/src/src/admin.tar.gz 
	/pub/dce122/src/src/config.tar.gz
	/pub/dce122/src/src/dce.tar.gz
	/pub/dce122/src/src/directory.tar.gz 
	/pub/dce122/src/src/examples.tar.gz
	/pub/dce122/src/src/file.tar.gz
	/pub/dce122/src/src/lbe.tar.gz 
	/pub/dce122/src/src/libdce.tar.gz
	/pub/dce122/src/src/libdcedfs.tar.gz 
	/pub/dce122/src/src/mit_krb5.tar.gz
	/pub/dce122/src/src/rc_files.tar.gz
	/pub/dce122/src/src/rpc.tar.gz 
	/pub/dce122/src/src/security.tar.gz
	/pub/dce122/src/src/threads.tar.gz
	/pub/dce122/src/src/time.tar.gz 
	/pub/dce122/src/src/tools.tar.gz
	/pub/dce122/src.crypto/dist/?????/src.tar.gz

Note that the last file contains export-restricted code and should
only be downloaded by persons in the US or Canada.  Unfortunately,
FreeDCE does not yet build properly without the export-restricted
cryptography code, but that's okay because the NASD tree also contains
export-restricted code (in particular, DES).

When you download the files, you should preserve the directory
structure (i.e., ode/src.tar.gz -> ode/src.tar.gz), since the
unpacking script expects the same directories.  I'll call the toplevel
directory that you download these files into the "dist directory".

2) Download the BU SNAP006 patches for ODE and DCE and the PDL SNAP001
patches for DCE from the PDL web site into the top level of your dist
directory.  The files you need are

	ode.diffs.003.gz
	dce.diffs.006.gz
	pdl.diffs.001.gz

3) Create a directory to use as the base of the ODE and DCE build
trees.  This can be anywhere on the machine, but you will need 480MB
of space on the partition to compile DCE.  I'll call this directory
the "master directory".

4) cd to the master directory and run

	$NASD_TOP/linuxdce/build-dce /path/to/distdir

You will need to run this as root; when finished, the script will have
unpacked, patched, compiled, and installed DCE into /opt/dce.  If you
want your DCE install to live elsewhere, make /opt a symlink to the
appropriate place.  The installed DCE binaries take up about 70MB; you
can reduce this somewhat by stripping the binaries in /opt/dce/bin and
/opt/ode/bin after they are installed.

Notes:

* Your DCE installation must be accessible as /opt/dce; either install
it there or make a symlink.  There are numerous hardcoded paths in the
DCE code which expect to find files under that directory.

* The port of DCE to Linux was done by Jim Doyle and many others.  Jim
Doyle is reachable as jrd@bu.edu.  The FreeDCE web pages live at
http://www.bu.edu/~jrd/FreeDCE/index.html.  Updates to the code,
release notes, etc. can be found there.

* If you run into problems, you can send questions to the NASD
Prototype mailing list, nasd-prototype@cs.cmu.edu.

$Id: README,v 1.1.1.1 2005/03/21 08:52:03 agc Exp $
