Go to file
Robert "ar" Gerus 5f77c40004 Ignore initramfs-tmpfsroot.gz 2013-04-30 12:00:05 +02:00
initramfs Add pv and busybox to gitignore. 2013-04-30 05:45:25 +02:00
scripts v0.4 - Now with README! 2013-04-30 05:24:09 +02:00
.gitignore Ignore initramfs-tmpfsroot.gz 2013-04-30 12:00:05 +02:00
README Added a point in README. 2013-04-30 05:27:41 +02:00

README

1) What is it?
A simple initramfs that looks for a filesystem with a given UUID (not the gpt
PARTUUID), looks there for a .tar.xz file containing a root filesystem and
tries to switch root filesystem to a tmpfs where the tarball was extracted.

2) How to use it?
2.1) Stea^WAcquire statically linked copies of:
 a) busybox (http://www.busybox.net/)
 b) pv (http://www.ivarch.com/programs/pv.shtml)
(protip: use magnets for faster acquiring)
and put the binaries in the initramfs root directory (hint: ./initramfs)

2.2) Get UUID of your filesystem where you have an xz-compressed tarball of
your filesystem.
 ls -l /dev/disk/by-uuid/ might help

2.3) Set these kernel parameters:
 rootfs_location_uuid - uuid of the filesystem containing rootfs tarball
 rootfs_filename - tarball filename
 rootfs_size - size of the tmpfs that will be used as /

2.4) Use scripts/mkinitramfs to generate the initramfs
 For example: ./scripts/mkinitramfs ./initramfs ./initramfs.cpio.gz

2.5) ???
 (you might want to pray to flying spaghetti monster, or some other imaginary
 friend of your choice)

2.6) PROFIT!
 (assuming your system didn't OOM in the process)

3) I've got an idea/suggestion/bugfix!
 Patches welcome:
  git format-patch --stdout -M -C -C -1