tinyramfs/README.md
2020-07-19 03:13:13 +03:00

2.0 KiB

Donate with Bitcoin

Tinyramfs

Currently tinyramfs is incomplete, don't expect that everything is working

Features

  • No local's, no bashisms, only POSIX shell
  • Portable, not distro specific
  • Easy to use configuration
  • Build time and init time hooks
  • LUKS (detached header, key), LVM
  • mdev, mdevd, eudev, systemd-udevd

Dependencies

  • POSIX utilities
  • POSIX shell
  • switch_root
  • mount
  • cpio
  • strip
    • Optional
  • blkid
    • Required for UUID, LABEL, PARTUUID support
  • mdev OR mdevd OR eudev OR systemd-udevd OR CONFIG_UEVENT_HELPER
    • systemd-udevd not tested
  • lvm2
    • Required for LVM support
  • cryptsetup
    • Required for LUKS support
  • kmod OR busybox modutils with this patch (already included in KISS Linux)
    • Not required for monolithic kernel

Notes

  • busybox modutils doesn't handle soft dependencies (modules.softdep). You must manually copy them using hooks
  • busybox and toybox blkid doesn't support PARTUUID. You must use util-linux blkid for PARTUUID support
  • cp in toybox incorrectly handles -P flag. You need to apply patch from this issue or replace cp with another implementation

Installation

git clone https://github.com/illiliti/tinyramfs
cd tinyramfs
make install
vi /etc/tinyramfs/config # edit config for your needs
tinyramfs -o /boot/initramfs
# update your bootloader
# reboot...

Configuration

Statically via config

See config

Dynamically via kernel parameters

TODO finalize and document kernel command-line parameters

Thanks

E5ten
dylanaraps

License

Licensed under GPLv3