Commit f914915b authored by Daniel A. Nobuto's avatar Daniel A. Nobuto Committed by Linus Torvalds

[PATCH] Documentation/Changes for modules

the url for module-init-tools has been fixed, and all the references to
modutils (outside source) has been updated if necessary.

more patches to follow to fix up the modules.conf/conf.modules vs.
modprobe.conf references.
parent 9380dde2
...@@ -52,7 +52,7 @@ o Gnu C 2.95.3 # gcc --version ...@@ -52,7 +52,7 @@ o Gnu C 2.95.3 # gcc --version
o Gnu make 3.78 # make --version o Gnu make 3.78 # make --version
o binutils 2.9.5.0.25 # ld -v o binutils 2.9.5.0.25 # ld -v
o util-linux 2.10o # fdformat --version o util-linux 2.10o # fdformat --version
o modutils 2.4.2 # insmod -V o module-init-tools 0.9 # rmmod -V
o e2fsprogs 1.29 # tune2fs o e2fsprogs 1.29 # tune2fs
o jfsutils 1.0.14 # fsck.jfs -V o jfsutils 1.0.14 # fsck.jfs -V
o reiserfsprogs 3.6.3 # reiserfsck -V 2>&1|grep reiserfsprogs o reiserfsprogs 3.6.3 # reiserfsck -V 2>&1|grep reiserfsprogs
...@@ -141,14 +141,11 @@ If the unthinkable happens and your kernel oopses, you'll need a 2.4 ...@@ -141,14 +141,11 @@ If the unthinkable happens and your kernel oopses, you'll need a 2.4
version of ksymoops to decode the report; see REPORTING-BUGS in the version of ksymoops to decode the report; see REPORTING-BUGS in the
root of the Linux source for more information. root of the Linux source for more information.
Modutils Module-Init-Tools
-------- --------
Upgrade to recent modutils to fix various outstanding bugs which are A new module loader is now in the kernel that requires module-init-tools
seen more frequently under 2.4.x, and to enable auto-loading of USB to use. It is backward compatible with the 2.4.x series kernels.
modules. In addition, the layout of modules under
/lib/modules/`uname -r`/ has been made more sane. This change also
requires that you upgrade to a recent modutils.
Mkinitrd Mkinitrd
-------- --------
...@@ -306,7 +303,7 @@ o <ftp://ftp.kernel.org/pub/linux/utils/kernel/ksymoops/v2.4/> ...@@ -306,7 +303,7 @@ o <ftp://ftp.kernel.org/pub/linux/utils/kernel/ksymoops/v2.4/>
Modutils Modutils
-------- --------
o <ftp://ftp.kernel.org/pub/linux/utils/kernel/modutils/v2.4/> o <ftp://ftp.kernel.org/pub/linux/kernel/people/rusty/modules/>
Mkinitrd Mkinitrd
-------- --------
......
...@@ -213,7 +213,7 @@ The top Makefile exports the following variables: ...@@ -213,7 +213,7 @@ The top Makefile exports the following variables:
$(GENKSYMS) contains the command used to generate kernel symbol $(GENKSYMS) contains the command used to generate kernel symbol
signatures when CONFIG_MODVERSIONS is enabled. The genksyms signatures when CONFIG_MODVERSIONS is enabled. The genksyms
command comes from the modutils package. command comes from the module-init-tools package.
CROSS_COMPILE CROSS_COMPILE
......
...@@ -3,12 +3,11 @@ in the Linux kernel. This is not a technical description on ...@@ -3,12 +3,11 @@ in the Linux kernel. This is not a technical description on
the internals of module, but mostly a sample of how to compile the internals of module, but mostly a sample of how to compile
and use modules. and use modules.
Note: You should ensure that the modutils-X.Y.Z.tar.gz you are using Note: You should ensure that the module-init-tools-X.Y.Z.tar.gz you
is the most up to date one for this kernel. The "X.Y.Z" will reflect are using is the most up to date one for this kernel. Some older
the kernel version at the time of the release of the modules package. modules packages aren't aware of some of the newer modular features
Some older modules packages aren't aware of some of the newer modular that the kernel now supports. The current required version is listed
features that the kernel now supports. The current required version in the file linux/Documentation/Changes.
is listed in the file linux/Documentation/Changes.
* * * NOTE * * * * * * NOTE * * *
The kernel has been changed to remove kerneld support and use The kernel has been changed to remove kerneld support and use
...@@ -124,7 +123,8 @@ And, yes, there _are_ man-pages for all this... ...@@ -124,7 +123,8 @@ And, yes, there _are_ man-pages for all this...
To use modprobe successfully, you generally place the following To use modprobe successfully, you generally place the following
command in your /etc/rc.d/rc.S script. (Read more about this in the command in your /etc/rc.d/rc.S script. (Read more about this in the
"rc.hints" file in the module utilities package, "modutils-x.y.z.tar.gz".) "rc.hints" file in the module utilities package,
"module-init-tools-x.y.z.tar.gz".)
/sbin/depmod -a /sbin/depmod -a
......
...@@ -54,7 +54,7 @@ Before you can use a module, you'll have to load it with ...@@ -54,7 +54,7 @@ Before you can use a module, you'll have to load it with
insmod scc.o insmod scc.o
please read 'man insmod' that comes with modutils. please read 'man insmod' that comes with module-init-tools.
You should include the insmod in one of the /etc/rc.d/rc.* files, You should include the insmod in one of the /etc/rc.d/rc.* files,
and don't forget to insert a call of sccinit after that. It and don't forget to insert a call of sccinit after that. It
......
...@@ -119,9 +119,9 @@ the README takes precedence. ...@@ -119,9 +119,9 @@ the README takes precedence.
6. Make the modules and install them (make modules; make modules_install). 6. Make the modules and install them (make modules; make modules_install).
Note, for 2.4.x kernels, make sure you have the newer modutils Note, for 2.5.x kernels, make sure you have the newer module-init-tools
loaded or modules will not be loaded properly. 2.4.x changed the installed or modules will not be loaded properly. 2.5.x requires an
layout of /lib/modules/2.4.x and requires an updated modutils. updated module-init-tools.
Plug and Play (PnP: Plug and Play (PnP:
......
...@@ -286,9 +286,9 @@ can be ORed together: ...@@ -286,9 +286,9 @@ can be ORed together:
1 - A module with a non-GPL license has been loaded, this 1 - A module with a non-GPL license has been loaded, this
includes modules with no license. includes modules with no license.
Set by modutils >= 2.4.9. Set by modutils >= 2.4.9 and module-init-tools.
2 - A module was force loaded by insmod -f. 2 - A module was force loaded by insmod -f.
Set by modutils >= 2.4.9. Set by modutils >= 2.4.9 and module-init-tools.
4 - Unsafe SMP processors: SMP with CPUs not designed for SMP. 4 - Unsafe SMP processors: SMP with CPUs not designed for SMP.
============================================================== ==============================================================
......
...@@ -5,8 +5,8 @@ into the bus with power on. In most cases, users expect the devices to become ...@@ -5,8 +5,8 @@ into the bus with power on. In most cases, users expect the devices to become
immediately usable. That means the system must do many things, including: immediately usable. That means the system must do many things, including:
- Find a driver that can handle the device. That may involve - Find a driver that can handle the device. That may involve
loading a kernel module; newer drivers can use modutils to loading a kernel module; newer drivers can use module-init-tools
publish their device (and class) support to user utilities. to publish their device (and class) support to user utilities.
- Bind a driver to that device. Bus frameworks do that using a - Bind a driver to that device. Bus frameworks do that using a
device driver's probe() routine. device driver's probe() routine.
...@@ -76,15 +76,15 @@ user mode daemon to detect changes in system configuration. ...@@ -76,15 +76,15 @@ user mode daemon to detect changes in system configuration.
Currently available policy agent implementations can load drivers for Currently available policy agent implementations can load drivers for
modules, and can invoke driver-specific setup scripts. The newest ones modules, and can invoke driver-specific setup scripts. The newest ones
leverage USB modutils support. Later agents might unload drivers. leverage USB module-init-tools support. Later agents might unload drivers.
USB MODUTILS SUPPORT USB MODUTILS SUPPORT
Current versions of modutils will create a "modules.usbmap" file which Current versions of module-init-tools will create a "modules.usbmap" file
contains the entries from each driver's MODULE_DEVICE_TABLE. Such files which contains the entries from each driver's MODULE_DEVICE_TABLE. Such
can be used by various user mode policy agents to make sure all the right files can be used by various user mode policy agents to make sure all the
driver modules get loaded, either at boot time or later. right driver modules get loaded, either at boot time or later.
See <linux/usb.h> for full information about such table entries; or look See <linux/usb.h> for full information about such table entries; or look
at existing drivers. Each table entry describes one or more criteria to at existing drivers. Each table entry describes one or more criteria to
......
...@@ -51,9 +51,9 @@ CONFIG_VIDEO_DEV=m ...@@ -51,9 +51,9 @@ CONFIG_VIDEO_DEV=m
CONFIG_VIDEO_CPIA=m CONFIG_VIDEO_CPIA=m
CONFIG_VIDEO_CPIA_PP=m CONFIG_VIDEO_CPIA_PP=m
For autoloading of all those modules you need to tell modutils some For autoloading of all those modules you need to tell module-init-tools
stuff. Add the following line to your modutils config-file some stuff. Add the following line to your module-init-tools config-file
(e.g. /etc/modules.conf or wherever your distribution does store that (e.g. /etc/modprobe.conf or wherever your distribution does store that
stuff): stuff):
options parport_pc io=0x378 irq=7 dma=3 options parport_pc io=0x378 irq=7 dma=3
......
...@@ -28,7 +28,7 @@ fdformat --version | awk -F\- '{print "util-linux ", $NF}' ...@@ -28,7 +28,7 @@ fdformat --version | awk -F\- '{print "util-linux ", $NF}'
mount --version | awk -F\- '{print "mount ", $NF}' mount --version | awk -F\- '{print "mount ", $NF}'
insmod -V 2>&1 | awk 'NR==1 {print "modutils ",$NF}' rmmod -V 2>&1 | awk 'NR==1 {print "module-init-tools ",$NF}'
tune2fs 2>&1 | grep "^tune2fs" | sed 's/,//' | awk \ tune2fs 2>&1 | grep "^tune2fs" | sed 's/,//' | awk \
'NR==1 {print "e2fsprogs ", $2}' 'NR==1 {print "e2fsprogs ", $2}'
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment