+<?xml version="1.0" encoding="UTF-8"?>\r
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
<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.6" />\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
ul > li { color: #aaa; }\r
ul > li > * { color: black; }\r
\r
-pre {\r
+.monospaced, code, pre {\r
+ font-family: "Courier New", Courier, monospace;\r
+ font-size: inherit;\r
+ color: navy;\r
padding: 0;\r
margin: 0;\r
}\r
+pre {\r
+ white-space: pre-wrap;\r
+}\r
\r
#author {\r
color: #527bbd;\r
}\r
\r
div.imageblock div.content { padding-left: 0; }\r
-span.image img { border-style: none; }\r
+span.image img { border-style: none; vertical-align: text-bottom; }\r
a.image:visited { color: white; }\r
\r
dl {\r
margin-bottom: 0.1em;\r
}\r
\r
-div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {\r
+div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {\r
margin-top: 0;\r
margin-bottom: 0;\r
}\r
span.overline { text-decoration: overline; }\r
span.line-through { text-decoration: line-through; }\r
\r
+div.unbreakable { page-break-inside: avoid; }\r
+\r
\r
/*\r
* xhtml11 specific\r
*\r
* */\r
\r
-tt {\r
- font-family: monospace;\r
- font-size: inherit;\r
- color: navy;\r
-}\r
-\r
div.tableblock {\r
margin-top: 1.0em;\r
margin-bottom: 1.5em;\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
*\r
* */\r
\r
-.monospaced {\r
- font-family: monospace;\r
- font-size: inherit;\r
- color: navy;\r
-}\r
-\r
table.tableblock {\r
margin-top: 1.0em;\r
margin-bottom: 1.5em;\r
@media print {\r
body.manpage div#toc { display: none; }\r
}\r
+\r
+\r
</style>\r
<script type="text/javascript">\r
/*<+'])');\r
+ var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');\r
// Function that scans the DOM tree for header elements (the DOM2\r
// nodeIterator API would be a better technique but not supported by all\r
// browsers).\r
var i;\r
for (i = 0; i < toc.childNodes.length; i++) {\r
var entry = toc.childNodes[i];\r
- if (entry.nodeName == 'div'\r
+ if (entry.nodeName.toLowerCase() == 'div'\r
&& entry.getAttribute("class")\r
&& entry.getAttribute("class").match(/^toclevel/))\r
tocEntriesToRemove.push(entry);\r
var entriesToRemove = [];\r
for (i = 0; i < noteholder.childNodes.length; i++) {\r
var entry = noteholder.childNodes[i];\r
- if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote")\r
+ if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")\r
entriesToRemove.push(entry);\r
}\r
for (i = 0; i < entriesToRemove.length; i++) {\r
<div class="sect1">\r
<h2 id="_name">1. Name</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>grml2iso - create a multiboot grml ISO using grml2usb</p></div>\r
+<div class="paragraph"><p>grml2iso - create a multiboot Grml ISO using grml2usb</p></div>\r
</div>\r
</div>\r
<div class="sect1">\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="_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">4. Options</h2>\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
+<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
-<strong>\-c <directory></strong>\r
+<strong>-c <directory></strong>\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
-<strong>\-b <boot params></strong>\r
+<strong>-b <boot params></strong>\r
</dt>\r
<dd>\r
<p>\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
-*\-f *\r
+<strong>-f</strong>\r
</dt>\r
<dd>\r
<p>\r
-Force the program to run and overwrite an existing iso image.\r
+Force the program to run and overwrite an existing ISO image.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
-<strong>\-r <boot param></strong>\r
+<strong>-r <boot param></strong>\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
-<strong>\-p <grml2usb param></strong>\r
+<strong>-p <grml2usb param></strong>\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
-<strong>\-s <URI></strong>\r
+<strong>-s <URI></strong>\r
</dt>\r
<dd>\r
<p>\r
-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.\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><tt># grml2iso -o /tmp/grml.iso grml_2009.05.iso grml64_2009.05.iso</tt></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><tt># grml2iso -b 'lang=de ssh=passwd' -c /tmp/grml-content -o /srv/grml.iso /srv/grml/grml_2009.10.iso</tt></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 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><tt># grml2iso -r quiet -r vga=791 -o /srv/grml.iso /srv/grml-small_2009.10.iso</tt></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="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><tt># GRML2USB=/srv/git/grml2usb grml2iso -o /srv/grml.iso /srv/grml/grml_2009.05.iso /srv/grml/grml64-medium_2009.05.iso</tt></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><tt># WRKDIR=/mnt/test/grml-tmp grml2iso -o /mnt/test/grml.iso grml_2009.05.iso grml64_2009.05.iso</tt></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><tt># grml2iso -p --skip-addons -o /srv/grml.iso /srv/grml-small_2009.10.iso /srv/grml64-small_2009.10.iso</tt></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_ressources">6. Online Ressources</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 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="_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="footnotes"><hr /></div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 2011-12-25 18:20:03 CET\r
+Last updated\r
+ 2020-06-24 08:10:54 UTC\r
</div>\r
</div>\r
</body>\r
projects / grml.org.git / blobdiff