none
authorMichael Meffie <mmeffie@sinenomine.net>
Tue, 30 Oct 2007 15:02:00 +0000 (15:02 +0000)
committerMichael Meffie <mmeffie@sinenomine.net>
Tue, 30 Oct 2007 15:02:00 +0000 (15:02 +0000)
AFSLore/HowToBuildOpenAFSFromSource.mdwn

index 5414fb5..ecdd075 100644 (file)
@@ -1,20 +1,45 @@
 This is a guide on how to build [[OpenAFS]] from source code. Note that [[OpenAFS]] pre-built binaries are available on the [[OpenAFS]] site and are available as prebuilt packages for many platforms. These instructions may be useful for you if you need to build [[OpenAFS]] from source.
 
-### <a name="Platform Requirements"></a> Platform Requirements
+### <a name="Requirements"></a> Requirements
 
-(this is where we list requirements like krb)
+- autoconf
+- automake
+- perl 5.6
 
-### <a name="Development Tools Requirements"></a> Development Tools Requirements
+One of the following compiliers:
 
-(list the required tools needed to build openafs)
+- gcc (versions?)
 
-### <a name="Getting the Source Code"></a> Getting the Source Code
+### <a name="Getting the Source Code from CVS"></a> Getting the Source Code from CVS
 
-(show how to get the code from the openafs cvs repo. list most important branches)
+You can get development snapshots from the [[OpenAFS]] CVS repository. The CVS tree may not always have code which can currently be built. While every effort is made to keep the head of the tree buildable, you may at any time find yourself between commits and hence have a tree which does not build, or worse, causes more serious problems.
+
+First you need to run cvs login. This step is normally only done once. A ~/.cvspass file will be created for additional checkouts.
+
+       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs  login
+       password is anonymous
+
+To check out the 1.4 branch:
+
+       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs co -r openafs-stable-1_4_x openafs
+
+To check out the 1.5 development branch:
+
+       cvs -d :pserver:anonymous@cvs.openafs.org:/cvs co -r openafs-devel-1_5_x openafs
+
+See the CVSWeb interface at <http://www.openafs.org/frameset/cgi-bin/cvsweb.cgi/openafs/> to see a full list of available branches and tags
+
+CVS snapshots do not include files generated by autoconf; You can run regen.sh at the top level to create these files. You will need to have autoconf and automake installed on your system.
 
 ### <a name="Building the Binaries"></a> Building the Binaries
 
-(show how to run regen, configure, give guidance on config parameters
+#### <a name="Quick Answer"></a> Quick Answer
+
+       cd openafs
+       ./regen.sh
+       ./configure  --enable-debug --enable-transarc-paths --with-krb5-conf=(full path to krb5-config script)
+       make
+       make dest
 
 ### <a name="Installing the Binaries"></a> Installing the Binaries