X-Git-Url: https://git.grml.org/?p=grml2usb.git;a=blobdiff_plain;f=grml2usb.8.txt;h=75d3662902f3d1c01474e72daa05044cbe44e05d;hp=43a383c72260656eb588238f7b4b9b14c7dd99aa;hb=fda2098cb7123cf7eda8298d5be310ed75f890cd;hpb=ddf2721eb25c00a2816fa5c65cf57127e669aee2 diff --git a/grml2usb.8.txt b/grml2usb.8.txt index 43a383c..75d3662 100644 --- a/grml2usb.8.txt +++ b/grml2usb.8.txt @@ -47,41 +47,41 @@ don't need one) and a bootloader won't be installed automatically. The following options are supported: - *--bootoptions=...*:: + *\--bootoptions=...*:: Use specified bootoptions as default. - *--bootloader-only*:: + *\--bootloader-only*:: Do *not* copy files but instead just install a bootloader. Note that the boot addons are copied to /boot/addons at this stage as well. If you want to skip copying the boot addons consider using the --skip-addons option. - *--copy-only*:: + *\--copy-only*:: Copy files only but do *not* install a bootloader. - *--dry-run*:: + *\--dry-run*:: 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. - *--fat16*:: + *\--fat16*:: Format specified partition with FAT16. **Important:** this will destroy any existing data on the specified partition! - *--force*:: + *\--force*:: Force any (possible dangerous) actions requiring manual interaction (like --fat16). - *--help*:: + *\--help*:: Display usage information and exit. ////////////////////////////////////////////////////////////////////////// - *--initrd=...*:: + *\--initrd=...*:: Install specified initrd instead of the default. You might want to specify option *--kernel* as well. (Be aware when using multiboot setup.) @@ -89,14 +89,14 @@ option *--kernel* as well. (Be aware when using multiboot setup.) ////////////////////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////////////////// - *--kernel=...*:: + *\--kernel=...*:: Install specified kernel instead of the default. You might want to specify option *--initrd* as well. (Be aware when using multiboot setup.) [Notice: not implemented yet.] ////////////////////////////////////////////////////////////////////////// - *--lilo-binary=...*:: + *\--lilo-binary=...*:: Use specified lilo executable for installing master boot record (MBR) when using the --syslinux-mbr option. By default any system wide (from $PATH) lilo @@ -104,7 +104,7 @@ executable is taken. If there can not be find any lilo executable the statically compiled version of the grml2usb Debian package (see /usr/share/grml2usb/lilo/lilo.static.[amd64|i386]) is taken. - *--mbr-menu*:: + *\--mbr-menu*:: Install master boot record (MBR) with integrated boot menu: interactively choose the partition to boot from, with a timeout to load the default partition, or @@ -114,23 +114,23 @@ visible at all but instead directly jumps to the bootloader - being grub or syslinux). Note: This options is available only when using the default MBR and won't have any effect if you're using the --syslinux-mbr option. - *--quiet*:: + *\--quiet*:: Do not output anything but just errors on console. - *--skip-addons*:: + *\--skip-addons*:: Do not install /boot/addons/ files (like dos, grub, memdisk,...). - *--skip-mbr*:: + *\--skip-mbr*:: Do not touch/install the master boot record (MBR). - *--syslinux*:: + *\--syslinux*:: Install syslinux bootloader instead of the default (being grub). - *--syslinux-mbr*:: + *\--syslinux-mbr*:: Install syslinux' master boot record (MBR, which is booting from the partition with the "active" flag set) instead of the default one. If you encounter any @@ -140,24 +140,24 @@ accordingly. Note: When using the --syslinux-mbr option lilo is executed before the MBR is installed so the according partitions are set active. ////////////////////////////////////////////////////////////////////////// - *--squashfs=*:: + *\--squashfs=*:: Install specified squashfs file instead of the default. [Notice: not implemented yet.] ////////////////////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////////////////// - *--uninstall*:: + *\--uninstall*:: Uninstall grml ISO files. [Notice: not implemented yet.] ////////////////////////////////////////////////////////////////////////// - *-v*, *--version*:: + *-v*, *\--version*:: Return version and exit. - *--verbose*:: + *\--verbose*:: Enable verbose mode. @@ -319,6 +319,20 @@ isolinux/syslinux fixes the problem. Frequently Asked Questions (FAQ) -------------------------------- +Where can I get grml2usb? +~~~~~~~~~~~~~~~~~~~~~~~~~ + +grml2usb is available as Debian package via link:http://deb.grml.org/[the +grml-testing Debian repository]. Please make sure you really have the Debian +package installed as having just the grml2usb script available is definitely +*NOT* enough! + +If you do NOT have a Debian based system but still want to be able to use +grml2usb you can use the provided +link:http://grml.org/grml2usb/grml2usb.tgz[http://grml.org/grml2usb/grml2usb.tgz] +(link:http://grml.org/grml2usb/grml2usb.tgz.md5.asc[gpg signed md5 hash]). +Download and extract the tarball and execute the provided script 'install.sh'. + What's the difference between grml2hd and grml2usb? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -361,12 +375,19 @@ The following message: ... is "normal". grub-install sends those messages to stderr. To avoid hiding any possible real error messages grml2usb doesn't ignore those messages. +I'm getting something like "Error: /usr/share/grml2usb/grub/splash.xpm.gz can not be read"!? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Looks like you've just the grml2usb script available. Please make sure you've +the grml2usb Debian package installed. It's available via +link:http://deb.grml.org/[the grml-testing Debian repository]. + Why do I have to use a FAT16 filesystem? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -You have to use a FAT16 filesystem only if you consider using syslinux, Syslinux +You have to use a FAT16 filesystem only if you consider using syslinux. Syslinux (currently) does not support any other filesystems. If you want to use another -filesystem (like ext2/3) just don't use syslinux (drop the --syslinux option) +filesystem (like ext2/3) just don't use syslinux (drop the \--syslinux option) but use the default bootloader (grub) instead. I think I've got a really cool idea! @@ -386,7 +407,7 @@ I've found a bug! ~~~~~~~~~~~~~~~~~ Please <>. Please provide usage examples and output -of your grml2usb commandline (consider using the "--verbose" option). +of your grml2usb commandline (consider using the "\--verbose" option). Usage examples --------------