src/packaging/RedHat/openafs-README

   1 The files in the src directory are covered by the IBM Public License
   2 and the SUN ONC RPC license, with are included in the files
   3 LICENSE.IBM and LICENSE.Sun in the same directory as this README.
   4
   5 There are two ways to build the AFS kernel module on the local system:
   6 Building an RPM and Building Manually
   7
   8
   9   REBUILDING FROM SOURCE RPM
  10   --------------------------
  11
  12 The first (and preferred) way to build a kernel module is to build an
  13 openafs-kernel RPM from the OpenAFS Source RPM.  To do this you can
  14 just use "rpm --rebuild" from the Source RPM (SRPM) and specify that
  15 you want to build a module and the target CPU.  For example:
  16
  17   rpmbuild --rebuild --define "build_modules 1" --target=i686
  18
  19 You MUST specify the target CPU or it will not build the correct
  20 module for your system.
  21
  22 For more information on all the various options for rebuilding your
  23 kernel module via RPM, run:
  24
  25   rpm -qi openafs
  26
  27 This will explain all your options for controlling your build.
  28
  29
  30   REBUILDING MANUALLY
  31   -------------------
  32
  33 The second method to build a kernel module is to build it manually
  34 from source.  You really should just build the RPM, but if you really
  35 don't want to you can do it this way instead.
  36
  37 To build the AFS kernel module on a local system, run:
  38
  39     ./configure
  40     make
  41
  42 When it's done, the binary module will be src/MODLOAD-XXX/libafs-XXX.o
  43 (or .ko), where "XXX" is your linux kernel version.  Note that it may
  44 also compile as src/MODLOAD-XXX/openafs.ko.
  45
  46 You must manually install this module on your system.  To do this you
  47 generally copy the file to /lib/modules/XXX/openafs.o:
  48
  49     cp src/MODLOAD-XXX/libafs-XXX.o /lib/modules/XXX/openafs.o
  50
  51 Then you need to tell your system about the new kernel module by
  52 running "depmod -ae XXX" to run the module dependencies for kernel
  53 version "XXX".