X-Git-Url: https://git.grml.org/?p=grml2usb.git;a=blobdiff_plain;f=grml2usb.8.txt;h=c908763892a17cde2052a36668125732db2a5e5e;hp=769f42e27663debb58af197a0f8881f18950512b;hb=9003959a6b6a9114bd707354d15e277f0871c2d8;hpb=0deeae3373cffe3a007b8bf6c0b642830601c9b7 diff --git a/grml2usb.8.txt b/grml2usb.8.txt index 769f42e..c908763 100644 --- a/grml2usb.8.txt +++ b/grml2usb.8.txt @@ -3,26 +3,27 @@ grml2usb(8) Name ---- -grml2usb - install grml ISO(s) on usb device for booting +grml2usb - install Grml ISO(s) on usb device for booting Synopsis -------- grml2usb [ options ] ******************************************************************************* -Important! The grml team does not take responsibility for loss of any data! +Important! The Grml team does not take responsibility for loss of any data! ******************************************************************************* [[introduction]] Introduction ------------ -grml2usb installs grml on a given partition of your usb device and makes it -bootable. It provides multi-iso support, meaning you can specify several grml -ISOs on the command line at once and select the grml flavour you would like to -boot on the bootprompt then. Note that the *first* ISO specified on the grml2usb -command line will become the default one (that's the one that will boot when -just pressing enter on the bootprompt or wait until the boot timeout matches). +grml2usb installs Grml on a given partition of your usb device and makes +it bootable. It provides multiboot ISO support, meaning you can specify +several Grml ISOs on the command line at once and select the Grml +flavour you would like to boot on the bootprompt then. Note that the +*first* ISO specified on the grml2usb command line will become the +default one (that's the one that will boot when just pressing enter on +the bootprompt or wait until the boot timeout matches). [IMPORTANT] By default a compatible master boot record (MBR) is installed on the device @@ -35,7 +36,7 @@ default MBR consider using '--syslinux-mbr' instead. Options ------- -The ISO[s] should be the path to one or multiple grml-ISOs and/or the path to +ISO[s] should be the path to one or multiple grml-ISOs and/or the path to the currently running live-system (being /lib/live/mount/medium). The device either might be a device name like /dev/sdX1 or a directory. When @@ -65,7 +66,7 @@ Copy files only but do *not* install a bootloader. Avoid executing commands, instead show what would be executed. Warning: please notice that the ISO has to be mounted anyway, otherwise -identifying the grml flavour would not be possible. +identifying the Grml flavour would not be possible. *\--fat16*:: @@ -129,6 +130,10 @@ Do not install /boot/addons/ files (like dos, grub, memdisk,...). Remove specified bootoption (could be a regex) from existing boot options. Use multiple entries for removing different bootoptions at once. + *\--skip-bootflag*:: + +Do not check for presence of bootflag on target device. + *\--skip-grub-config*:: Skip generation of grub configuration files. By default the configuration @@ -145,6 +150,12 @@ Skip generation of syslinux configuration files. By default the configuration files for syslinux *and* grub will be written so you've a working configuration file no matter whether you're using grub or syslinux as bootloader. + *\--skip-usb-check*:: + +Skip check to verify whether given device is a removable device. +Some USB devices are known to report wrong information, when using +such a device you can skip grml2usb's removable device check. + *\--syslinux*:: This option is deprecated and is being left only for backwards compatibility @@ -170,7 +181,7 @@ Install specified squashfs file instead of the default. ////////////////////////////////////////////////////////////////////////// *\--uninstall*:: -Uninstall grml ISO files. +Uninstall Grml ISO files. [Notice: not implemented yet.] ////////////////////////////////////////////////////////////////////////// @@ -227,7 +238,7 @@ Directory layout on usb device grml/ |-- grml2usb.txt [not yet implemented] - |-- grml-cheatcodes.txt [list of bootoptions for grml] + |-- grml-cheatcodes.txt [list of bootoptions for Grml] |-- grml-version.txt [file containing information about grml-version] |-- LICENSE.txt [license information] |-- md5sums [md5sums of original ISO] @@ -377,14 +388,14 @@ grml2usb.tgz. Why can't I just dd the ISO to a USB device? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Well, you can. :) Starting with grml 2009.10 the ISOs are dd-able straight out-of-the-box. +Well, you can. :) Starting with Grml 2009.10 the ISOs are dd-able straight out-of-the-box. [IMPORTANT] Note that ANY existing data on your USB device will be destroyed when using the dd approach. /////////////////////////////////////////////////////////////////////////////////////////////////// -Grab a recent grml ISO and use +Grab a recent Grml ISO and use link:http://syslinux.zytor.com/wiki/index.php/Doc/isolinux#HYBRID_CD-ROM.2FHARD_DISK_MODE[isohybrid from the syslinux project]: @@ -616,13 +627,13 @@ Install specified ISO on device /dev/sdX1 remove vga=791 and nomce from existing # grml2usb --bootoptions="persistent-path=%flavour_name" grml64_2010.04.iso grml_2010.04.iso /dev/sdX1 -Install specified Isos on device /dev/sdx and add parameter persisten-path +Install specified ISOs on device /dev/sdx and add parameter persistent-path to every menu entry. %flavour_name will be expanded to the flavour of the specific iso, e.g. grml64 and grml. -[[ressources]] -Online Ressources ------------------ +[[resources]] +Online Resources +---------------- Check out the link:http://grml.org/grml2usb/[grml2usb webpage] and the link:http://git.grml.org/?p=grml2usb.git[grml2usb git repository].