5 dh_installmodules - register modules with modutils
11 use Debian::Debhelper::Dh_Lib;
16 B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]
20 dh_installmodules is a debhelper program that is responsible for
21 registering kernel modules.
23 Files named debian/package.modprobe will be installed in
24 etc/modprobe.d/package in the package build directory, to be used by
25 module-init-tools's version of modprobe.
27 Kernel modules are searched for in the package build directory and if
28 found, postinst and postrm commands are automatically generated to
29 run depmod and register the modules when the package is installed.
30 These commands are inserted into the maintainer scripts by dh_installdeb.
31 See L<dh_installdeb(1)> for an explanation of how this works.
33 Previous versions of dh_installmodules also supported
34 files named debian/package.modules, which were installed into
35 etc/modutils/package in the package build directory. This was for use by
36 modutils, which is no longer in Debian. dh_installmodules will warn about
43 =item B<-n>, B<--noscripts>
45 Do not modify postinst/postrm scripts.
47 =item B<--name=>I<name>
49 When this parameter is used, dh_installmodules looks for and
50 installs files named debian/package.name.modules and
51 debian/package.name.modprobe instead of the usual
52 debian/package.modules and debian/package.modprobe
58 Note that this command is not idempotent. L<dh_prep(1)> should be called
59 between invocations of this command. Otherwise, it may cause multiple
60 instances of the same text to be added to maintainer scripts.
66 # Looks for kernel modules in the passed directory. If any are found,
67 # returns the kernel version (or versions) that the modules seem to be for.
68 sub find_kernel_modules {
72 return unless -d $searchdir;
75 my ($kvers)=$File::Find::dir=~m!lib/modules/([^/]+)/!;
76 if (! defined $kvers || ! length $kvers) {
77 warning("Cannot determine kernel version for module $File::Find::name");
85 return keys %versions;
88 foreach my $package (@{$dh{DOPACKAGES}}) {
89 my $tmp=tmpdir($package);
90 my $modutils_file=pkgfile($package,"modules");
91 my $modprobe_file=pkgfile($package,"modprobe");
94 doit("install","-d",$tmp);
98 warning("ignoring $modutils_file, since modutils is no longer in Debian");
101 if ($modprobe_file) {
102 if (! -e "$tmp/etc/modprobe.d") {
103 doit("install","-d","$tmp/etc/modprobe.d");
105 doit("install","-m","0644",$modprobe_file,"$tmp/etc/modprobe.d/".pkgfilename($package));
108 if (! $dh{NOSCRIPTS}) {
109 foreach my $kvers (find_kernel_modules("$tmp/lib/modules")) {
110 autoscript($package,"postinst","postinst-modules","s/#KVERS#/$kvers/g");
111 autoscript($package,"postrm","postrm-modules","s/#KVERS#/$kvers/g");
120 This program is a part of debhelper.
124 Joey Hess <joeyh@debian.org>