grml2usb.8.txt

   1 grml2usb(8)
   2 ==========
   3
   4 Name
   5 ----
   6 grml2usb - install grml ISO(s) on usb device for booting
   7
   8 Synopsis
   9 --------
  10 grml2usb [ options ] <ISO[s]> <device>
  11
  12 *******************************************************************************
  13 Important! The grml team does not take responsibility for loss of any data!
  14 *******************************************************************************
  15
  16 Options
  17 -------
  18
  19 The ISO[s] might be the path to one or multiple grml-ISOs as well as the path to
  20 the currently running live-system (being /live/image).
  21
  22 The device either might be a device name like /dev/sda1 or a directory. When
  23 specifying a device name the device is mounted automatically. When specifying a
  24 directory it won't be touched but instead grml2usb is assuming that you did set
  25 up a bootloader on your own and a bootloader won't be installed automatically.
  26
  27 The following options are supported:
  28
  29   *--bootoptions=...*::
  30
  31 Use specified bootoptions as default.
  32
  33   *--dry-run*::
  34
  35 Do not actually execute any commands, instead just show what would be executed.
  36
  37   *--fat16*::
  38
  39 Format specified partition with FAT16. **Important:** this will defstroy any existing
  40 data on the specified partition!
  41
  42   *--force*::
  43
  44 Force any actions requiring manual interaction (like --fat16, --mbr).
  45
  46   *--grub*::
  47
  48 Install grub bootloader instead of syslinux.
  49
  50   *--help*::
  51
  52 Display usage information and exit.
  53
  54   *--initrd=...*::
  55
  56 Install specified initrd instead of the default. You might want to specify
  57 option *--kernel* as well.
  58
  59   *--kernel=...*::
  60
  61 Install specified kernel instead of the default. You might want to specify
  62 option *--initrd* as well. (Be aware when using multiboot setup.)
  63
  64   *--mbr*::
  65
  66 Install master boot record (MBR) on the device.
  67
  68   *--squashfs=*::
  69
  70 Install specified squashfs file as the default.
  71
  72   *--syslinux*::
  73
  74 Install syslinux bootloader (default, requires FAT16 filesystem on the specified partition).
  75
  76   *--uninstall*::
  77
  78 Uninstall grml ISO files.
  79
  80   *-v*, *--version*::
  81
  82 Return version and exit.
  83
  84   *--verbose*::
  85
  86 Enable verbose mode.
  87
  88 Introduction
  89 ------------
  90
  91 grml2usb installs grml on a given partition on your usb device and makes it
  92 bootable.
  93
  94 Directory layout on usb device
  95 ------------------------------
  96
  97   boot/ ->
  98     |-- addons/
  99     |   |-- allinone.img
 100     |   |-- balder10.imz
 101     |   |-- chain.c32
 102     |   |-- memdisk
 103     |   `-- menu.c32
 104     |-- release/
 105     |   |-- grml/
 106     |   |   |-- linux26
 107     |   |   |-- initrd.gz
 108     |   |-- grml64
 109     |   |   |-- linux26
 110     |   |   |-- initrd.gz
 111     |   |-- grml-medium
 112     |   |   |-- linux26
 113     |   |   |-- initrd.gz
 114     |   |-- grml64-medium
 115     |   |   |-- linux26
 116     |   |   |-- initrd.gz
 117     |   |-- grml-small
 118     |   |   |-- linux26
 119     |   |   |-- initrd.gz
 120     |   `-- grml64-small
 121     |       |-- linux26
 122     |       |-- initrd.gz
 123     |-- grub/
 124     |   |-- menu.lst
 125     |   |-- splash.xpm.gz
 126     |   `-- stage2_eltorito
 127     `-- syslinux/
 128         |-- boot.msg
 129         |-- f1
 130         |-- f2
 131         |-- f3
 132         |-- f4
 133         |-- f5
 134         |-- f6
 135         |-- f7
 136         |-- f8
 137         |-- f9
 138         |-- f10
 139         |-- logo.16
 140         `-- syslinux.cfg
 141
 142   grml/
 143     |-- grml2usb.txt
 144     |-- grml-cheatcodes.txt
 145     |-- grml-version.txt
 146     |-- LICENSE.txt
 147     |-- md5sums
 148     |-- README.txt
 149     `-- web/
 150         |-- index.html
 151         |-- style.css
 152         `-- images/
 153             |-- button.png
 154             |-- favicon.png
 155             |-- linux.jpg
 156             `-- logo.png
 157
 158   live/
 159     |-- filesystem.module
 160     |-- grml.squashfs
 161     |-- grml-medium.module
 162     |-- grml-medium.squashfs
 163     |-- grml-small.module
 164     |-- grml-small.squashfs
 165     |-- grml64.module
 166     |-- grml64.squashfs
 167     |-- grml64-medium.module
 168     |-- grml64-medium.squashfs
 169     |-- grml64-small.module
 170     `-- grml64-small.squashfs
 171
 172 Usage examples
 173 --------------
 174
 175   # grml2usb /home/grml/grml_2008.11.iso /dev/sdb1
 176
 177 Install specified ISOs on device /dev/sdb1.
 178
 179   # grml2usb /home/grml/grml_2008.11.iso /home/grml/grml_small_2008.11.iso /dev/sdb1
 180
 181 Install specified ISOs on device /dev/sdb1 for multibooting ISOs.
 182 Note: boot "grml" as usual, for booting grml-small use "grml-small on the
 183 bootprompt, for grml64 use "grml64" and so on...
 184
 185   # grml2usb --fat16 --mbr /home/grml/grml_2008.11.iso /dev/sdb1
 186
 187 Install specified ISO on device /dev/sdb1, install MBR on /dev/sdb and
 188 format partition /dev/sdb1 with FAT16 filesystem.
 189
 190   # grml2usb --grub /home/grml/grml_2008.11.iso /dev/sdb1
 191
 192 Install specified ISO on device /dev/sdb1 and use Grub as bootloader
 193 (instead of syslinux being the default).
 194
 195   # grml2usb --kernel=/boot/vmlinuz-2.6.28-grml --initrd=/boot/initrd.img-2.6.28-grml \
 196              /home/grml/grml_2008.11.iso /dev/sdb1
 197
 198 Install specified ISO on device /dev/sdb1 but use given kernel and initrd
 199 instead of the ones provided by the ISO.
 200
 201   # grml2usb --squashfs=/grml/grml-live/grml_cd/live/grml.squashfs \
 202              /home/grml/grml_2008.11.iso /dev/sdb1
 203
 204 Install specified ISO on device /dev/sdb1 but use given squashfs
 205 file instead of the one provided by the ISO.
 206
 207   # grml2usb --bootoptions="lang=de ssh=mysecret" grml_2008.11.iso /dev/sdb1
 208
 209 Install specified ISO on device /dev/sdb1 and use "lang=de ssh=mysecret" as
 210 default bootoptions.
 211
 212 Bugs
 213 ----
 214 Please report feedback, link:http://grml.org/bugs/[bugreports] and wishes link:http://grml.org/contact/[to the grml-team].
 215
 216 Author
 217 ------
 218 Michael Prokop <mika@grml.org>
 219
 220 /////////////////////////////////////////////////////////////////
 221 http://git.grml.org/?p=grml2usb.git
 222 http://wiki.grml.org/doku.php?id=tips#multiboot_usb_pen
 223 http://www.startx.ro/sugar/isotostick.sh
 224 https://help.ubuntu.com/community/Installation/FromUSBStick
 225 http://unetbootin.sourceforge.net/
 226 http://www.tux.org/pub/people/kent-robotti/looplinux/rip/mkusb.sh
 227 /////////////////////////////////////////////////////////////////