From 7dad40eb8d2af91f0143848d719d04311d27a067 Mon Sep 17 00:00:00 2001 From: Michael Prokop Date: Tue, 17 Feb 2009 01:38:05 +0100 Subject: [PATCH] Add FAQ section to the docs --- grml2usb.8.txt | 57 +++++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 49 insertions(+), 8 deletions(-) diff --git a/grml2usb.8.txt b/grml2usb.8.txt index e26d7d3..5a961a6 100644 --- a/grml2usb.8.txt +++ b/grml2usb.8.txt @@ -17,13 +17,11 @@ Introduction ------------ grml2usb installs grml on a given partition of your usb device and makes it -bootable. - -grml2usb 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 bootbrompt then. Notice that the default ISO (that's when pressing just -enter on the bootprompt or wait until the timeout matches) will be the *first* -one specified on the grml2usb command line. +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 bootbrompt 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). Options ------- @@ -230,6 +228,42 @@ Finally create a filesystem and execute grml2usb as needed: mkfs.vfat /dev/loop1 grml2usb --bootloader-only --mbr /grml/isos/grml-small_2008.11.iso /dev/loop1 +Frequently Asked Questions (FAQ) +-------------------------------- + +What's the difference between grml2hd and grml2usb? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +grml2hd installs a running grml system to a harddisk. When rebooting the +harddisk installation can be modified and changes will find their way to the +harddisk immediately. grml2usb copies just the compressed chroot filesystem +(being the squashfs file), some further informational files and a bootloader to +your device. This way you don't need as much space as with a harddisk +installation (just a USB device with >=ISO size) and when rebooting the system +your changes will be lost (even though a persistent root feature is +work-in-progress). Think of using a better CD version: booting is (usually) +faster, you don't need to burn a new CD when a new ISO version arrives (just +install the new ISO using grml2usb) and you can carry additional files on a +writable medium with yourself. + +Why do I have to use a FAT16 filesystem? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +You have to use a FAT16 filesystem if you consider using syslinux (being the +default when using the --mbr option). Syslinux currently does not support any +other filesystems. If you want to use another filesystem (like ext2/3) consider +using the --grub option instead. + +I think I've got a really cool idea! +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Please <>. Or even better: send us a patch. + +I've found a bug! +~~~~~~~~~~~~~~~~~ + +Please <>. Please provide usage examples and output +of your grml2usb commandline (consider using the "--verbose" option). Usage examples -------------- @@ -273,10 +307,17 @@ file instead of the one provided by the ISO. Install specified ISO on device /dev/sdb1 and use "lang=de ssh=mysecret" as default bootoptions. +Online Ressources +----------------- + +Check out the link:http://grml.org/grml2usb/[grml2usb webpage] and the +link:http://git.grml.org/?p=grml2usb.git[grml2usb git repository]. + Bugs ---- -Please report feedback, link:http://grml.org/bugs/[bugreports] and wishes link:http://grml.org/contact/[to the grml-team]. +Please report feedback, bugreports and wishes <>. +[[X7]] Author ------ Michael Prokop -- 2.1.4