Provided by: grml2usb_0.14.13_i386 bug

NAME

       grml2iso - create a multiboot Grml ISO using grml2usb

SYNOPSIS

       grml2iso -o <target.iso> <ISO[s]>

       Important! The grml team does not take responsibility for loss of any
       data!

INTRODUCTION

       grml2iso allows you to create a multiboot Grml ISO. You can specify two
       or more Grml ISOs and will get one single multiboot ISO as a result.
       grml2iso requires and uses grml2usb for this task and installs grub2 as
       bootmanager on the multiboot ISO.

OPTIONS

       grml2iso supports the environment variables GRML2USB and WRKDIR.
       GRML2USB specifies the path to the grml2usb script you’d like to use.
       WRKDIR specifies the work directory for creating the filesystem. The
       work directory needs at least as much free disk space as the sum of all
       specified ISOs.

       -o <target.iso>
           This option is mandatory and specifies where the resulting
           multiboot Grml ISO should be placed. Note that (to avoid any
           possible data loss) grml2iso will exit if the specified target.iso
           exists already.

       -c <directory>
           The content of the specified directory will be copied to the
           resulting multiboot Grml ISO.

       -b <boot params>
           Use specified default bootoptions as default.

       -f
           Force the program to run and overwrite an existing ISO image.

       -r <boot param>
           Remove specified boot parameter from existing command line. Could
           be specified multiple times.

       -p <grml2usb param>
           Execute grml2usb with the specified parameters. For a list of valid
           parameters have a look at the grml2usb webpage[1] or the grml2usb
           manpage

       -s <URI>
           Generate a small ISO file which downloads the squashfs file from
           the specified URI. Due to current limitations in busyboxs wget and
           DNS resolution, an URL can not contain a hostname but an IP only.
           This is useful if you want to boot systems which support booting
           ISO image from your local system. Besides the iso image this
           command also copies the squashfs file to the output directory.

USAGE EXAMPLES

           # grml2iso -o /tmp/grml.iso grml_2009.05.iso grml64_2009.05.iso

       Create multiboot ISO /tmp/grml.iso with grml_2009.05.iso and
       grml64_2009.05.iso.

           # grml2iso -b 'lang=de ssh=passwd' -c /tmp/grml-content -o /srv/grml.iso /srv/grml/grml_2009.10.iso

       Create a new ISO with additional boot parameters and copy the content
       from /tmp/grml-content to the generated ISO image.

           # grml2iso -r quiet -r vga=791 -o /srv/grml.iso /srv/grml-small_2009.10.iso

       Create a new ISO and remove existing boot parameters quiet and vga=791.

           # GRML2USB=/srv/git/grml2usb grml2iso -o /srv/grml.iso /srv/grml/grml_2009.05.iso /srv/grml/grml64-medium_2009.05.iso

       Create multiboot ISO /srv/grml.iso with grml_2009.05.iso and
       grml64-medium_2009.05.iso using /srv/git/grml2usb as grml2usb script.

           # WRKDIR=/mnt/test/grml-tmp grml2iso -o /mnt/test/grml.iso grml_2009.05.iso grml64_2009.05.iso

       Use /mnt/test/grml-tmp as working directory for creating the multiboot
       ISO /mnt/test/grml.iso with grml_2009.05.iso and grml64_2009.05.iso.

           # grml2iso -p --skip-addons -o /srv/grml.iso /srv/grml-small_2009.10.iso /srv/grml64-small_2009.10.iso

       Don’t copy the addons from the specified ISO images

ONLINE RESSOURCES

       Check out the grml2usb webpage[1] and the grml2usb git repository[2].

BUGS

       Please report feedback, bugreports and wishes to the author.

AUTHORS

       Michael Prokop <mika@grml.org[3]> and Thorsten Glaser
       <tg@mirbsd.org[4]>

NOTES

        1. grml2usb webpage
           http://grml.org/grml2usb/

        2. grml2usb git repository
           http://git.grml.org/?p=grml2usb.git

        3. mika@grml.org
           mailto:mika@grml.org

        4. tg@mirbsd.org
           mailto:tg@mirbsd.org

                                  10/24/2015                       GRML2ISO(8)