initrd-diskcheck.txt

   1 AUTHOR:         Jim Gifford <lfs-hints at jg555.com>
   2
   3 DATE:           2004-02-14
   4
   5 LICENSE:        GNU Free Documentation License Version 1.2
   6
   7 SYNOPSIS:       initrd for LFS that will check and repair
   8                 ext2 and ext3 file system errors
   9
  10 DESCRIPTION:    This hint will assist you in creating a initrd
  11                 for your LFS system, that will check for file
  12                 system errors
  13
  14 PREREQUISITES:  SCSI and USB Modules must be in modules.conf
  15                 Linux built with modules.
  16                         RAM Disk support built in
  17                         initrd selected
  18                         Root Filesystem must be compiled in
  19                 Busybox-1.00-pre7
  20                 e2fsprogs 1.34
  21 HINT:
  22
  23 Introduction to Initial RAMDisk
  24
  25 This hint will help you configure an LFS system for Initial RAMDisk.
  26 Which will allow you to add modules at start-up instead of compiling them
  27 into the kernel.
  28
  29 The script will auto-detect all SCSI, IDE and USB modules and add them
  30 to the initial ramdisk. It will also detect the root from the fstab file
  31
  32 The above items, upon research are best if configured into the kernel.
  33 You can look at the help of each of the items for more information.
  34
  35 ---
  36 Assumptions Made in this document
  37
  38         I have made the following assumptions in this document.
  39         Files have been downloaded.
  40
  41 ---
  42 Kernel Configuration for 2.4
  43
  44         You will need to make sure the following items are configured
  45         in your kernel. With out these, the initrd will not work
  46         properly.
  47
  48         Block devices  --->
  49                 <M> Loopback device support (or <*>)
  50                 <*> RAM disk support
  51                 (4096)   Default RAM disk size
  52                 [*]   Initial RAM disk (initrd) support
  53
  54         The root and initrd file system must be compiled into the kernel.
  55
  56 ---
  57 Kernel Configuration for 2.6
  58
  59         You will need to make sure the following items are configured
  60         in your kernel. With out these, the initrd will not work
  61         properly.
  62
  63         Device Drivers  --->
  64                 Block devices  --->
  65                         <M> Loopback device support (or <*>)
  66                         <*> RAM disk support
  67                         (4096)   Default RAM disk size
  68                         [*]   Initial RAM disk (initrd) support
  69
  70         The root and initrd file system must be compiled into the kernel.
  71
  72
  73 ---
  74 File Systems
  75
  76         The script has 2 choices of file systems.
  77         ext2 and ext3.
  78
  79         ext2 and ext3 are the most common file systems
  80         in use, but the initrd is usually bigger.
  81         My initrd with ext3 was only 439k. Compressed with
  82         gzip -9
  83
  84 ---
  85 Needed Programs
  86
  87         e2fsprogs
  88         ----
  89
  90         Build as normal, but after install issue these commands
  91
  92         cp e2fsck/e2fsck.static /sbin/e2fsck.static
  93         strip --strip-debug /sbin/e2fsck.static
  94
  95         busybox 1.00-pre3
  96         ----
  97
  98         Download From
  99         http://busybox.net/downloads/busybox-1.00-pre3.tar.bz2
 100
 101         Information
 102         http://busybox.net
 103
 104         Busybox has changed the way the configure the shell. It now
 105         uses a menu driven option very similar to make menuconfig
 106         in linux.
 107
 108         Here is the list of the options needed. Anything else
 109         will add to the size of your initrd.
 110
 111         General Configuration --->
 112                 [*] Support for devfs
 113                         NOTE - only if you using devfs
 114                 Build Options  --->
 115                 [*] Build BusyBox as a static binary (no shared libs)
 116         Coreutils  --->
 117                 [*] echo (basic SUSv3 version taking no options
 118                 [*] ln
 119         Linux Module Utilities  --->
 120                 [*] insmod
 121                 [*]     Support version 2.1.x to 2.4.x Linux kernels
 122                         NOTE - only if your using a 2.4 kernel
 123                 [*]     Support version 2.6.x Linux kernels
 124                          NOTE - only if your using a 2.6 kernel
 125         Another Bourne-like Shell  --->
 126                 [*]     Enable alias support
 127                 [*]     Optimize for size instead of speed
 128                 (0) history size
 129         Linux System Utilities  --->
 130                 [*] pivot_root
 131                 [*] mount
 132
 133         The build size on my system was 502k, considerably smaller than
 134         bash.
 135
 136         After running make menuconfig you will need to run the
 137         following commands.
 138
 139         make
 140         cp busybox /bin/busybox.static.fsck
 141
 142 ---
 143 mkfsckinitrd
 144
 145         For those who do not want to type out the script. It is
 146         available on my CVS server at
 147         http://cvs.jg555.com/viewcvs.cgi/scripts/system
 148
 149         This script will create the initial RAM Disk image file.
 150         By default this script creates /boot/initrd-fsck-{kernelversion}.img
 151
 152         I have sent a mkinitrd file to be placed
 153         in the hints attachments at
 154         http://www.linuxfromscratch.org/hints/downloads/attachments.
 155
 156         The default location for this file is /sbin
 157
 158         There are options on the new script, it will not just create
 159         a initrd anymore. The kernel_version= is the only mandatory
 160         option
 161
 162         Options are the following:
 163
 164         Required
 165         --kernel_version={version} = use kernel version
 166
 167         Optional
 168         --ide = remove ide modules
 169         --scsi = remove scsi modules
 170         --usb = remove usb modules
 171         --devfs = remove devfs settings from initrd
 172         --initrdfs={ext2|ext3} = use either ext2 or ext3
 173         --remove-module={module} = remove module
 174         --add-module={module} = add module
 175
 176 ---
 177 initrd script
 178
 179         The following script needs to placed in /etc/rc.d/init.d.
 180         If you already have this script added, you do not need to
 181         add it again. This is the same one from the initrd hint.
 182
 183         You will then need to link it to rcsysinit.d.
 184
 185         It is recommended that this script be run right after
 186         mountfs.
 187
 188         To link the script change to the /etc/rc.d/rcsysinit.d
 189         directory and issue the following command.
 190
 191         ln -sf ../init.d/initrd S41initrd
 192
 193 #!/bin/bash
 194 # Begin $rc_base/init.d/initrd
 195
 196 # Based on sysklogd script from LFS-3.1 and earlier.
 197 # Rewritten by Gerard Beekmans  - gerard@linuxfromscratch.org
 198
 199 source /etc/sysconfig/rc
 200 source $rc_functions
 201
 202 echo "Clearing Initial RAM Disk..."
 203         if [ -e /initrd/dev/.devfsd ]
 204                 then
 205                 umount /initrd/dev
 206         fi
 207         umount /initrd/proc
 208         umount /initrd
 209         blockdev --flushbufs /dev/ram0
 210
 211 # End $rc_base/init.d/initrd
 212
 213 ---
 214 For Lilo
 215
 216         In order to use the initrd.img file is to add the
 217         following entry to you lilo.conf file.
 218
 219         initrd=/boot/initrd-fsck.img
 220
 221         So your lilo.conf should look something like this.
 222
 223         image=/boot/vmlinuz-2.4.18
 224         label=test
 225         initrd=/boot/initrd-fsck-2.4.18.img
 226         read-only
 227
 228         If you are just testing. You should make a separate
 229         entry in lilo.conf. This will still allow you to boot.
 230
 231 ---
 232 For Grub
 233
 234         In order to use the initrd.img file is to add the
 235         following entry to you menu.lst file.
 236
 237         initrd /boot/initrd-fsck-2.4.18.img
 238
 239         So your menu.lst should look something like this.
 240
 241         title test
 242         root (hd0,1)
 243         kernel /boot/vmlinuz-2.4.18
 244         initrd /boot/initrd-fsck-2.4.18.img
 245
 246 ---
 247 For Syslinux
 248
 249         In order to use the initrd.img file is to add the
 250         following to syslinux.cfg file.
 251
 252         append initrd=initrd-fsck-2.4.18.img
 253
 254         So your syslinux.cfg should look something like this.
 255
 256         label test
 257         kernel vmlinuz
 258         append root=/dev/ram0 initrd=initrd-fsck.img
 259
 260 ---
 261
 262 VERSION:        1.3
 263
 264 CHANGELOG:      1.3 Updated Configurations
 265                 1.2 Updated for 2.6 Kernel
 266                 1.1 Fixed Typos
 267                 1.0 Initial Version
 268
 269  New Version of this document can be viewed from http://cvs.jg555.com/viewcvs.cgi/lfs-hints