<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
<head>\r
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 8.6.10" />\r
+<meta name="generator" content="AsciiDoc 9.0.0rc2" />\r
<title>grml2iso(8)</title>\r
<style type="text/css">\r
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */\r
p.table {\r
margin-top: 0;\r
}\r
-/* Because the table frame attribute is overriden by CSS in most browsers. */\r
+/* Because the table frame attribute is overridden by CSS in most browsers. */\r
div.tableblock > table[frame="void"] {\r
border-style: none;\r
}\r
<div class="paragraph"><p>grml2iso -o <target.iso> <ISO[s]></p></div>\r
<div class="sidebarblock">\r
<div class="content">\r
-<div class="paragraph"><p>Important! The grml team does not take responsibility for loss of any data!</p></div>\r
+<div class="paragraph"><p>Important! The Grml team does not take responsibility for loss of any data!</p></div>\r
</div></div>\r
</div>\r
</div>\r
<div class="sect1">\r
<h2 id="_introduction">3. Introduction</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>grml2iso allows you to create a multiboot Grml ISO. You can specify\r
-two or more Grml ISOs and will get one single multiboot ISO as a result.\r
-grml2iso requires and uses grml2usb for this task and installs grub2\r
-as bootmanager on the multiboot ISO.</p></div>\r
+<div class="paragraph"><p>grml2iso allows you to create a multiboot Grml ISO.\r
+You can specify two or more Grml ISOs and will get one single multiboot ISO as a result.\r
+grml2iso requires and uses grml2usb for this task.</p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
-<h2 id="_options">4. Options</h2>\r
+<h2 id="_important">4. Important</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph"><p>The order of the provided ISOs matters for two reasons:</p></div>\r
+<div class="paragraph"><p>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</p></div>\r
+<div class="paragraph"><p>2) EFI image to be used: the EFI image for booting via (U)EFI will be taken from the last provided ISO.\r
+Therefore to be able to boot on 64bit EFI systems, you need to provide a 64bit ISO (like grml64-small or grml64-full) as <em>last</em> ISO in the grml2iso command line.</p></div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_options">5. Options</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>grml2iso supports the environment variables GRML2USB and WRKDIR.\r
GRML2USB specifies the path to the grml2usb script you’d like to use.\r
WRKDIR specifies the work directory for creating the filesystem.\r
-The work directory needs at least as much free disk space as the sum\r
-of all specified ISOs.</p></div>\r
+The work directory needs at least as much free disk space as the sum of all specified ISOs.</p></div>\r
<div class="dlist"><dl>\r
<dt class="hdlist1">\r
<strong>-o <target.iso></strong>\r
</dt>\r
<dd>\r
<p>\r
-This option is mandatory and specifies where the resulting multiboot Grml ISO\r
-should be placed. Note that (to avoid any possible data loss) grml2iso will exit\r
-if the specified target.iso exists already.\r
+This option is mandatory and specifies where the resulting multiboot Grml ISO should be placed.\r
+Note that (to avoid any possible data loss) grml2iso will exit if the specified target.iso exists already.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</dt>\r
<dd>\r
<p>\r
-The content of the specified directory will be copied to the resulting\r
-multiboot Grml ISO.\r
+The content of the specified directory will be copied to the resulting multiboot Grml ISO.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</dt>\r
<dd>\r
<p>\r
-Remove specified boot parameter from existing command line. Could be specified multiple times.\r
+Remove specified boot parameter from existing command line.\r
+Can be specified multiple times.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</dt>\r
<dd>\r
<p>\r
-Execute grml2usb with the specified parameters. For a list of valid parameters have a look at the <a href="http://grml.org/grml2usb/">grml2usb webpage</a> or the grml2usb manpage\r
+Execute grml2usb with the specified parameters.\r
+For a list of valid parameters have a look at the grml2usb(8) manual page.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</dt>\r
<dd>\r
<p>\r
-Generate a small ISO file which downloads the squashfs file from the\r
-specified URI. Due to current limitations in busyboxs wget and DNS\r
-resolution, an URL can not contain a hostname but an IP only. This is\r
-useful if you want to boot systems which support booting ISO image from\r
-your local system. Besides the iso image this command also copies the\r
-squashfs file to the output directory.\r
+Generate a small ISO file which downloads the squashfs file from the specified URI.\r
+Due to current limitations in busyboxs wget and DNS resolution, an URL can not contain a hostname but an IP only.\r
+This is useful if you want to boot systems which support booting ISO image from your local system.\r
+Besides the ISO image this command also copies the squashfs file to the output directory.\r
</p>\r
</dd>\r
</dl></div>\r
</div>\r
</div>\r
<div class="sect1">\r
-<h2 id="_usage_examples">5. Usage examples</h2>\r
+<h2 id="_usage_examples">6. Usage examples</h2>\r
<div class="sectionbody">\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2iso -o /tmp/grml.iso grml_2009.05.iso grml64_2009.05.iso</code></pre>\r
+<pre><code># grml2iso -o /tmp/grml-multiboot.iso grml32-small_2020.06.iso grml64-small_2020.06.iso</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Create multiboot ISO /tmp/grml.iso with grml_2009.05.iso and grml64_2009.05.iso.</p></div>\r
+<div class="paragraph"><p>Create multiboot ISO /tmp/grml-multiboot.iso with grml32-small_2020.06.iso and grml64-small_2020.06.iso.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2iso -b 'lang=de ssh=passwd' -c /tmp/grml-content -o /srv/grml.iso /srv/grml/grml_2009.10.iso</code></pre>\r
+<pre><code># grml2iso -b 'lang=de ssh=passwd' -c /tmp/grml-content -o /srv/grml-multiboot.iso /srv/grml/grml32-small_2020.06.iso</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Create a new ISO with additional boot parameters and copy the content\r
-from /tmp/grml-content to the generated ISO image.</p></div>\r
+<div class="paragraph"><p>Create a new ISO with additional boot parameters and copy the content from /tmp/grml-content to the generated ISO image.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2iso -r quiet -r vga=791 -o /srv/grml.iso /srv/grml-small_2009.10.iso</code></pre>\r
+<pre><code># grml2iso -r quiet -r vga=791 -o /srv/grml-multiboot.iso /srv/grml64-small_2020.06.iso</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Create a new ISO and remove existing boot parameters quiet and vga=791.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># GRML2USB=/srv/git/grml2usb grml2iso -o /srv/grml.iso /srv/grml/grml_2009.05.iso /srv/grml/grml64-medium_2009.05.iso</code></pre>\r
+<pre><code># 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</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Create multiboot ISO /srv/grml.iso with grml_2009.05.iso and\r
-grml64-medium_2009.05.iso using /srv/git/grml2usb as grml2usb script.</p></div>\r
+<div class="paragraph"><p>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.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># WRKDIR=/mnt/test/grml-tmp grml2iso -o /mnt/test/grml.iso grml_2009.05.iso grml64_2009.05.iso</code></pre>\r
+<pre><code># WRKDIR=/mnt/test/grml-tmp grml2iso -o /mnt/test/grml-multiboot.iso grml32-small_2020.06.iso grml64-small_2020.06.iso</code></pre>\r
</div></div>\r
-<div class="paragraph"><p>Use /mnt/test/grml-tmp as working directory for creating the multiboot ISO\r
-/mnt/test/grml.iso with grml_2009.05.iso and grml64_2009.05.iso.</p></div>\r
+<div class="paragraph"><p>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.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2iso -p --skip-addons -o /srv/grml.iso /srv/grml-small_2009.10.iso /srv/grml64-small_2009.10.iso</code></pre>\r
+<pre><code># grml2iso -p --skip-addons -o /srv/grml-multiboot.iso /srv/grml64-small_2020.06.iso /srv/grml64-small_2020.06.iso</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Don’t copy the addons from the specified ISO images</p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
-<h2 id="_online_resources">6. Online Resources</h2>\r
-<div class="sectionbody">\r
-<div class="paragraph"><p>Check out the <a href="http://grml.org/grml2usb/">grml2usb webpage</a> and the\r
-<a href="http://git.grml.org/?p=grml2usb.git">grml2usb git repository</a>.</p></div>\r
-</div>\r
-</div>\r
-<div class="sect1">\r
<h2 id="_bugs">7. Bugs</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>Please report feedback, bugreports and wishes <a href="#X7">to the author</a>.</p></div>\r
+<div class="paragraph"><p>Please report feedback, bug reports and wishes at <a href="https://github.com/grml/grml2usb/">https://github.com/grml/grml2usb/</a></p></div>\r
</div>\r
</div>\r
<div class="sect1">\r
-<h2 id="X7">8. Authors</h2>\r
+<h2 id="X7">8. Author</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>Michael Prokop <<a href="mailto:mika@grml.org">mika@grml.org</a>> and Thorsten Glaser <<a href="mailto:tg@mirbsd.org">tg@mirbsd.org</a>></p></div>\r
+<div class="paragraph"><p>Michael Prokop <<a href="mailto:mika@grml.org">mika@grml.org</a>></p></div>\r
</div>\r
</div>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
Last updated\r
- 2017-09-23 11:51:47 UTC\r
+ 2020-06-24 08:10:54 UTC\r
</div>\r
</div>\r
</body>\r
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA256
-fc09233b692217366dbd1093dbab103a grml2usb.tgz
+24e4944e10195f5c6a6201c336420124 grml2usb.tgz
-----BEGIN PGP SIGNATURE-----
-iQIzBAEBCAAdFiEEM8yxNkAa/shDo4djlqh4crfqNzcFAlwbtZYACgkQlqh4crfq
-NzcAfQ//TmIGqCOpUH2fwUWxpvyvtkoiX77Kq0wZFW8mjMiVOg75yQyja7h1bdos
-sGeruZH6EcyJlW1ZuEIWv90/BWgZ2mnSMW5ijxgfjHy4uNuucRe/IVUiTO6FGSwb
-i4lshhd7mtngY53dnMiyZJ64c1LsS7Ixqzh6XowFBylSle18c4mQsffTfJr1oFJ/
-kY6cqhoDPVy2czK7VtMfiXxkwOyo11Ec0G85T2vFHRRSHaCU5CUZ8443UiIIQTVH
-ZxrmcflTtsHFo73pNcC1buJD9VsfHKK9z8Yd3f5ax5nKTlsrpoxonsDIoF+TuU4C
-TeuaDop8nPC3FKsP2MaHVe7OwdQISyu+sRPFw0uiNRKNSajFu5wVT307S6EcRtgL
-9hHMObNdCAE/DG85qI+hHK65ulxn8on8qqZNgpg6H8O2KeqMLEKsktmBezbgfVAy
-OP9IVofQSEMS+tJLJRL2K+H5rffotlc1JSDhm1wZ7fsAJ5MbuMn7Cjslx0yIbzV5
-HvifZeAx7h+oPuuwqWEIQy6lfedMnfxHYK3B8I7JG+6SYZyyUYGk97b2Qqxq7ofQ
-1owGoq2+UG//0Xdy/ginK0CKJ4b//ok9bwg7j0x6A4qWJA4XbGJOL6jKrCaHiD0n
-2VBdjesiGwrlrTVAokU0GncZ2tBvNXXOhCLWeavtvBtqYZv4oRk=
-=yh4E
+iQIzBAEBCAAdFiEEM8yxNkAa/shDo4djlqh4crfqNzcFAl7zITIACgkQlqh4crfq
+NzfhKg/+Inu2byZlxI+XCklWrx1p4NijG3TcS/ZBaNreKtgE3swXQa7vTU6BxPI/
+SsL40HaNmTCE5ghMiZwe7EEngxdVvN3yjLtkZtb9CV2xR5W5P0r0wVWuq+vd9k7j
+CpqzdM7QJhFp2eLGFCxQkQUsM18kruoz8Es83knzvQar2jYUtxxcaL5tzybEs6rX
+8QReL4qjbpN9yrUhHDxNCjQP1/cOOMVk4VBhCbYr/LdqIpP96igHHACq52XE9Z+p
+xhHBOZ347ICExeeDAVeUhmH5DBBRQslXi6znSGK+LEQtyZVPi3IBsiQDHX8lpUYt
+n1Txzs0psNEawcf4f/M1GsamhVKNXepZSa++WXqh+j3kPZ3/RB4rosSpRsyZfr8K
+RkIUtBwB+wJC8Kws3GQaTjZkmWzCejJMtT8SYvd3tYMgpr2rL0/RvfwyKlIq4YQS
+uIwB+pDCZcP76jv7ekvjj6mB+Q4GtNZwsKA79UX4niyGaLJ8kYRguKM6R0LQB8nu
+AzzUxeB+u3XQi2M+ov+ArPYP8DiBm+yPrG84S0V8012o4EoXpyDbKtyOzQZ7F8lT
+DiBaaEiR0CcSjmBdWqRoO5U/KwOsuzeZeCQIabeoGr6R5KTqSdEl0yGZJ6B+CtVs
+RXk3jejBA+xNnSlWOTBJjgIIJ2IVPKs9GFVYEguKBCxhIbPR6YY=
+=Lyu5
-----END PGP SIGNATURE-----
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
<head>\r
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 8.6.10" />\r
+<meta name="generator" content="AsciiDoc 9.0.0rc2" />\r
<title>grml2usb(8)</title>\r
<style type="text/css">\r
/* Shared CSS for AsciiDoc xhtml11 and html5 backends */\r
p.table {\r
margin-top: 0;\r
}\r
-/* Because the table frame attribute is overriden by CSS in most browsers. */\r
+/* Because the table frame attribute is overridden by CSS in most browsers. */\r
div.tableblock > table[frame="void"] {\r
border-style: none;\r
}\r
<h2 id="options">4. Options</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>ISO[s] should be the path to one or multiple grml-ISOs and/or the path to\r
-the currently running live-system (being /lib/live/mount/medium).</p></div>\r
+the currently running live-system (being /run/live/medium).</p></div>\r
<div class="paragraph"><p>The device either might be a device name like /dev/sdX1 or a directory. When\r
specifying a device name the device is mounted automatically. When specifying a\r
directory grml2usb is assuming that you did set up a bootloader on your own (or\r
</dt>\r
<dd>\r
<p>\r
-Do not check for presence of bootflag on target device.\r
+Do not check for presence of boot flag on target device.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
<div class="literalblock">\r
<div class="content">\r
<pre><code># mkfs.vfat /dev/loop1\r
-# grml2usb --bootloader-only /grml/isos/grml-small_2013.01.iso /dev/loop1</code></pre>\r
+# grml2usb --bootloader-only /grml/isos/grml64-small_2018.12.iso /dev/loop1</code></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
<div class="literalblock">\r
<div class="content">\r
<pre><code># blktrace -d /dev/sdX -o - | blkparse -i -\r
-# grml2usb grml_2013.01.iso /dev/sdX1</code></pre>\r
+# grml2usb grml64-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
</div>\r
</div>\r
system available) running:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code>% dd if=grml_2013.01.iso of=/dev/sdX</code></pre>\r
+<pre><code>% dd if=grml64-full_2018.12.iso of=/dev/sdX</code></pre>\r
</div></div>\r
<div class="paragraph"><p>where /dev/sdX is your USB device. Of course this doesn’t provide such a\r
flexible system like with grml2usb (no multi-ISO setup, no additional default\r
<div class="sectionbody">\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb /home/grml/grml64-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified ISO on device /dev/sdX1.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb /home/grml/grml_2013.01.iso /home/grml/grml_small_2013.01.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb /home/grml/grml64-full_2018.12.iso /home/grml/grml32-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified ISOs on device /dev/sdX1 for multibooting ISOs.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb /lib/live/mount/medium /dev/sdX1</code></pre>\r
+<pre><code># grml2usb /run/live/medium /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install currently running Grml live system on device /dev/sdX1.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb /lib/live/mount/medium /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb /run/live/medium /home/grml/grml64-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install currently running Grml live system and the specified\r
ISO on device /dev/sdX1 for multibooting.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb --fat16 /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb --fat16 /home/grml/grml64-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified ISO on device /dev/sdX1 and format partition /dev/sdX1 with\r
FAT16 filesystem.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb --grub --grub-mbr /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb --grub --grub-mbr /home/grml/grml64-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified ISO on device /dev/sdX1 and use grub as bootloader (instead of\r
syslinux being the default) and install a master boot record (MBR) to the MBR of\r
/dev/sdX.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb --bootoptions="lang=de ssh=mysecret" grml_2013.01.iso /dev/sdX1\r
-# grml2usb --bootoptions="lang=de" --bootoptions="ssh=mysecret" grml_2013.01.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb --bootoptions="lang=de ssh=mysecret" grml64-full_2018.12.iso /dev/sdX1\r
+# grml2usb --bootoptions="lang=de" --bootoptions="ssh=mysecret" grml64-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified ISO on device /dev/sdX1 and use "lang=de ssh=mysecret" as\r
default bootoptions.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb --remove-bootoption="vga=791" --remove-bootoption="nomce" grml_2013.01.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb --remove-bootoption="vga=791" --remove-bootoption="nomce" grml64-full_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified ISO on device /dev/sdX1 remove vga=791 and nomce from existing bootoptions.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><code># grml2usb --bootoptions="persistent-path=%flavour_name" grml64_2010.04.iso grml_2010.04.iso /dev/sdX1</code></pre>\r
+<pre><code># grml2usb --bootoptions="persistent-path=%flavour_name" grml64-small_2018.12.iso grml32-small_2018.12.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified ISOs on device /dev/sdx and add parameter persistent-path\r
to every menu entry. %flavour_name will be expanded to the flavour of the specific\r
<div id="footer">\r
<div id="footer-text">\r
Last updated\r
- 2017-09-23 11:52:01 UTC\r
+ 2020-06-03 13:04:51 UTC\r
</div>\r
</div>\r
</body>\r
projects / grml.org.git / commitdiff