Go to file
Robert "ar" Gerus cfa2941e58 Update TODO 2013-05-05 23:14:26 +02:00
examples Updated TODO and added some examples 2013-05-02 06:56:04 +02:00
initramfs Typo. 2013-05-05 20:46:32 +02:00
scripts Be a little less nazi in the mkinitramfs script 2013-05-02 01:32:57 +02:00
.gitignore Ignore initramfs-tmpfsroot.gz 2013-04-30 12:00:05 +02:00
LICENSE Add license. Because, why not. 2013-05-02 04:54:37 +02:00
README Added a point in README. 2013-04-30 05:27:41 +02:00
TODO Update TODO 2013-05-05 23:14:26 +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