dh_dkms(1) correctly handle DKMS usage by a kernel module package


dh_dkms [debhelper options] [-l] [-V[version]] [-- file]


dh_dkms is a debhelper program that is responsible for correctly setting postinst, postrm and dependencies in kernel module packages using DKMS.

If a file named debian/package.dkms exists, then different actions are performed, depending on its contents.


It can be a proper configuration file, and in this case it would be installed in the proper directory as dkms.conf.

It can also point to another file (this should be used when the configuration is provided by upstream), and in this case that file will be installed as dkms.conf in the proper directory.

This file can only miss if a filename is provided when calling dh_dkms.


-l, --legacy
Add code to also support DKMS versions <
-V, -V version
If "PACKAGE_VERSION" in dkms.conf is set to "#MODULE_VERSION#", set it to the given version or, if none is given, default to the upstream version of the current package. Otherwise, leave the value specified in dkms.conf.
-- file
Don't look for debian/package.dkms or debian/dkms, but install file as dkms.conf.


Note that this command is not idempotent. dh_prep(1) should be called between invocations of this command. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.

IMPORTANT: binary packages using dh_dkms must have a name that ends in '-dkms'.


David Paleino <[email protected]>