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