From: Russ Allbery Date: Tue, 26 May 2009 19:00:29 +0000 (-0700) Subject: Enable DKMS support X-Git-Tag: debian/1.4.10+dfsg1-2~10 X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=191ffd8bcd15d963bd26cd82a3d464aea5d1d79a;p=packages%2Fo%2Fopenafs.git Enable DKMS support * 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) --- diff --git a/debian/README.modules b/debian/README.modules index 26431af2e..d71a8b959 100644 --- a/debian/README.modules +++ b/debian/README.modules @@ -3,30 +3,44 @@ 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 diff --git a/debian/changelog b/debian/changelog index 7bc0a1019..8b25c6260 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,19 @@ +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 Tue, 26 May 2009 11:57:22 -0700 + openafs (1.4.10+dfsg1-1) unstable; urgency=high * New upstream release. diff --git a/debian/control b/debian/control index c719680df..d8f5ced72 100644 --- a/debian/control +++ b/debian/control @@ -13,7 +13,9 @@ Vcs-Browser: http://git.debian.org/?p=pkg-k5-afs/openafs.git 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 @@ -125,17 +127,17 @@ Description: AFS distributed filesystem kernel module source 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