summaryrefslogtreecommitdiff
path: root/dh_installmodules
blob: 132857a0f5e33736675a37c6f9a0df43424deee6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
#!/usr/bin/perl -w

=head1 NAME

dh_installmodules - register modules with modutils


=cut

use strict;
use Debian::Debhelper::Dh_Lib;
use File::Find;

=head1 SYNOPSIS

B<dh_installmodules> [S<I<debhelper options>>] [B<-n>] [B<--name=>I<name>]

=head1 DESCRIPTION

dh_installmodules is a debhelper program that is responsible for
registering kernel modules with modutils.

Files named debian/package.modules will be installed as
etc/modutils/package in the package build directory. This is for use by
modutils. Files named debian/package.modprobe will be installed in
etc/modprobe.d/package in the package build directory, to be used by
module-init-tools's version of modprobe.

Then postinst and postrm commands are automatically generated to register
the modules when the package is installed. See L<dh_installdeb(1)> for an
explanation of how this works. Note that this will be done for any
package this program acts on which has either a package.modules file, or
has .o or .ko files in /lib/modules.

=head1 OPTIONS

=over 4

=item B<-n>, B<--noscripts>

Do not modify postinst/postrm scripts.

=item B<--name=>I<name>

Use "name" as the filename the modules file is installed in
etc/modutils/. When this parameter is used, dh_installmodules looks for and
installs files named debian/package.name.modules instead of the usual
debian/package.modules.

=back

=head1 NOTES

Note that this command is not idempotent. "dh_clean -k" should be called
between invocations of this command. Otherwise, it may cause multiple
instances of the same text to be added to maintainer scripts.

=cut

init();

# Returns true if there are any .o or .ko files in the passed directory.
sub find_kernel_modules {
	my $searchdir=shift;
	my @results=();

	return unless -d $searchdir;
	find(sub { push @results, $_ if /\.k?o$/ }, $searchdir);
	return @results > 0;
}

foreach my $package (@{$dh{DOPACKAGES}}) {
	my $tmp=tmpdir($package);
	my $modutils_file=pkgfile($package,"modules");
	my $modprobe_file=pkgfile($package,"modprobe");

	if (! -e $tmp) {
		doit("install","-d",$tmp);
	}

	if ($modutils_file) {
		if (! -e "$tmp/etc/modutils") {
			doit("install","-d","$tmp/etc/modutils");
		}
		doit("install","-m","0644",$modutils_file,"$tmp/etc/modutils/".pkgfilename($package));
	}

	if ($modprobe_file) {
		if (! -e "$tmp/etc/modprobe.d") {
			doit("install","-d","$tmp/etc/modprobe.d");
		}
		doit("install","-m","0644",$modprobe_file,"$tmp/etc/modprobe.d/".pkgfilename($package));
	}
	
	if (! $dh{NOSCRIPTS} &&
	    ($modutils_file || find_kernel_modules("$tmp/lib/modules"))) {
			autoscript($package,"postinst","postinst-modules","s/#PACKAGE#/$package/");
			autoscript($package,"postrm","postrm-modules","s/#PACKAGE#/$package/");
	}
}

=head1 SEE ALSO

L<debhelper(7)>

This program is a part of debhelper.

=head1 AUTHOR

Joey Hess <joeyh@debian.org>

=cut