.TH GRML2USB 8
.SH NAME
grml2usb \- install grml on external usb device
.SH SYNOPSIS
.B grml2usb
.RI "<path-to-the-iso-file> <path-to-the-mountpoint>"
.SH DESCRIPTION
This manual page documents briefly the
.B grml2usb
command.
.PP
\fBgrml2usb\fP is a program that lets you boot grml from an external usb device
(typically an usb pen) like from CD. Whereas grml2hd installs the main system to
a given partition, grml2usb just copies the files from the grml-iso to the usb
device. You do not need as much space as the grml2hd installation would take
but just the size of the iso itself (about 700MB for grml, using a 1GB usb
pen works fine therefore).
.SH OPTIONS
grml2usb requires and supports exactly two options:
.TP
.B <path-to-the-iso-file>
The path where the iso you want to use for installation is available.
That's something like for example /home/mika/grml_0.9.iso.
The path could als be a block device or a plain directory (which contains all
files of the iso).
.TP
.B <path-to-the-mountpoint>
This option specifies the mountpoint for your usb device, using the setup in
/etc/fstab. grml2usb copies the iso to this mountpoint and runs syslinux (the
bootloader for the usb device so it can boot at all) on the device later on.
.SH NOTES
Booting via USB might be tricky as you have to take care of several pitfals.
First of all make sure the BIOS of your system is capable of booting from USB
devices at all. You need a primary partition on your usb device with the
bootflag enabled (see 'cfdisk /dev/ice') and with filesystem type vfat
(run 'mkfs.vfat -F 16 -v /dev/ice1' to create it).
.SH USAGE EXAMPLES
.TP
.B grml2usb /home/mika/grml_0.9.iso /mnt/usb-sda1
This will install the iso grml_0.9.iso to the device behind mountpoint
/mnt/usb-sda1 set up via  /etc/fstab.
.TP
.B grml2usb /cdrom /mnt/external1
Install currently running grml to usb-device on /mnt/external1.
.SH SEE ALSO
.BR "http://wiki.grml.org/doku.php?id=usb " and
.BR grml2hd (8)
.SH BUGREPORTS
Please report any bugs you notice to the author.
.SH AUTHOR
grml2usb was written by Michael Prokop <mika@grml.org>.
.PP
This manual page was written by Michael Prokop <mika@grml.org>
for the grml project (but may be used by others).