Livecd-iso-to-disk

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(note different versions)
(29 intermediate revisions by 3 users not shown)
Line 1: Line 1:
livecd-iso-to-disk.sh is a bash shell script supplied with livecd-tools, http://git.fedoraproject.org/git/?p=hosted/livecd;a=tree;f=tools;hb=HEAD.
+
<noinclude>
 +
[[Category:LiveMedia]]
 +
</noinclude>
  
Usage is documented in livecd-iso-to-disk.pod, in http://git.fedoraproject.org/git/?p=hosted/livecd;a=tree;f=docs;hb=HEAD, which was copied here for easy revision and review on 05 April 2010.  The revision history of this page shows the proposed changes to this file.
+
'''livecd-iso-to-disk.sh''' is a Bash shell script from livecd-tools, http://git.fedorahosted.org/cgit/livecd/tree/tools/livecd-iso-to-disk.sh
  
==livecd-iso-to-disk.pod==
+
: '''Note''': There are some variations of the script for different versions of Fedora (see [http://git.fedorahosted.org/cgit/livecd/ livecd-tools summary]).
  
=pod
+
In a LiveCD distribution, the script is usually available in the installation disc's filesystem at {{Code|/LiveOS/livecd-iso-to-disk}} (alongside squashfs.img and osmin.img). From a booted LiveOS filesystem, the outer USB/SD/CD/DVD device filesystem is mounted on the {{Code|/run/initramfs/live/}} mount point (or at {{Code|/mnt/live/}} on Fedora 16 and earlier).
  
=head1 NAME
+
Usage is documented in the first 270 or so lines of the the script, and accessible with the {{Code|livecd-iso-to-disk --help}} command. Documentation is also in livecd-iso-to-disk.pod, http://git.fedorahosted.org/cgit/livecd/plain/docs/livecd-iso-to-disk.pod , but the format may be less clear for reading.
 
+
livecd-iso-to-disk - installs bootable CD images on a USB storage devices.
+
 
+
=head1 SYNOPSIS
+
 
+
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>
+
 
+
=head1 DESCRIPTION
+
 
+
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>.
+
 
+
B<livecd-iso-to-disk> is not a destructive process; any data you currently have on your USB stick is preserved.
+
 
+
=head1 OPTIONS
+
 
+
=over 4
+
 
+
=item --format
+
 
+
Formats the USB stick and creates an MS-DOS partition table (or GPT partition table if --efi is passed).
+
 
+
=item --reset-mbr
+
 
+
Sets the Master Boot Record(MBR) of the USB storage device to the mbr.bin file from the image's syslinux directory.
+
 
+
=item --noverify
+
 
+
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.
+
 
+
=item --overlay-size-mb
+
 
+
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.
+
 
+
=item --home-size-mb
+
 
+
Sets the home directory size in megabytes.
+
 
+
=item --unencrypted-home
+
 
+
Disables the encryption of the home directory.
+
 
+
=item --skipcopy
+
 
+
Skips the copy of the live image to the USB stick.
+
 
+
=item --efi
+
 
+
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.
+
 
+
=back
+
 
+
=head1 CONTRIBUTORS
+
 
+
David Zeuthen, Jeremy Katz, Douglas McClendon, Chris Curran and other contributors. See the AUTHORS file in the source distribution for the complete list of credits.
+
 
+
=head1 BUGS
+
 
+
Report bugs to the mailing list C<http://admin.fedoraproject.org/mailman/listinfo/livecd> or directly to Bugzilla C<http://bugzilla.redhat.com/bugzilla/> against the C<Fedora> product, and the C<lived-tools> component.
+
 
+
=head1 COPYRIGHT
+
 
+
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<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
+
 
+
=head1 SEE ALSO
+
 
+
C<livecd-creator(1)>, project website C<http://fedoraproject.org/wiki/FedoraLiveCD>
+
 
+
=cut
+

Revision as of 19:07, 12 November 2012


livecd-iso-to-disk.sh is a Bash shell script from livecd-tools, http://git.fedorahosted.org/cgit/livecd/tree/tools/livecd-iso-to-disk.sh

Note: There are some variations of the script for different versions of Fedora (see livecd-tools summary).

In a LiveCD distribution, the script is usually available in the installation disc's filesystem at /LiveOS/livecd-iso-to-disk (alongside squashfs.img and osmin.img). From a booted LiveOS filesystem, the outer USB/SD/CD/DVD device filesystem is mounted on the /run/initramfs/live/ mount point (or at /mnt/live/ on Fedora 16 and earlier).

Usage is documented in the first 270 or so lines of the the script, and accessible with the livecd-iso-to-disk --help command. Documentation is also in livecd-iso-to-disk.pod, http://git.fedorahosted.org/cgit/livecd/plain/docs/livecd-iso-to-disk.pod , but the format may be less clear for reading.