<font size="2"><div><font class="Apple-style-span" face="'courier new', monospace"><meta http-equiv="content-type" content="text/html; charset=utf-8"><span class="Apple-style-span" style="border-collapse: collapse; font-family: arial, sans-serif; "><font face="'courier new', monospace">Re: </font><span style="font-family: 'courier new', monospace; "><a href="https://bugzilla.redhat.com/show_bug.cgi?id=448030" target="_blank" style="color: rgb(0, 102, 204); text-decoration: none; ">Bug 448030</a> -<span> <span>RFE: create a bootable Live USB stick from the running livecd</span></span></span></span></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"><span class="Apple-style-span" style="border-collapse: collapse; font-family: arial, sans-serif; "><span style="font-family: 'courier new', monospace; "><span><span><br>
</span></span></span></span></font></div><div><font class="Apple-style-span" face="'courier new', monospace"><span class="Apple-style-span" style="border-collapse: collapse; font-family: arial, sans-serif; "><span style="font-family: 'courier new', monospace; "><span><span>Vastly expanded documentation is provided to support this script and its new</span></span></span></span></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"><span class="Apple-style-span" style="border-collapse: collapse;">features. Options were reordered to support following the onboard documentation.</span></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"><br></font></div><div><font class="Apple-style-span" face="'courier new', monospace">From: Frederick Grose <<a href="mailto:fgrose@gmail.com">fgrose@gmail.com</a>></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">Date: Sun, 5 Dec 2010 21:17:13 -0500</font></div><div><font class="Apple-style-span" face="'courier new', monospace"><br></font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">Subject: [PATCH 3/3] Update usage documentation & add it to the script</font></div><div><font class="Apple-style-span" face="'courier new', monospace"><br>
</font></div><div><font class="Apple-style-span" face="'courier new', monospace">Update the usage manual and include all options.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">Provide complete usage documentation onboard the script, as the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">script is often distributed independently.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">---</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> docs/livecd-iso-to-disk.pod | 121 +++++++++++++---</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> tools/livecd-iso-to-disk.sh | 331 +++++++++++++++++++++++++++++++++++++------</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> 2 files changed, 385 insertions(+), 67 deletions(-)</font></div><div><font class="Apple-style-span" face="'courier new', monospace"><br>
</font></div><div><font class="Apple-style-span" face="'courier new', monospace">diff --git a/docs/livecd-iso-to-disk.pod b/docs/livecd-iso-to-disk.pod</font></div><div><font class="Apple-style-span" face="'courier new', monospace">index 1ccab66..7ef0c14 100644</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">--- a/docs/livecd-iso-to-disk.pod</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+++ b/docs/livecd-iso-to-disk.pod</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">@@ -2,63 +2,138 @@</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =head1 NAME</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-livecd-iso-to-disk - installs bootable CD images on a USB storage devices.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+livecd-iso-to-disk - installs bootable Live images onto USB/SD storage devices.</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> =head1 SYNOPSIS</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-B<livecd-iso-to-disk> [--format] [--reset-mbr] [--noverify] [--efi] [--overlay-size-mb <size>] [\-\-home\-size\-mb <size>] [\-\-unencrypted\-home] [\-\-skipcopy] <path-to-iso> <usb storage device></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+B<livecd-iso-to-disk> [--help] [--noverify] [--format] [--reset-mbr] [--efi] [--skipcopy] [--force] [--xo] [--xo-no-home] [--timeout <time>] [--totaltimeout <time>] [--extra-kernel-args <args>] [--multi] [--livedir <dir>] [--compress] [--skipcompress] [--swap-size-mb <size>] [--overlay-size-mb <size>] [--home-size-mb <size>] [--delete-home] [--crypted-home] [--unencrypted-home] <source> <target device></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Simplest</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+The script may be run in simplest form with just the two arguments:</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+B<livecd-iso-to-disk> <source> <target device></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+To execute the script to completion, you will need to run it with root user permissions. SYSLINUX must be installed on the computer running the installation script.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=over 4</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+=item <source></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+This may be the filesystem path to a LiveOS .iso image file, such as from a CD-ROM, DVD, or download. It could also be the device node reference for the mount point of another LiveOS filesystem, including the currently-running one (such as a booted Live CD/DVD/USB, where /dev/live references the running image device).</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item <target device></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+This should be the device partition name for the attached, target device, such as /dev/sdb1 or /dev/sdc1. (Issue the df -Th command to get a listing of the mounted partitions, where you can confirm the filesystem types, available space, and device names.) Be careful to specify the correct device, or you may overwrite important data on another disk!</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=back</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> =head1 DESCRIPTION</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-B<livecd-iso-to-disk> installs a live CD or DVD image(ISO image) onto a USB storage device. The USB storage device can then boot the installed operating system on systems which support booting via USB. B<livecd-iso-to-disk> requires an ISO image and a USB storage device. ISO images can be created with B<livecd-creator>.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+B<livecd-iso-to-disk> installs a Live CD/DVD/USB image (LiveOS) onto a USB/SD storage device (or any storage partition that will boot with a SYSLINUX bootloader). The target storage device can then boot the installed operating system on systems that support booting via the USB or the SD interface. The script requires a LiveOS source image and a target storage device. The source image may be either a LiveOS .iso file, the currently-running LiveOS image, the device node reference for an attached device with an installed LiveOS image, or a file backed by a block device with an installed LiveOS image. If the operating system supports persistent overlays for saving system changes, a pre-sized overlay may be included with the installation.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Unless you request the --format option, the installation does not destroy data outside of the LiveOS, syslinux, & EFI folders on your target device. This allows one to maintain other files on the target disk outside of the LiveOS filesystem.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-B<livecd-iso-to-disk> is not a destructive process; any data you currently have on your USB stick is preserved.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+LiveOS images provide embedded filesystems through the Device-mapper component of the Linux kernel. The embedded filesystems exist within files such as /LiveOS/squashfs.img (the default compressed storage) or /LiveOS/ext3fs.img (an uncompressed version) on the primary volume partition of the storage device. In use, these are read-only filesystems. Optionally, one may specify a persistent LiveOS overlay to hold image-change snapshots (that use write-once, difference-tracking storage) in the /LiveOS/overlay-<device_id> file, which, *one should note*, always grows in size due to the storage mechanism. (The fraction of allocated space that has been consumed by system activity and changes may be displayed by issuing the 'dmsetup status' command in a terminal session of a running LiveOS image.) One way to conserve the unrecoverable, overlay file space, is to specify a persistent home folder for user files, which will be saved in a /LiveOS/home.img filesystem image file. This file space is encrypted by default, but is not compressed. (One may bypass encryption with the --unencrypted-home installation option.) Files in this home folder may be erased to recover and reuse their storage space. The home.img file is also convenient for backing up or swapping user account files.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =head1 OPTIONS</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> =over 4</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --help</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Displays usage information and exits.</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --noverify</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Disables the image validation process that occurs before the image is installed from the original Live CD .iso image. When this option is specified, the image is not verified before loading onto the target storage device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =item --format</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">-Formats the USB stick and creates an MS-DOS partition table (or GPT partition table if --efi is passed).</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Formats the target device and creates an MS-DOS partition table (or GUID partition table, if the --efi option is passed).</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =item --reset-mbr</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">-Sets the Master Boot Record(MBR) of the USB storage device to the mbr.bin file from the image's syslinux directory.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Sets the Master Boot Record (MBR) of the target storage device to the mbr.bin file from the installation system's syslinux directory. This may be helpful in recovering a damaged or corrupted device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-=item --noverify</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --efi</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-Disables the image validation process which occurs before the image is installed. When this option is enabled the image is not verified before installation on the USB storage device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Creates a GUID partition table when --format is passed, and installs a hybrid Extensible Firmware Interface (EFI)/MBR bootloader on the disk. This is necessary for most Intel Macs.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-=item --overlay-size-mb</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --skipcopy</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-This option sets the overlay size in megabytes. The overlay is additional storage available to the live operating system if the operating system supports it. The USB storage device must have enough free space for the image and the overlay.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Skips the copying of the live image to the target device, bypassing the actions of the --format, --overlay-size-mb, --home-size-mb, & --swap-size-mb options, if present on the command line. (The --skipcopy option may be used while testing the script, in order to avoid repeated and lengthy copy commands, or to repair boot configuration files on a previously installed device.)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-=item --home-size-mb</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --force</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-Sets the home directory size in megabytes.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+This option allows the installation script to bypass a delete confirmation dialog in the event that a pre-existing LiveOS directory is found on the target device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-=item --unencrypted-home</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --xo</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-Disables the encryption of the home directory.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Used to prepare an image for the OLPC XO-1 laptop with its compressed, JFFS2 filesystem. Do not use the following options with --xo:</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-=item --skipcopy</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=over 4</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-Skips the copy of the live image to the USB stick and disables the --forma, --home-size-mb, and --swap-size-mb options. The --overlay-size-mb option is changed to only reinitialize the existing overlay area, to recreate it from scratch.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+--overlay-size-mb <size>, home-size-mb <size>, --delete-home, --compress</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">-The intended use of this option is to speed up testing of the boot configuration of live images.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=back</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-=item --efi</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --xo-no-home</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">-Create a GPT partition table when --format is passed, and install an hybrid EFI/MBR bootloader on the disk. This is necessary for most Intel Macs.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Used together with the --xo option to prepare an image for an OLPC XO laptop with the home folder on an SD card instead of the internal flash storage.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =item --timeout</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">-Modify the bootloader's timeout value. This overrides the value set during iso creation. Units are 1/10s</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Modifies the bootloader's timeout value, which indicates how long to pause at the boot: prompt before booting automatically. This overrides the value set during iso creation. Units are 1/10 s. The timeout is canceled when any key is pressed, the assumption being that the user will complete the command line. A timeout of zero will disable the timeout completely.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =item --totaltimeout</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">-Add a totaltimeout to the bootloader config. This is used to force and automatic boot. This cannot be canceled by the user. Units are 1/10s</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Adds a bootloader totaltimeout, which indicates how long to wait before booting automatically. This is used to force an automatic boot. This timeout cannot be canceled by the user. Units are 1/10 s.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --extra-kernel-args <args></font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Specifies additional kernel arguments, <args>, that will be inserted into the syslinux and EFI boot configurations. Multiple arguments should be specified in one string, i.e., --extra-kernel-args "arg1 arg2 ..."</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --multi</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Used when installing multiple image copies to signal configuration of the boot files for the image in the --livedir <dir> parameter.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --livedir <dir></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Used with multiple image installations to designate the directory <dir> for the particular image.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+=item --compress (default state for the operating system files)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+The default, compressed SquashFS filesystem image is copied on installation. This option has no effect when the source filesystem</font></div>
<div>
<font class="Apple-style-span" face="'courier new', monospace">+is already expanded.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --skipcompress (default option when --xo is specified)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Expands the source SquashFS image on installation into the read-only /LiveOS/ext3fs.img filesystem image file.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --swap-size-mb <size></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Sets up a swap file of <size> mebibytes (integer values only) on the target device.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+=item --overlay-size-mb <size></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+This option sets the overlay size in mebibytes (integer values only). The overlay makes persistent storage available to the live operating system, if the operating system supports it. The persistent LiveOS overlay holds image-change snapshots (using write-once, difference-tracking storage) in the /LiveOS/overlay-<device_id> file, which, *one should note*, always grows in size due to the storage mechanism. (The fraction of allocated space that has been consumed may be displayed by issuing the 'dmsetup status' command in a terminal session of a running LiveOS installation.) One way to conserve the unrecoverable, overlay file space, is to specify a persistent home folder for user files, see --home-size-mb below. The target storage device must have enough free space for the image and the overlay. A maximum <size> of 2047 MiB is permitted for vfat-formatted devices. If there is insufficient room on your device, you will be given information to help in adjusting your settings.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --home-size-mb <size></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Sets the home directory size in mebibytes (integer values only). A persistent home directory will be made in the /LiveOS/home.img filesystem image file. This file space is encrypted by default, but not compressed (one may bypass encryption with the --unencrypted-home installation option). Files in this home folder may be erased to recover and reuse their storage space. The target storage device must have enough free space for the image, any overlay, and the home directory. Note that the --delete-home option must also be selected to replace an existing persistent home with a new, empty one. A maximum <size> of 2047 MiB is permitted for vfat-formatted devices. If there is insufficient room on your device, you will be given information to help in adjusting your settings.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --delete-home</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+To prevent unwitting deletion of user files, this option must be explicitly selected when the option --home-size-mb <size> is selected and there is an existing persistent home directory on the target device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --crypted-home (default that only applies to new home-size-mb requests)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+Specifies the default option to encrypt a new persistent home directory if --home-size-mb <size> is specified.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+=item --unencrypted-home</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Prevents the default option to encrypt a new persistent home directory.</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> =back</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">@@ -68,11 +143,11 @@ David Zeuthen, Jeremy Katz, Douglas McClendon, Chris Curran and other contributo</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =head1 BUGS</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">-Report bugs to the mailing list C<<a href="http://www.redhat.com/mailman/listinfo/fedora-livecd-list">http://www.redhat.com/mailman/listinfo/fedora-livecd-list</a>> or directly to Bugzilla C<<a href="http://bugzilla.redhat.com/bugzilla/">http://bugzilla.redhat.com/bugzilla/</a>> against the C<Fedora> product, and the C<lived-tools> component.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Report bugs to the mailing list C<<a href="http://admin.fedoraproject.org/mailman/listinfo/livecd">http://admin.fedoraproject.org/mailman/listinfo/livecd</a>> or directly to Bugzilla C<<a href="http://bugzilla.redhat.com/bugzilla/">http://bugzilla.redhat.com/bugzilla/</a>> against the C<Fedora> product, and the C<livecd-tools> component.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =head1 COPYRIGHT</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">-Copyright (C) Fedora Project 2008,2009, and various contributors. This is free software. You may redistribute copies of it under the terms of the GNU General Public License C<<a href="http://www.gnu.org/licenses/gpl.html">http://www.gnu.org/licenses/gpl.html</a>>. There is NO WARRANTY, to the extent permitted by law.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+Copyright (C) Fedora Project 2008, 2009, 2010 and various contributors. This is free software. You may redistribute copies of it under the terms of the GNU General Public License C<<a href="http://www.gnu.org/licenses/gpl.html">http://www.gnu.org/licenses/gpl.html</a>>. There is NO WARRANTY, to the extent permitted by law.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> =head1 SEE ALSO</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">diff --git a/tools/livecd-iso-to-disk.sh b/tools/livecd-iso-to-disk.sh</font></div><div><font class="Apple-style-span" face="'courier new', monospace">index 3ca4ea7..45a6945 100755</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">--- a/tools/livecd-iso-to-disk.sh</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+++ b/tools/livecd-iso-to-disk.sh</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">@@ -22,8 +22,248 @@</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> export PATH=/sbin:/usr/sbin:$PATH</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">+shortusage() {</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ echo "</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ SYNTAX</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ livecd-iso-to-disk [--help] [--noverify] [--format] [--reset-mbr] [--efi]</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ [--skipcopy] [--force] [--xo] [--xo-no-home]</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ [--timeout <time>] [--totaltimeout <time>]</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ [--extra-kernel-args <args>] [--multi] [--livedir <dir>]</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ [--compress] [--skipcompress] [--swap-size-mb <size>]</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ [--overlay-size-mb <size>] [--home-size-mb <size>]</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ [--delete-home] [--crypted-home] [--unencrypted-home]</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ <source> <target device></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ (Enter livecd-iso-to-disk --help on the command line for more information.)"</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+}</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> usage() {</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- echo "$0 [--timeout <time>] [--totaltimeout <time>] [--format] [--reset-mbr] [--noverify] [--overlay-size-mb <size>] [--home-size-mb <size>] [--unencrypted-home] [--skipcopy] [--efi] <source> <target device>"</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ echo "</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ "</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ shortusage</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ echo "</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ livecd-iso-to-disk - Transfer a LiveOS image so that it's bootable off of</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ a USB/SD device.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ The script may be run in simplest form with just the two arguments:</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ <source></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ This may be the filesystem path to a LiveOS .iso image file,</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ such as from a CD-ROM, DVD, or download. It could also be the</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ device node reference for the mount point of another LiveOS</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ filesystem, including the currently-running one (such as a</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ booted Live CD/DVD/USB, where /dev/live references the running</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ image device).</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ <target device></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ This should be the device partition name for the attached,</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ target device, such as /dev/sdb1 or /dev/sdc1. (Issue the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ df -Th command to get a listing of the mounted partitions,</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ where you can confirm the filesystem types, available space,</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ and device names.) Be careful to specify the correct device,</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ or you may overwrite important data on another disk!</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ To execute the script to completion, you will need to run it with root user</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ permissions.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ SYSLINUX must be installed on the computer running the installation script.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ DESCRIPTION</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ livecd-iso-to-disk installs a Live CD/DVD/USB image (LiveOS) onto a USB/SD</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ storage device (or any storage partition that will boot with a SYSLINUX</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ bootloader). The target storage device can then boot the installed</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ operating system on systems that support booting via the USB or the SD</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ interface. The script requires a LiveOS source image and a target storage</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ device. The source image may be either a LiveOS .iso file, the currently-</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ running LiveOS image, the device node reference for an attached device with</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ an installed LiveOS image, or a file backed by a block device with an</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ installed LiveOS image. If the operating system supports persistent</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ overlays for saving system changes, a pre-sized overlay may be included with</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ the installation.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Unless you request the --format option, the installation does not destroy</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ data outside of the LiveOS, syslinux, & EFI folders on your target device.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ This allows one to maintain other files on the target disk outside of the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ LiveOS filesystem.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ LiveOS images provide embedded filesystems through the Device-mapper</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ component of the Linux kernel. The embedded filesystems exist within files</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ such as /LiveOS/squashfs.img (the default compressed storage) or</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ /LiveOS/ext3fs.img (an uncompressed version) on the primary volume partition</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ of the storage device. In use, these are read-only filesystems. Optionally,</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ one may specify a persistent LiveOS overlay to hold image-change snapshots</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ (that use write-once, difference-tracking storage) in the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ /LiveOS/overlay-<device_id> file, which, *one should note*, always grows in</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ size due to the storage mechanism. (The fraction of allocated space that</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ has been consumed by system activity and changes may be displayed by issuing</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ the 'dmsetup status' command in a terminal session of a running LiveOS</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ image.) One way to conserve the unrecoverable, overlay file space, is to</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ specify a persistent home folder for user files, which will be saved in a</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ /LiveOS/home.img filesystem image file. This file space is encrypted by</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ default, but is not compressed. (One may bypass encryption with the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --unencrypted-home installation option.) Files in this home folder may be</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ erased to recover and reuse their storage space. The home.img file is also</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ convenient for backing up or swapping user account files.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ OPTIONS</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --help</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Displays usage information and exits.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --noverify</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Disables the image validation process that occurs before the image is</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ installed from the original Live CD .iso image. When this option is</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ specified, the image is not verified before loading onto the target</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ storage device.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --format</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Formats the target device and creates an MS-DOS partition table (or GPT</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ partition table, if the --efi option is passed).</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --reset-mbr</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Sets the Master Boot Record (MBR) of the target storage device to the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ mbr.bin file from the installation system's syslinux directory. This</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ may be helpful in recovering a damaged or corrupted device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --efi</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Creates a GUID partition table when --format is passed, and installs a</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ hybrid Extensible Firmware Interface (EFI)/MBR bootloader on the disk.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ This is necessary for most Intel Macs.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --skipcopy</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Skips the copying of the live image to the target device, bypassing the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ actions of the --format, --overlay-size-mb, --home-size-mb, &</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --swap-size-mb options, if present on the command line. (The --skipcopy</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ option may be used while testing the script, in order to avoid repeated</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ and lengthy copy commands, or to repair boot configuration files on a</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ previously installed device.)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ --force</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ This option allows the installation script to bypass a delete</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ confirmation dialog in the event that a pre-existing LiveOS directory</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ is found on the target device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --xo</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Used to prepare an image for the OLPC XO-1 laptop with its compressed,</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ JFFS2 filesystem. Do not use the following options with --xo:</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --overlay-size-mb <size>, home-size-mb <size>, --delete-home,</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --compress</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --xo-no-home</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Used together with the --xo option to prepare an image for an OLPC XO</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ laptop with the home folder on an SD card instead of the internal flash</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ storage.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --timeout</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Modifies the bootloader's timeout value, which indicates how long to</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ pause at the boot: prompt before booting automatically. This overrides</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ the value set during iso creation. Units are 1/10 s. The timeout is</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ canceled when any key is pressed, the assumption being that the user</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ will complete the command line. A timeout of zero will disable the</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ timeout completely.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --totaltimeout</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Adds a bootloader totaltimeout, which indicates how long to wait before</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ booting automatically. This is used to force an automatic boot. This</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ timeout cannot be canceled by the user. Units are 1/10 s.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --extra-kernel-args <args></font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ Specifies additional kernel arguments, <args>, that will be inserted</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ into the syslinux and EFI boot configurations. Multiple arguments</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ should be specified in one string, i.e.,</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --extra-kernel-args \"arg1 arg2 ...\"</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --multi</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Used when installing multiple image copies to signal configuration of</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ the boot files for the image in the --livedir <dir> parameter.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --livedir <dir></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Used with multiple image installations to designate the directory <dir></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ for the particular image.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --compress (default state for the operating system files)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ The default, compressed SquashFS filesystem image is copied on</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ installation. This option has no effect when the source filesystem is</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ already expanded.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --skipcompress (default option when --xo is specified)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Expands the source SquashFS image on installation into the read-only</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ /LiveOS/ext3fs.img filesystem image file.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --swap-size-mb <size></font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Sets up a swap file of <size> mebibytes (integer values only) on the</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ target device.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --overlay-size-mb <size></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ This option sets the overlay size in mebibytes (integer values only).</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ The overlay makes persistent storage available to the live operating</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ system, if the operating system supports it. The persistent LiveOS</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ overlay holds image-change snapshots (using write-once, difference-</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ tracking storage) in the /LiveOS/overlay-<device_id> file, which, *one</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ should note*, always grows in size due to the storage mechanism. (The</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ fraction of allocated space that has been consumed may be displayed by</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ issuing the 'dmsetup status' command in a terminal session of a running</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ LiveOS installation.) One way to conserve the unrecoverable, overlay</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ file space, is to specify a persistent home folder for user files, see</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --home-size-mb below. The target storage device must have enough free</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ space for the image and the overlay. A maximum <size> of 2047 MiB is</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ permitted for vfat-formatted devices. If there is insufficient room on</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ your device, you will be given information to help in adjusting your</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ settings.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --home-size-mb <size></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Sets the home directory size in mebibytes (integer values only). A</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ persistent home directory will be made in the /LiveOS/home.img</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ filesystem image file. This file space is encrypted by default, but not</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ compressed (one may bypass encryption with the --unencrypted-home</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ installation option). Files in this home folder may be erased to</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ recover and reuse their storage space. The target storage device must</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ have enough free space for the image, any overlay, and the home</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ directory. Note that the --delete-home option must also be selected to</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ replace an existing persistent home with a new, empty one. A maximum</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ <size> of 2047 MiB is permitted for vfat-formatted devices. If there is</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ insufficient room on your device, you will be given information to help</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ in adjusting your settings.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --delete-home</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ To prevent unwitting deletion of user files, this option must be</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ explicitly selected when the option --home-size-mb <size> is selected</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ and there is an existing persistent home directory on the target device.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --crypted-home (default that only applies to new home-size-mb requests)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Specifies the default option to encrypt a new persistent home directory</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ if --home-size-mb <size> is specified.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --unencrypted-home</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Prevents the default option to encrypt a new persistent home directory.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ CONTRIBUTORS</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ livecd-iso-to-disk: David Zeuthen, Jeremy Katz, Douglas McClendon,</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Chris Curran and other contributors.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ (See the AUTHORS file in the source distribution for</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ the complete list of credits.)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ BUGS</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Report bugs to the mailing list</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ <a href="http://admin.fedoraproject.org/mailman/listinfo/livecd">http://admin.fedoraproject.org/mailman/listinfo/livecd</a> or directly to</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ Bugzilla <a href="http://bugzilla.redhat.com/bugzilla/">http://bugzilla.redhat.com/bugzilla/</a> against the Fedora product,</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ and the livecd-tools component.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ COPYRIGHT</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ Copyright (C) Fedora Project 2008, 2009, 2010 and various contributors.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ This is free software. You may redistribute copies of it under the terms of</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ the GNU General Public License <a href="http://www.gnu.org/licenses/gpl.html">http://www.gnu.org/licenses/gpl.html</a>.</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ There is NO WARRANTY, to the extent permitted by law.</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ SEE ALSO</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ livecd-creator, project website <a href="http://fedoraproject.org/wiki/FedoraLiveCD">http://fedoraproject.org/wiki/FedoraLiveCD</a></font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ "</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> exit 1</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> }</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">@@ -327,7 +567,7 @@ checkMounted() {</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> checkint() {</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> if ! test $1 -gt 0 2>/dev/null ; then</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- usage</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ shortusage</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> fi</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> }</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace">@@ -395,45 +635,27 @@ LIVEOS=LiveOS</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> HOMEFILE="home.img"</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> while [ $# -gt 2 ]; do</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> case $1 in</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --overlay-size-mb)</font></div>
<div>
<font class="Apple-style-span" face="'courier new', monospace">- checkint $2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- overlaysizemb=$2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- shift</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --home-size-mb)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- checkint $2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- homesizemb=$2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- shift</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --swap-size-mb)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- checkint $2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- swapsizemb=$2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- shift</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --crypted-home)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- cryptedhome=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- ;;</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">- --unencrypted-home)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- cryptedhome=""</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --delete-home)</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">- keephome=""</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --help)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ usage</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> --noverify)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> noverify=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ --format)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ format=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ ;;</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> --reset-mbr|--resetmbr)</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> resetmbr=1</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> --efi|--mactel)</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace"> efi=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --format)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- format=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> --skipcopy)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> skipcopy=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ --force)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ force=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ ;;</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> --xo)</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> xo=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> skipcompress=1</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">@@ -441,39 +663,60 @@ while [ $# -gt 2 ]; do</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> --xo-no-home)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> xonohome=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">- --compress)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- skipcompress=""</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --timeout)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ checkint $2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ timeout=$2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ shift</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --skipcompress)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- skipcompress=1</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --totaltimeout)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ checkint $2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ totaltimeout=$2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ shift</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> --extra-kernel-args)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> kernelargs=$2</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> shift</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --force)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- force=1</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --multi)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ multi=1</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> --livedir)</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> LIVEOS=$2</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace"> shift</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --multi)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- multi=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --compress)</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ skipcompress=""</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- --timeout)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --skipcompress)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ skipcompress=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ ;;</font></div>
<div>
<font class="Apple-style-span" face="'courier new', monospace">+ --swap-size-mb)</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> checkint $2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- timeout=$2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ swapsizemb=$2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> shift</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- --totaltimeout)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ --overlay-size-mb)</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> checkint $2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- totaltimeout=$2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ overlaysizemb=$2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ shift</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --home-size-mb)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ checkint $2</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ homesizemb=$2</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> shift</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --crypted-home)</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ cryptedhome=1</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ ;;</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ --unencrypted-home)</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ cryptedhome=""</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ --delete-home)</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">+ keephome=""</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ ;;</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> *)</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> echo "invalid arg -- $1"</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- usage</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ shortusage</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace"> ;;</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> esac</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> shift</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">@@ -483,16 +726,16 @@ SRC=$(readlink -f "$1")</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> TGTDEV=$(readlink -f "$2")</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> if [ -z "$SRC" ]; then</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- usage</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ shortusage</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> fi</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> if [ ! -b "$SRC" -a ! -f "$SRC" ]; then</font></div><div><font class="Apple-style-span" face="'courier new', monospace">- usage</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">+ shortusage</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> fi</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> </font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> # FIXME: If --format is given, we shouldn't care and just use /dev/foo1</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> if [ -z "$TGTDEV" -o ! -b "$TGTDEV" ]; then</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace">- usage</font></div><div><font class="Apple-style-span" face="'courier new', monospace">+ shortusage</font></div><div><font class="Apple-style-span" face="'courier new', monospace"> fi</font></div>
<div><font class="Apple-style-span" face="'courier new', monospace"> </font></div><div><font class="Apple-style-span" face="'courier new', monospace"> if [ -z "$noverify" ]; then</font></div><div>
<font class="Apple-style-span" face="'courier new', monospace">-- </font></div><div><font class="Apple-style-span" face="'courier new', monospace">1.7.3.2</font></div><div style="color: rgb(0, 0, 153); font-family: 'trebuchet ms', sans-serif; ">
<br></div></font>