X-Git-Url: https://git.grml.org/?p=grml2usb.git;a=blobdiff_plain;f=grml2iso.8.txt;h=14bbdd48c5e28d890d328041fa9932a3cda92de2;hp=b2414ce5d6e00af5e5dbb84d7f9388f1fcf35f0b;hb=HEAD;hpb=73803e492fb5547b10cfdcf02a3d261759deddd3 diff --git a/grml2iso.8.txt b/grml2iso.8.txt index b2414ce..3c574c8 100644 --- a/grml2iso.8.txt +++ b/grml2iso.8.txt @@ -1,25 +1,34 @@ grml2iso(8) -========== +=========== Name ---- -grml2iso - create a multiboot grml ISO using grml2usb +grml2iso - create a multiboot Grml ISO using grml2usb Synopsis -------- grml2iso -o ******************************************************************************* -Important! The grml team does not take responsibility for loss of any data! +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. +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. + +Important +--------- + +The order of the provided ISOs matters for two reasons: + +1) order in boot menu entries: the first ISO specified is listed as first (default) option in the boot menu, further ISOs will be listed below as next options + +2) EFI image to be used: the EFI image for booting via (U)EFI will be taken from the last provided ISO. +Therefore to be able to boot on 64bit EFI systems, you need to provide a 64bit ISO (like grml64-small or grml64-full) as _last_ ISO in the grml2iso command line. Options ------- @@ -27,62 +36,74 @@ 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. +The work directory needs at least as much free disk space as the sum of all specified ISOs. - *\-o *:: + *-o *:: -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. +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 *:: + *-c *:: -The content of the specified directory will be copied to the resulting -multiboot grml ISO. +The content of the specified directory will be copied to the resulting multiboot Grml ISO. - *\-b *:: + *-b *:: Use specified default bootoptions as default. - *\-f *:: + *-f*:: + +Force the program to run and overwrite an existing ISO image. + + *-r *:: -Force the program to run and overwrite an existing iso image. +Remove specified boot parameter from existing command line. +Can be specified multiple times. + *-p *:: +Execute grml2usb with the specified parameters. +For a list of valid parameters have a look at the grml2usb(8) manual page. + + *-s *:: + +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 + # grml2iso -o /tmp/grml-multiboot.iso grml32-small_2020.06.iso grml64-small_2020.06.iso + +Create multiboot ISO /tmp/grml-multiboot.iso with grml32-small_2020.06.iso and grml64-small_2020.06.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-multiboot.iso /srv/grml/grml32-small_2020.06.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. -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-multiboot.iso /srv/grml64-small_2020.06.iso - # GRML2USB=/srv/git/grml2usb grml2iso -o /srv/grml.iso /srv/grml/grml_2009.05.iso /srv/grml/grml64-medium_2009.05.iso +Create a new ISO and remove existing boot parameters quiet and vga=791. -Create multiboot ISO /srv/grml.iso with grml_2009.05.iso and -grml64-medium_2009.05.iso using /srv/git/grml2usb as grml2usb script. + # GRML2USB=/srv/git/grml2usb/grml2usb grml2iso -o /srv/grml-multiboot.iso /srv/grml/grml32-small_2020.06.iso /srv/grml/grml64-medium_2020.06.iso - # WRKDIR=/mnt/test/grml-tmp grml2iso -o /mnt/test/grml.iso grml_2009.05.iso grml64_2009.05.iso +Create multiboot ISO /srv/grml-multiboot.iso with grml32-small_2020.06.iso and grml64-medium_2020.06.iso using /srv/git/grml2usb/grml2usb as grml2usb script. -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. + # WRKDIR=/mnt/test/grml-tmp grml2iso -o /mnt/test/grml-multiboot.iso grml32-small_2020.06.iso grml64-small_2020.06.iso -Online Ressources ------------------ +Use /mnt/test/grml-tmp as working directory for creating the multiboot ISO /mnt/test/grml-multiboot.iso with grml32-small_2020.06.iso and grml64-small_2020.06.iso. -Check out the link:http://grml.org/grml2usb/[grml2usb webpage] and the -link:http://git.grml.org/?p=grml2usb.git[grml2usb git repository]. + # grml2iso -p --skip-addons -o /srv/grml-multiboot.iso /srv/grml64-small_2020.06.iso /srv/grml64-small_2020.06.iso + +Don't copy the addons from the specified ISO images Bugs ---- -Please report feedback, bugreports and wishes <>. +Please report feedback, bug reports and wishes at https://github.com/grml/grml2usb/ [[X7]] -Authors -------- -Michael Prokop and Thorsten Glaser +Author +------ +Michael Prokop