emo/tinyramfs
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity
55fe9abfdc
tinyramfs/README.md
illiliti 46c73bc54e update
2020-04-17 17:14:25 +03:00

1.9 KiB
Raw Blame History

Tinyramfs

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

Features

  • No local's, no bashisms, only POSIX shell
  • Easy configuration
  • mdev, mdevd, eudev
  • LUKS
  • LVM

Dependencies

  • POSIX shell
  • POSIX utilities
  • switch_root
  • readlink
  • install
  • setsid
  • mount
  • cpio
  • gzip
    • Required by default
  • strip
    • Optional
  • blkid
    • Required for mdev/mdevd
  • mdev OR mdevd OR eudev
    • 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 (builtin modules)

Notes

  • busybox and toybox blkid doesn't support PARTUUID
  • zsh (in POSIX mode) showing some errors, but working fine
  • cp -P is broken in toybox, see here

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...

Usage

usage: tinyramfs [option]
       -o, --output <file>  set initramfs output path
       -c, --config <file>  set config file path
       -m, --moddir <dir>   set modules directory
       -k, --kernel <ver>   set kernel version
       -F, --files  <dir>   set files directory
       -d, --debug          enable debug mode
       -f, --force          overwrite initramfs image

Configuration

Static via config

See config

Dynamic via kernel parameters

TODO finalize and document kernel command-line parameters

Thanks

E5ten dylanaraps

License

Licensed under GPLv3