From 1aec3208714b3e7e4982656af5c969368eb68b5b Mon Sep 17 00:00:00 2001 From: Sahan Yılmaz Date: Fri, 28 Feb 2025 10:28:28 +0300 Subject: update --- README | 55 ------------------------------------------------------- 1 file changed, 55 deletions(-) delete mode 100644 README (limited to 'README') diff --git a/README b/README deleted file mode 100644 index cdf16af..0000000 --- a/README +++ /dev/null @@ -1,55 +0,0 @@ -This source repository builds packages that work with initramfs-tools -to add function to an initramfs that is likely cloud specific. - -Most likely, you do not want to install these packages unless you know -what you're doing. - -== growroot == -This initramfs module will re-write the partition table of a disk -so that the root partition has as much space as possible, bumping it -up to the edge of the disk, or the edge of the next partition. - -This is valueable in an environment where a volume can be grown past -its original size. It addresses the following situation: - * The initial [virtual] disk has a partition table on it - * The provisioning system creates a volume with additional space - at the end of the disk (after the root partition) - * the system boots, but cannot use the additional space without a reboot - because the kernel will not re-read the partition table information - of a disk that is in use. - -The way this is addressed is: - * in the initramfs unmount the root filesystem - * rewrite the partition table - * tell the kernel to re-read - * remount the root filesystem - -== rescuevol == -When installed the initramfs will check to see if any partitions -with a label of 'RESCUE_VOL' are attached. If such a volume is attached, -it will boot off that volume rather than the root volume. - -This is useful in a cloud environment, when the user is able to attach -and detach volumes to a running system, but has no other mechanism -for interupting of fixing a failed boot. It is analogous to inserting -a rescue CD into a system to recover from failure. - -It may be helpful in the case where the kernel and ramdisk can be loaded -from the instance, but the system is unusable. This could occur if -an error left ssh access broken or the system didn't come all the way up. - -The user could attach a correctly labeled volume, reboot the instance -and access the system to fix it. - -If the volume contains a file '/etc/rescuevol-ignore' it will be ignored. -This allows you to fix your instance, create that volume and *not* boot the -rescue volume on next boot - -== overlayroot == -Configure overlayfs filesystems over the root device based on -configuration provided by kernel command line or in-image config. - -see overlayroot/etc/overlayroot.conf for more information. - -== dyn-netconf == -see dyn-netconf/doc/README.txt -- cgit v1.2.3