← Back to branch summary

~mmach/netext73/dkms

« back to all changes in this revision

Viewing changes to dkms.8

  • Committer: mmach
  • Date: 2019-11-07 17:11:15 UTC
  • Revision ID: netbit73@gmail.com-20191107171115-u4kvyorniw2xhvzd
2.8.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
dkms.8
226
226
on all of your other systems to get the same built modules loaded
227
227
without having to wait for anything to compile.
228
228
.SY ldtarball
229
 
.OS /path/to/tarball.tar
230
 
.OS --force
 
229
.OP /path/to/tarball.tar
 
230
.OP --force
231
231
.YS
232
232
.IP "" 4
233
233
This takes a tarball made from the
262
262
.SY mkdeb
263
263
.OP module/module\-version
264
264
.OP -k kernel/arch
265
 
.OP --binaries-only
266
 
.OP --source-only
267
265
.YS
268
266
.IP "" 4
269
267
This action allows you to create a debian binary package for a specified module / version.
273
271
.I /usr/src/<module>\-<module\-version>/<module>\-dkms\-mkdeb
274
272
it will use that folder instead. In general, a DKMS tarball is placed inside the
275
273
contents of this package, and the package itself calls various DKMS commands to
276
 
load this tarball, build and install modules on the end user's system.  If you do
277
 
not want your debian package to contain any prebuilt binaries, be sure to specify
278
 
.B \-\-source\-only
279
 
in the mkdeb command.
 
274
load this tarball, build and install modules on the end user's system.
 
275
.SY mkbmdeb
 
276
.OP module/module\-version
 
277
.OP -k kernel/arch
 
278
.YS
 
279
.IP "" 4
 
280
Creates a Debian binary package containing just the binary modules in the /lib/modules
 
281
installation path. This package does not depend on dkms and does not require a toolchain
 
282
to be installed on the target host. Useful if you want to have a package to install on
 
283
hosts identical to the build system without installing the full toolchain on them.
 
284
It uses a template debian directory found in
 
285
.I /etc/dkms/template\-dkms\-mkbmdeb
 
286
as the basis for the package.
280
287
.SY mkdsc
281
288
.OP module/module\-version
282
289
.OP -k kernel/arch
283
 
.OP --binaries-only
284
 
.OP --source-only
285
290
.YS
286
291
.IP "" 4
287
292
This action allows you to create a debian source package for a specified module / version.
291
296
.I /etc/dkms/template\-dkms\-mkdsc
292
297
as the basis for the package. Alternatively, if DKMS finds a file called
293
298
.I /usr/src/<module>\-<module\-version>/<module>\-dkms\-mkdsc
294
 
it will use that folder instead. If you do not want your debian source package to
295
 
contain any prebuilt binaries, be sure to specify
296
 
.B \-\-source\-only
297
 
in the mkdsc command.
 
299
it will use that folder instead.
298
300
.SY mkkmp
299
301
.OP module/module\-version
300
302
.OP --spec specfile
901
903
install will be aborted.  This is typically used to perform a custom
902
904
version comparison.
903
905
.TP
 
906
.B SIGN_TOOL=
 
907
The module signing tool to be run at a
 
908
.B build.
 
909
Two arguments will be passed to the signing tool. The first argument is the
 
910
target kernel version, the second is the module file path. If the tool exits
 
911
with a non\-zero value, the build will be aborted.
 
912
.TP
904
913
.SH DKMS.CONF VARIABLES
905
914
Within your
906
915
.I dkms.conf
938
947
You can override the module-provided
939
948
.I dkms.conf
940
949
files. Every time after a  dkms.conf file is read, dkms will look for and read the following files in order:
941
 
 
942
 
.I /etc/dkms/<module>.conf\p
943
 
.I /etc/dkms/<module>\-<module\-version>.conf\p
944
 
.I /etc/dkms/<module>\-<module\-version>\-<kernel>.conf\p
 
950
.PP
 
951
.I /etc/dkms/<module>.conf
 
952
.br
 
953
.I /etc/dkms/<module>\-<module\-version>.conf
 
954
.br
 
955
.I /etc/dkms/<module>\-<module\-version>\-<kernel>.conf
 
956
.br
945
957
.I /etc/dkms/<module>\-<module\-version>\-<kernel>\-<arch>.conf
946
 
 
 
958
.PP
947
959
You can use these files to override settings in the module-provided dkms.conf files.
948
960
.SH /etc/dkms/framework.conf
949
961
This configuration file controls how the overall DKMS framework handles.  It is sourced