diff options
Diffstat (limited to 'mdk-stage1/doc/UPDATEMODULES')
| -rw-r--r-- | mdk-stage1/doc/UPDATEMODULES | 62 |
1 files changed, 42 insertions, 20 deletions
diff --git a/mdk-stage1/doc/UPDATEMODULES b/mdk-stage1/doc/UPDATEMODULES index 89d86d365..cfae4dc54 100644 --- a/mdk-stage1/doc/UPDATEMODULES +++ b/mdk-stage1/doc/UPDATEMODULES @@ -2,23 +2,32 @@ This is the documentation for the "Update Modules" (Update Drivers) feature. This feature aims to propose new modules or replacement modules for the -install. This is useful when there is a firmware update for a given -driver, an additional driver needed for something, etc. +install and afterwards. This is useful when there is a firmware update for a +given driver, an additional driver needed for something, etc. You must use a floppy disk with e2fs filesystem (NOT vfat/windows formatted). Use "mke2fs /dev/fd0" on your own box to format a floppy with e2fs filesystem. -This disk may contain a number of kernel modules on the root (e.g. not in -a subdirectory); some of them may replace existing modules, some of them -may be added. This disk must contain a special file, named "to_load", on -the root (not in a subdirectory). This file will contain a series of -module names, with optional module options; the program will try to load -all these modules one after another, using file on the floppy if present, -else using file within standard module repository ("marfile" on the boot -floppy). It can contain comments, these are strictly defined by the -presence of a hash (#) character on column 0 of any line. +This disk may contain a number of kernel modules; some of them +may replace existing modules, some of them may be added. + +Create a directory per kernel version, named from the version, for example +2.6.27-desktop586-0.rc8.2mnb. In this directory put the modules and a special +file, named "to_load". This file will contain a series of module names, with +optional module options; the program will try to load all these modules one +after another, using file on the floppy if present, else using file within +standard module repository. It can contain comments, these are strictly defined +by the presence of a hash (#) character on column 0 of any line. + +This disk may also contain some update or new modules for installed kernels. +Those modules must be placed in directory <kernel-version>. They must be +gzipped if the installed kernel modules are gzipped. + +You may need to specify the "category" so that new modules are used correctly. +For example, a scsi module should be put in category disk/scsi so that it is +put in scsi_hostadapter and initrd. Here's a typical scenario: @@ -36,15 +45,14 @@ Here's a typical scenario: --=----=----=----=----=----=----=----=----=-- Our example disk contains: -[root@obiwan mnt]# ll floppy/ -total 77 -drwxr-xr-x 2 root root 12288 Jul 26 12:02 lost+found/ --rw-r--r-- 1 root root 9051 Jul 26 12:43 msdos.o --rw-r--r-- 1 root root 13660 Jul 26 12:04 ppa.o --rw-r--r-- 1 root root 54 Jul 26 12:46 to_load --rw-r--r-- 1 root root 32108 Jul 26 12:04 uhci.o --rw-r--r-- 1 root root 6572 Jul 26 12:04 wacom.o -[root@obiwan mnt]# cat floppy/to_load +[root@obiwan mnt]# ll floppy/* +2.6.27-desktop586-0.rc8.2mnb/: +total 541 +drwxrwxr-x 3 a a 1024 2009-03-09 12:09 kernel/ +-rw-rw-r-- 1 a a 547480 2009-03-09 12:04 msdos.ko +-rw-rw-r-- 1 a a 54748 2009-03-09 12:04 ppa.ko +-rw-rw-r-- 1 a a 79 2009-03-09 12:08 to_load +[root@obiwan mnt]# cat floppy/*/to_load # Update Drivers description file 3c59x # fat is a dep for msdos @@ -54,6 +62,16 @@ msdos ppa # ISA network card needing options ne io=0x300 irq=7 +# New module [list_modules: disk/scsi] +a320raid +[root@obiwan mnt]# (cd floppy/2.6.27-desktop586-0.rc8.2mnb ; find -type f) +./msdos.ko +./ppa.ko +./to_load +./kernel/fs/msdos/msdos.ko.gz +./kernel/drivers/scsi/ppa.ko.gz +./kernel/drivers/usb/host/uhci-hcd.ko.gz +./kernel/drivers/usb/input/wacom.ko.gz [root@obiwan mnt]# --=----=----=----=----=----=----=----=----=-- @@ -72,3 +90,7 @@ ne io=0x300 irq=7 the case of load from the update modules floppy, that's why on our example we need to load "fat" from the standard modules before "msdos" from the update floppy. + + +4. When system is installed, update floppy is asked again so that update +modules for the installed kernels can be copied. Then depmod is called. |