1 Building OpenAFS on UNIX and LINUX
2 ----------------------------------
4 A. Creating the proper directory structure.
6 Uncompress the source into a directory of your choice.
7 Preferrably, afs space. In the directory that you uncompressed the
8 source in, you will only have an src directory.
10 1. Make a directory for each system type that you plan on
11 building. Current tested system types include the following
12 (this step is skipped for the i386_nt40 system type):
25 Builds for the following platforms will not fully compile:
30 2. Within each of those directories, create a dest/ and obj/ directory.
33 % mkdir i386_linux22/dest
34 % mkdir i386_linux22/obj
36 3. Create symbolic links to the system type you are about to build
39 % ln -s @sys/dest dest
42 Makefile@ dest@ i386_linux22/ obj@ src/
44 4. If this source is NOT in AFS space, You must make a link from
45 @sys to your current system type.
48 % ln -s i386_linux22 @sys
50 Within AFS space, the AFS Cache Manager automatically
51 substitutes the local machine's AFS system name (CPU/operating
52 system type [ie: alpha_dux40, i386_linux22, ...]) for the @sys
55 5. Create the top level Makefile:
56 a. For LINUX and UNIX versions
59 % ln -s src/Makefile Makefile
61 Makefile@ i386_linux22/ src/
65 1. Make the obj links. This creates links from the @sys/obj/ tree
66 back to the source tree. The source tree remains unchanged and
67 builds are done in the platform specific object tree.
73 % make SYS_NAME="i386_linux22" LINUX_VERSION="2.2.14"
75 b. For UNIX versions, specify the system name as given by
76 the system type defined in step A1.
77 % make SYS_NAME="<system_name>"
79 Example for the rs_aix42 operating system:
80 % make SYS_NAME="rs_aix42"
83 If you have a problem building this source, you may want to visit
84 http://oss.software.ibm.com/developerworks/opensource/afs/ to see
85 if any problems have been reported or to find out how to get more