grml2iso.8.txt

   1 grml2iso(8)
   2 ==========
   3
   4 Name
   5 ----
   6 grml2iso - create a multiboot grml ISO using grml2usb
   7
   8 Synopsis
   9 --------
  10 grml2iso -o <target.iso> <ISO[s]>
  11
  12 *******************************************************************************
  13 Important! The grml team does not take responsibility for loss of any data!
  14 *******************************************************************************
  15
  16 Introduction
  17 ------------
  18
  19 grml2iso allows you to create a multiboot grml ISO. You can specify
  20 two or more grml ISOs and will get one single multiboot ISO as a result.
  21 grml2iso requires and uses grml2usb for this task and installs grub2
  22 as bootmanager on the multiboot ISO.
  23
  24 Options
  25 -------
  26
  27 grml2iso supports the environment variables GRML2USB and WRKDIR.
  28 GRML2USB specifies the path to the grml2usb script you'd like to use.
  29 WRKDIR specifies the work directory for creating the filesystem.
  30 The work directory needs at least as much free disk space as the sum
  31 of all specified ISOs.
  32
  33   *\--o <target.iso>*::
  34
  35 This option is mandatory and specifies where the resulting multiboot grml ISO
  36 should be placed. Note that (to avoid any possible data loss) grml2iso will exit
  37 if the specified target.iso exists already.
  38
  39 Usage examples
  40 --------------
  41
  42   # grml2iso -o /tmp/grml.iso grml_2009.05.iso grml64_2009.05.iso
  43
  44 Create multiboot ISO /tmp/grml.iso with grml_2009.05.iso and grml64_2009.05.iso.
  45
  46   # GRML2USB=/srv/git/grml2usb grml2iso -o /srv/grml.iso /srv/grml/grml_2009.05.iso /srv/grml/grml64-medium_2009.05.iso
  47
  48 Create multiboot ISO /srv/grml.iso with grml_2009.05.iso and
  49 grml64-medium_2009.05.iso using /srv/git/grml2usb as grml2usb script.
  50
  51   # WRKDIR=/mnt/test/grml-tmp grml2iso -o /mnt/test/grml.iso grml_2009.05.iso grml64_2009.05.iso
  52
  53 Use /mnt/test/grml-tmp as working directory for creating the multiboot ISO
  54 /mnt/test/grml.iso with grml_2009.05.iso and grml64_2009.05.iso.
  55
  56 Online Ressources
  57 -----------------
  58
  59 Check out the link:http://grml.org/grml2usb/[grml2usb webpage] and the
  60 link:http://git.grml.org/?p=grml2usb.git[grml2usb git repository].
  61
  62 Bugs
  63 ----
  64 Please report feedback, bugreports and wishes <<X7,to the author>>.
  65
  66 [[X7]]
  67 Authors
  68 -------
  69 Michael Prokop <mika@grml.org> and Thorsten Glaser <tg@mirbsd.org>