File: update-modules.8

package info (click to toggle)
modutils 2.4.26-1.2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 1,724 kB
  • ctags: 1,708
  • sloc: ansic: 16,932; sh: 2,998; makefile: 549; lex: 490; yacc: 375
file content (83 lines) | stat: -rw-r--r-- 2,416 bytes parent folder | download | duplicates (2)
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
.TH UPDATE-MODULES 8 "Debian GNU/Linux tools" "DEBIAN"
.SH NAME
update\-modules \- (re)generate /etc/modules.conf and /etc/chandev.conf
.SH SYNOPSIS
.B update\-modules
[force]
.SH DESCRIPTION
.B update\-modules
is a simple tool to manage
.IR /etc/modules.conf
and
.IR /etc/chandev.conf
for the s390 architecture.
The Linux module utilities use one configuration file for all their
configuration. This makes it hard for packages to dynamically add
information about their own modules. To fix this
.B update\-modules
has been introduced.
.PP
.B update-modules
attempts to fix this by generating the configuration file from seperate
files which are located in
.IR /etc/modutils .
All files in that directory are assembled together to form
.IR /etc/modules.conf 
and
.IR /etc/chandev.conf .
There is also a special subdirectory
.RI ( /etc/modutils/arch )
which contains information for special architectures. 
.B update-modules
determines the architecture and selects which file it must use.
.PP
After generation a backup of the old file is put in
.IR /etc/modules.conf.old 
or
.IR /etc/chandev.conf.old .
.SH "FILES"
There are two types of file you can put in
.IR /etc/modutils :
normal files and exectuable files. Normal files contain standard modules
configuration information, as described in
.BR modules.conf (5).
Files with the suffix .chandev contain the module options, as described in
.BR chandev (8).
The special file 0chandev.chandev contains the channel device layer specific
options.
Executable files are executed and their output is used as extra configuration
information. Error messages sent to stderr are not redirected.
.PP
.B update\-modules
will ignore files that match the following regular expression:
.RS
.B *\e(\e.dpkg\-[a\-z]*\e|~\e)$
.RE
(ie files with the extension
.IR .dpkg\-new ,
.IR .dpkg\-orig ,
.IR .dpkg\-dist ,
.IR .dpkg\-old ,
or whose filename end with a 
.IR ~ ).
.SH OPTIONS
.TP
.I force
.B update\-modules
check if the current
.I /etc/modules.conf and
.I /etc/chandev.conf
are generated files by checking for a special tag on the first line. If this
tag is not found generation is aborted. By supplying
.I force
as parameter only a warning is printed.
.SH "SEE ALSO"
.BR depmod (1)
.BR modules.conf (5)
.BR modprobe (8)
.BR chandev (8),
.SH BUGS
None of course! :)
.SH AUTHOR
This manual page was written by Wichert Akkerman <wakkerma@debian.org>
for the Debian GNU/Linux system.