Introduction
The easiest way to get AFS modules is to install prebuilt modules. For
- example, if you are running kernel 2.4.27-2-686-smp, you might try:
+ example, if you are running kernel 2.6.26-2-686, you might try:
- apt-get install openafs-modules-2.4.27-2-686-smp
+ apt-get install openafs-modules-2.6.26-2-686
Pre-built modules are not provided with Debian (building and maintaining
them in Debian proper poses too many problems), but many organizations
that use OpenAFS build their own and provide them locally.
If this doesn't work, you will need to build your own modules. There
- are two methods for doing this.
+ are three methods for doing this.
- When following either method, be aware that the Debian package creates a
- module named openafs, not libafs as is used by upstream. It also
- prefers not to add the .mp extension for modules built for SMP kernels;
- the indication of whether the module is for an SMP kernel should go into
- the package name via something like --append_to_version, not into the
- file name of the module.
+ When following any of these methods, be aware that the Debian package
+ creates a module named openafs, not libafs as is used by upstream. It
+ also prefers not to add the .mp extension for modules built for SMP
+ kernels; the indication of whether the module is for an SMP kernel
+ should go into the package name via something like --append_to_version,
+ not into the file name of the module.
+
+DKMS
+
+ DKMS is relatively new and untested compared to the other mechanisms for
+ building kernel modules, but if it works for you, it's the easiest.
+ DKMS stands for Dynamic Kernel Module Support. It provides
+ infrastructure that will automatically rebuild kernel modules when the
+ source package or the kernel has been upgraded.
+
+ To build OpenAFS kernel modules via DKMS, just install the
+ openafs-modules-dkms package. This depends on DKMS and will install it
+ as well. The OpenAFS kernel modules should then be built automatically
+ and will be installed under updates/dkms in the module tree for your
+ kernel.
module-assistant
- This method is the best one to use when using the kernels that come with
- Debian, since module-assistant knows how to get the right header files
- to build modules for your currently running kernel. Generally, all you
- should have to do is:
+ This method is the best method for manually building kernel modules for
+ kernels that come with Debian, since module-assistant knows how to get
+ the right header files to build modules for your currently running
+ kernel. Generally, all you should have to do is:
apt-get install module-assistant
module-assistant auto-install openafs
+openafs (1.4.10+dfsg1-2) UNRELEASED; urgency=low
+
+ * Provide an openafs-modules-dkms package that uses DKMS to dynamically
+ build kernel modules for the local kernel and document this option in
+ README.modules. This is an alternative to installing
+ openafs-modules-source and building kernel modules for each new kernel
+ with module-assistant or make-kpkg. (Closes: #168852, #525131)
+ (LP: #52786, #364426, #369875)
+ * Have openafs-client recommend at least the current source version of
+ openafs-modules-source or openafs-modules-dkms instead of any old
+ version. While the API probably hasn't changed, it's best practice to
+ keep a relatively close match between the userspace andn the kernel
+ module version. (LP: #369875)
+
+ -- Russ Allbery <rra@debian.org> Tue, 26 May 2009 11:57:22 -0700
+
openafs (1.4.10+dfsg1-1) unstable; urgency=high
* New upstream release.
Package: openafs-client
Architecture: alpha amd64 arm armel i386 ia64 lpia powerpc ppc64 s390 s390x sparc
Depends: ${shlibs:Depends}, ${misc:Depends}
-Recommends: openafs-modules-source (>= 1.2.9) | openafs-modules2, lsof
+Recommends: lsof, openafs-modules-dkms (>= ${source:Version})
+ | openafs-modules-source (>= ${source:Version})
+ | openafs-modules2
Suggests: openafs-doc, openafs-krb5
Conflicts: arla, openafs-modules1
Description: AFS distributed filesystem client support
This package provides the source to the AFS kernel module in a form
suitable for use by module-assistant or kernel-package.
-#Package: openafs-modules-dkms
-#Priority: extra
-#Depends: ${misc:Depends}, bison, flex
-#Architecture: alpha amd64 arm armel i386 ia64 lpia powerpc ppc64 s390 s390x sparc
-#Description: AFS distributed filesystem kernel module DKMS source
-# AFS is a distributed filesystem allowing cross-platform sharing of
-# files among multiple computers. Facilities are provided for access
-# control, authentication, backup and administrative management.
-# .
-# This package contains the source for the AFS kernel module, packaged with
-# approriate configuration for DKMS to build new modules dynamically.
+Package: openafs-modules-dkms
+Priority: extra
+Depends: ${misc:Depends}, dkms, bison, flex
+Architecture: alpha amd64 arm armel i386 ia64 lpia powerpc ppc64 s390 s390x sparc
+Description: AFS distributed filesystem kernel module DKMS source
+ AFS is a distributed filesystem allowing cross-platform sharing of
+ files among multiple computers. Facilities are provided for access
+ control, authentication, backup and administrative management.
+ .
+ This package contains the source for the AFS kernel module, packaged with
+ approriate configuration for DKMS to build new modules dynamically.
Package: libpam-openafs-kaserver
Architecture: alpha amd64 arm armel i386 ia64 lpia powerpc ppc64 s390 s390x sparc
projects / packages / o / openafs.git / commitdiff