rd

tiny cpt ramdisk image generator meant for system rescue
git clone git://git.ckyln.com/rd
Log | Files | Refs | README | LICENSE

README (1843B)


      1 rd -- carbs ramfs generator
      2 ________________________________________________________________________________
      3 
      4 A small initramfs generator without any features, made with system rescue in
      5 mind. No support for module loading, filesystem decryption, etc. Makes use of
      6 the Carbs Packaging Tools[1] to create the initrd image. All the programs are
      7 compiled statically into a cpio archive. This ensures that the programs inside
      8 the ramdisk work standalone. This produces a ~1.4MB archive.
      9 
     10 By default it has busybox, and some filesystem related tools (such as fsck).
     11 The default build script includes a static eudev build that is commented out.
     12 
     13 If you want an actually good, POSIX and feature-rich initrd generator see
     14 tinyramfs[2]. This is simply a pet tool that I use just in case I need to rescue
     15 my system.
     16 
     17 
     18 Installation
     19 ________________________________________________________________________________
     20 
     21 Installation is done through the Makefile
     22 
     23     make install
     24 
     25 this will put ramfs-image to /etc/rd, and create a 'hooks' directory in there
     26 which will be copied to the initramfs.
     27 
     28 
     29 Configuration
     30 _______________________________________________________________________________
     31 
     32 Configuration is done through manually editing the scripts (rd and init), or
     33 setting kernel command line options.
     34 
     35 You can edit the generated initramfs image from the /etc/rd/ramfs-image
     36 directory.
     37 
     38 
     39 Hooks
     40 ________________________________________________________________________________
     41 
     42 A user can add hooks to the /etc/rd/hooks directory which will be copied over
     43 to the initramfs image, and be.
     44 
     45 Those are '*.early-rd' and '*.rd' hooks. Early hooks are run after
     46 pseudo-filesystems are mounted. rd hooks are run just before the
     47 pseudo-filesystems are moved to the root filesystem.
     48 
     49 
     50 [1]: https://git.carbslinux.org/cpt
     51 [2]: https://github.com/illiliti/tinyramfs