| 1 |
.TH UPDATE-MODULES 8 "Debian GNU/Linux tools" "DEBIAN"
|
| 2 |
.SH NAME
|
| 3 |
update\-modules \- (re)generate /etc/modules.conf and /etc/chandev.conf
|
| 4 |
.SH SYNOPSIS
|
| 5 |
.B update\-modules
|
| 6 |
[force]
|
| 7 |
.SH DESCRIPTION
|
| 8 |
.B update\-modules
|
| 9 |
is a simple tool to manage
|
| 10 |
.IR /etc/modules.conf
|
| 11 |
and
|
| 12 |
.IR /etc/chandev.conf
|
| 13 |
for the s390 architecture.
|
| 14 |
The Linux module utilities use one configuration file for all their
|
| 15 |
configuration. This makes it hard for packages to dynamically add
|
| 16 |
information about their own modules. To fix this
|
| 17 |
.B update\-modules
|
| 18 |
has been introduced.
|
| 19 |
.PP
|
| 20 |
.B update-modules
|
| 21 |
attempts to fix this by generating the configuration file from seperate
|
| 22 |
files which are located in
|
| 23 |
.IR /etc/modutils .
|
| 24 |
All files in that directory are assembled together to form
|
| 25 |
.IR /etc/modules.conf
|
| 26 |
and
|
| 27 |
.IR /etc/chandev.conf .
|
| 28 |
There is also a special subdirectory
|
| 29 |
.RI ( /etc/modutils/arch )
|
| 30 |
which contains information for special architectures.
|
| 31 |
.B update-modules
|
| 32 |
determines the architecture and selects which file it must use.
|
| 33 |
.PP
|
| 34 |
After generation a backup of the old file is put in
|
| 35 |
.IR /etc/modules.conf.old
|
| 36 |
or
|
| 37 |
.IR /etc/chandev.conf.old .
|
| 38 |
.SH "FILES"
|
| 39 |
There are two types of file you can put in
|
| 40 |
.IR /etc/modutils :
|
| 41 |
normal files and exectuable files. Normal files contain standard modules
|
| 42 |
configuration information, as described in
|
| 43 |
.BR modules.conf (5).
|
| 44 |
Files with the suffix .chandev contain the module options, as described in
|
| 45 |
.BR chandev (8).
|
| 46 |
The special file 0chandev.chandev contains the channel device layer specific
|
| 47 |
options.
|
| 48 |
Executable files are executed and their output is used as extra configuration
|
| 49 |
information. Error messages sent to stderr are not redirected.
|
| 50 |
.PP
|
| 51 |
.B update\-modules
|
| 52 |
will ignore files that match the following regular expression:
|
| 53 |
.RS
|
| 54 |
.B *\e(\e.dpkg\-[a\-z]*\e|~\e)$
|
| 55 |
.RE
|
| 56 |
(ie files with the extension
|
| 57 |
.IR .dpkg\-new ,
|
| 58 |
.IR .dpkg\-orig ,
|
| 59 |
.IR .dpkg\-dist ,
|
| 60 |
.IR .dpkg\-old ,
|
| 61 |
or whose filename end with a
|
| 62 |
.IR ~ ).
|
| 63 |
.SH OPTIONS
|
| 64 |
.TP
|
| 65 |
.I force
|
| 66 |
.B update\-modules
|
| 67 |
check if the current
|
| 68 |
.I /etc/modules.conf and
|
| 69 |
.I /etc/chandev.conf
|
| 70 |
are generated files by checking for a special tag on the first line. If this
|
| 71 |
tag is not found generation is aborted. By supplying
|
| 72 |
.I force
|
| 73 |
as parameter only a warning is printed.
|
| 74 |
.SH "SEE ALSO"
|
| 75 |
.BR depmod (1)
|
| 76 |
.BR modules.conf (5)
|
| 77 |
.BR modprobe (8)
|
| 78 |
.BR chandev (8),
|
| 79 |
.SH BUGS
|
| 80 |
None of course! :)
|
| 81 |
.SH AUTHOR
|
| 82 |
This manual page was written by Wichert Akkerman <wakkerma@debian.org>
|
| 83 |
for the Debian GNU/Linux system.
|