"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="text/html; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 8.5.2" />\r
+<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
+<meta name="generator" content="AsciiDoc 8.6.6" />\r
<title>grml2usb(8)</title>\r
<style type="text/css">\r
-/* Debug borders */\r
-p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {\r
-/*\r
- border: 1px solid red;\r
-*/\r
+/* Shared CSS for AsciiDoc xhtml11 and html5 backends */\r
+\r
+/* Default font. */\r
+body {\r
+ font-family: Georgia,serif;\r
+}\r
+\r
+/* Title font. */\r
+h1, h2, h3, h4, h5, h6,\r
+div.title, caption.title,\r
+thead, p.table.header,\r
+#toctitle,\r
+#author, #revnumber, #revdate, #revremark,\r
+#footer {\r
+ font-family: Arial,Helvetica,sans-serif;\r
}\r
\r
body {\r
color: #083194;\r
}\r
\r
-tt {\r
- color: navy;\r
-}\r
-\r
h1, h2, h3, h4, h5, h6 {\r
color: #527bbd;\r
- font-family: sans-serif;\r
margin-top: 1.2em;\r
margin-bottom: 0.5em;\r
line-height: 1.3;\r
h3 + * {\r
clear: left;\r
}\r
+h5 {\r
+ font-size: 1.0em;\r
+}\r
\r
div.sectionbody {\r
- font-family: serif;\r
margin-left: 0;\r
}\r
\r
ul, ol, li > p {\r
margin-top: 0;\r
}\r
+ul > li { color: #aaa; }\r
+ul > li > * { color: black; }\r
\r
pre {\r
padding: 0;\r
margin: 0;\r
}\r
\r
-span#author {\r
+#author {\r
color: #527bbd;\r
- font-family: sans-serif;\r
font-weight: bold;\r
font-size: 1.1em;\r
}\r
-span#email {\r
+#email {\r
}\r
-span#revnumber, span#revdate, span#revremark {\r
- font-family: sans-serif;\r
+#revnumber, #revdate, #revremark {\r
}\r
\r
-div#footer {\r
- font-family: sans-serif;\r
+#footer {\r
font-size: small;\r
border-top: 2px solid silver;\r
padding-top: 0.5em;\r
margin-top: 4.0em;\r
}\r
-div#footer-text {\r
+#footer-text {\r
float: left;\r
padding-bottom: 0.5em;\r
}\r
-div#footer-badges {\r
+#footer-badges {\r
float: right;\r
padding-bottom: 0.5em;\r
}\r
\r
-div#preamble {\r
+#preamble {\r
margin-top: 1.5em;\r
margin-bottom: 1.5em;\r
}\r
-div.tableblock, div.imageblock, div.exampleblock, div.verseblock,\r
+div.imageblock, div.exampleblock, div.verseblock,\r
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,\r
div.admonitionblock {\r
margin-top: 1.0em;\r
/* Block element titles. */\r
div.title, caption.title {\r
color: #527bbd;\r
- font-family: sans-serif;\r
font-weight: bold;\r
text-align: left;\r
margin-top: 1.0em;\r
\r
div.sidebarblock > div.content {\r
background: #ffffee;\r
- border: 1px solid silver;\r
+ border: 1px solid #dddddd;\r
+ border-left: 4px solid #f0f0f0;\r
padding: 0.5em;\r
}\r
\r
div.listingblock > div.content {\r
- border: 1px solid silver;\r
- background: #f4f4f4;\r
+ border: 1px solid #dddddd;\r
+ border-left: 5px solid #f0f0f0;\r
+ background: #f8f8f8;\r
padding: 0.5em;\r
}\r
\r
padding-left: 1.0em;\r
margin-left: 1.0em;\r
margin-right: 10%;\r
- border-left: 5px solid #dddddd;\r
- color: #777777;\r
+ border-left: 5px solid #f0f0f0;\r
+ color: #888;\r
}\r
\r
div.quoteblock > div.attribution {\r
text-align: right;\r
}\r
\r
-div.verseblock > div.content {\r
- white-space: pre;\r
+div.verseblock > pre.content {\r
+ font-family: inherit;\r
+ font-size: inherit;\r
}\r
div.verseblock > div.attribution {\r
padding-top: 0.75em;\r
margin-bottom: 0.1em;\r
}\r
\r
-div.tableblock > table {\r
- border: 3px solid #527bbd;\r
-}\r
-thead, p.table.header {\r
- font-family: sans-serif;\r
- font-weight: bold;\r
-}\r
tfoot {\r
font-weight: bold;\r
}\r
td > div.verse {\r
white-space: pre;\r
}\r
-p.table {\r
- margin-top: 0;\r
-}\r
-/* Because the table frame attribute is overriden by CSS in most browsers. */\r
-div.tableblock > table[frame="void"] {\r
- border-style: none;\r
-}\r
-div.tableblock > table[frame="hsides"] {\r
- border-left-style: none;\r
- border-right-style: none;\r
-}\r
-div.tableblock > table[frame="vsides"] {\r
- border-top-style: none;\r
- border-bottom-style: none;\r
-}\r
-\r
\r
div.hdlist {\r
margin-top: 0.8em;\r
min-width: 100px;\r
}\r
\r
+div.colist td {\r
+ padding-right: 0.5em;\r
+ padding-bottom: 0.3em;\r
+ vertical-align: top;\r
+}\r
+div.colist td img {\r
+ margin-top: 0.3em;\r
+}\r
\r
@media print {\r
- div#footer-badges { display: none; }\r
+ #footer-badges { display: none; }\r
}\r
\r
-div#toc {\r
+#toc {\r
margin-bottom: 2.5em;\r
}\r
\r
-div#toctitle {\r
+#toctitle {\r
color: #527bbd;\r
- font-family: sans-serif;\r
font-size: 1.1em;\r
font-weight: bold;\r
margin-top: 1.0em;\r
margin-left: 6em;\r
font-size: 0.9em;\r
}\r
-/* Workarounds for IE6's broken and incomplete CSS2. */\r
\r
-div.sidebar-content {\r
- background: #ffffee;\r
- border: 1px solid silver;\r
- padding: 0.5em;\r
+span.aqua { color: aqua; }\r
+span.black { color: black; }\r
+span.blue { color: blue; }\r
+span.fuchsia { color: fuchsia; }\r
+span.gray { color: gray; }\r
+span.green { color: green; }\r
+span.lime { color: lime; }\r
+span.maroon { color: maroon; }\r
+span.navy { color: navy; }\r
+span.olive { color: olive; }\r
+span.purple { color: purple; }\r
+span.red { color: red; }\r
+span.silver { color: silver; }\r
+span.teal { color: teal; }\r
+span.white { color: white; }\r
+span.yellow { color: yellow; }\r
+\r
+span.aqua-background { background: aqua; }\r
+span.black-background { background: black; }\r
+span.blue-background { background: blue; }\r
+span.fuchsia-background { background: fuchsia; }\r
+span.gray-background { background: gray; }\r
+span.green-background { background: green; }\r
+span.lime-background { background: lime; }\r
+span.maroon-background { background: maroon; }\r
+span.navy-background { background: navy; }\r
+span.olive-background { background: olive; }\r
+span.purple-background { background: purple; }\r
+span.red-background { background: red; }\r
+span.silver-background { background: silver; }\r
+span.teal-background { background: teal; }\r
+span.white-background { background: white; }\r
+span.yellow-background { background: yellow; }\r
+\r
+span.big { font-size: 2em; }\r
+span.small { font-size: 0.6em; }\r
+\r
+span.underline { text-decoration: underline; }\r
+span.overline { text-decoration: overline; }\r
+span.line-through { text-decoration: line-through; }\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
}\r
-div.sidebar-title, div.image-title {\r
+div.tableblock > table {\r
+ border: 3px solid #527bbd;\r
+}\r
+thead, p.table.header {\r
+ font-weight: bold;\r
color: #527bbd;\r
- font-family: sans-serif;\r
+}\r
+p.table {\r
+ margin-top: 0;\r
+}\r
+/* Because the table frame attribute is overriden by CSS in most browsers. */\r
+div.tableblock > table[frame="void"] {\r
+ border-style: none;\r
+}\r
+div.tableblock > table[frame="hsides"] {\r
+ border-left-style: none;\r
+ border-right-style: none;\r
+}\r
+div.tableblock > table[frame="vsides"] {\r
+ border-top-style: none;\r
+ border-bottom-style: none;\r
+}\r
+\r
+\r
+/*\r
+ * html5 specific\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
+}\r
+thead, p.tableblock.header {\r
font-weight: bold;\r
- margin-top: 0.0em;\r
- margin-bottom: 0.5em;\r
+ color: #527bbd;\r
+}\r
+p.tableblock {\r
+ margin-top: 0;\r
+}\r
+table.tableblock {\r
+ border-width: 3px;\r
+ border-spacing: 0px;\r
+ border-style: solid;\r
+ border-color: #527bbd;\r
+ border-collapse: collapse;\r
+}\r
+th.tableblock, td.tableblock {\r
+ border-width: 1px;\r
+ padding: 4px;\r
+ border-style: solid;\r
+ border-color: #527bbd;\r
}\r
\r
-div.listingblock div.content {\r
- border: 1px solid silver;\r
- background: #f4f4f4;\r
- padding: 0.5em;\r
+table.tableblock.frame-topbot {\r
+ border-left-style: hidden;\r
+ border-right-style: hidden;\r
+}\r
+table.tableblock.frame-sides {\r
+ border-top-style: hidden;\r
+ border-bottom-style: hidden;\r
+}\r
+table.tableblock.frame-none {\r
+ border-style: hidden;\r
}\r
\r
-div.quoteblock-attribution {\r
- padding-top: 0.5em;\r
+th.tableblock.halign-left, td.tableblock.halign-left {\r
+ text-align: left;\r
+}\r
+th.tableblock.halign-center, td.tableblock.halign-center {\r
+ text-align: center;\r
+}\r
+th.tableblock.halign-right, td.tableblock.halign-right {\r
text-align: right;\r
}\r
\r
-div.verseblock-content {\r
- white-space: pre;\r
+th.tableblock.valign-top, td.tableblock.valign-top {\r
+ vertical-align: top;\r
}\r
-div.verseblock-attribution {\r
- padding-top: 0.75em;\r
- text-align: left;\r
+th.tableblock.valign-middle, td.tableblock.valign-middle {\r
+ vertical-align: middle;\r
+}\r
+th.tableblock.valign-bottom, td.tableblock.valign-bottom {\r
+ vertical-align: bottom;\r
}\r
\r
-div.exampleblock-content {\r
- border-left: 3px solid #dddddd;\r
- padding-left: 0.5em;\r
+\r
+/*\r
+ * manpage specific\r
+ *\r
+ * */\r
+\r
+body.manpage h1 {\r
+ padding-top: 0.5em;\r
+ padding-bottom: 0.5em;\r
+ border-top: 2px solid silver;\r
+ border-bottom: 2px solid silver;\r
+}\r
+body.manpage h2 {\r
+ border-style: none;\r
+}\r
+body.manpage div.sectionbody {\r
+ margin-left: 3em;\r
}\r
\r
-/* IE6 sets dynamically generated links as visited. */\r
-div#toc a:visited { color: blue; }\r
+@media print {\r
+ body.manpage div#toc { display: none; }\r
+}\r
</style>\r
<script type="text/javascript">\r
/*<![CDATA[*/\r
-window.onload = function(){asciidoc.footnotes(); asciidoc.toc(2);}\r
var asciidoc = { // Namespace.\r
\r
/////////////////////////////////////////////////////////////////////\r
}\r
\r
var toc = document.getElementById("toc");\r
+ if (!toc) {\r
+ return;\r
+ }\r
+\r
+ // Delete existing TOC entries in case we're reloading the TOC.\r
+ var tocEntriesToRemove = [];\r
+ var i;\r
+ for (i = 0; i < toc.childNodes.length; i++) {\r
+ var entry = toc.childNodes[i];\r
+ if (entry.nodeName == 'div'\r
+ && entry.getAttribute("class")\r
+ && entry.getAttribute("class").match(/^toclevel/))\r
+ tocEntriesToRemove.push(entry);\r
+ }\r
+ for (i = 0; i < tocEntriesToRemove.length; i++) {\r
+ toc.removeChild(tocEntriesToRemove[i]);\r
+ }\r
+\r
+ // Rebuild TOC entries.\r
var entries = tocEntries(document.getElementById("content"), toclevels);\r
for (var i = 0; i < entries.length; ++i) {\r
var entry = entries[i];\r
*/\r
\r
footnotes: function () {\r
- var cont = document.getElementById("content");\r
+ // Delete existing footnote entries in case we're reloading the footnodes.\r
+ var i;\r
var noteholder = document.getElementById("footnotes");\r
+ if (!noteholder) {\r
+ return;\r
+ }\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
+ entriesToRemove.push(entry);\r
+ }\r
+ for (i = 0; i < entriesToRemove.length; i++) {\r
+ noteholder.removeChild(entriesToRemove[i]);\r
+ }\r
+\r
+ // Rebuild footnote entries.\r
+ var cont = document.getElementById("content");\r
var spans = cont.getElementsByTagName("span");\r
var refs = {};\r
var n = 0;\r
for (i=0; i<spans.length; i++) {\r
if (spans[i].className == "footnote") {\r
n++;\r
- // Use [\s\S] in place of . so multi-line matches work.\r
- // Because JavaScript has no s (dotall) regex flag.\r
- note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];\r
+ var note = spans[i].getAttribute("data-note");\r
+ if (!note) {\r
+ // Use [\s\S] in place of . so multi-line matches work.\r
+ // Because JavaScript has no s (dotall) regex flag.\r
+ note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];\r
+ spans[i].innerHTML =\r
+ "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +\r
+ "' title='View footnote' class='footnote'>" + n + "</a>]";\r
+ spans[i].setAttribute("data-note", note);\r
+ }\r
noteholder.innerHTML +=\r
"<div class='footnote' id='_footnote_" + n + "'>" +\r
"<a href='#_footnoteref_" + n + "' title='Return to text'>" +\r
n + "</a>. " + note + "</div>";\r
- spans[i].innerHTML =\r
- "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +\r
- "' title='View footnote' class='footnote'>" + n + "</a>]";\r
var id =spans[i].getAttribute("id");\r
if (id != null) refs["#"+id] = n;\r
}\r
}\r
}\r
}\r
+},\r
+\r
+install: function(toclevels) {\r
+ var timerId;\r
+\r
+ function reinstall() {\r
+ asciidoc.footnotes();\r
+ if (toclevels) {\r
+ asciidoc.toc(toclevels);\r
+ }\r
+ }\r
+\r
+ function reinstallAndRemoveTimer() {\r
+ clearInterval(timerId);\r
+ reinstall();\r
+ }\r
+\r
+ timerId = setInterval(reinstall, 500);\r
+ if (document.addEventListener)\r
+ document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);\r
+ else\r
+ window.onload = reinstallAndRemoveTimer;\r
}\r
\r
}\r
+asciidoc.install(2);\r
/*]]>*/\r
</script>\r
</head>\r
-<body>\r
+<body class="article">\r
<div id="header">\r
<h1>grml2usb(8)</h1>\r
-<div id="toc">\r
- <div id="toctitle">Table of Contents</div>\r
- <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>\r
+<div id="toc">
+ <div id="toctitle">Table of Contents</div>
+ <noscript><p><b>JavaScript must be enabled in your browser to display the table of contents.</b></p></noscript>
</div>\r
</div>\r
<div id="content">\r
+<div class="sect1">\r
<h2 id="_name">1. Name</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>grml2usb - install grml ISO(s) on usb device for booting</p></div>\r
</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="_synopsis">2. Synopsis</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>grml2usb [ options ] <ISO[s]> <device></p></div>\r
<div class="sidebarblock">\r
-<div class="sidebar-content">\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></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>grml2usb installs grml on a given partition of your usb device and makes it\r
default MBR consider using <em>--syslinux-mbr</em> instead.</td>\r
</tr></table>\r
</div>\r
-<div class="admonitionblock">\r
-<table><tr>\r
-<td class="icon">\r
-<img src="./images/icons/note.png" alt="Note" />\r
-</td>\r
-<td class="content">Whereas grml2usb is the script to install recent grml ISOs (>=2009.10) the\r
-script grml2usb-compat supports older grml releases (<2009.10) as well.</td>\r
-</tr></table>\r
</div>\r
</div>\r
+<div class="sect1">\r
<h2 id="options">4. Options</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>The ISO[s] should be the path to one or multiple grml-ISOs and/or the path to\r
<dd>\r
<p>\r
Use specified bootoptions as default. To use flavour name as a argument for a\r
-boot parameter use %flavour which will be expanded to the flavour name.\r
+boot parameter use %flavour which will be expanded to the flavour name. To add\r
+multiple bootoptions you can specify the option multiple time.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</dl></div>\r
<div class="dlist"><dl>\r
<dt class="hdlist1">\r
-<strong>--lilo-binary=…</strong>\r
-</dt>\r
-<dd>\r
-<p>\r
-Use specified lilo executable for installing master boot record (MBR) when using\r
-the <em>--syslinux-mbr</em> option. By default any system wide (from $PATH) lilo\r
-executable is taken. If there can not be find any lilo executable the\r
-statically compiled version of the grml2usb Debian package (see\r
-/usr/share/grml2usb/lilo/lilo.static.[amd64|i386]) is taken.\r
-</p>\r
-</dd>\r
-<dt class="hdlist1">\r
<strong>--mbr-menu</strong>\r
</dt>\r
<dd>\r
<dd>\r
<p>\r
Remove specified bootoption (could be a regex) from existing boot options. Use\r
-multiple entries for removing different bootoptions at once. (Note: this option\r
-is not support in grml2usb-compat.)\r
+multiple entries for removing different bootoptions at once.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
with the "active" flag set) instead of the default one. If you encounter any\r
problems with the default MBR you can try using the syslinux MBR instead. If\r
that works for you please <a href="#author">let us know</a> so we can adjust our default\r
-MBR accordingly. Note: When using the <em>--syslinux-mbr</em> option lilo is executed\r
-before the MBR is installed so the according partitions are set active.\r
+MBR accordingly.\r
</p>\r
</dd>\r
</dl></div>\r
</dd>\r
</dl></div>\r
</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="_developers_corner">5. Developers Corner</h2>\r
<div class="sectionbody">\r
-<h3 id="directory-layout">5.1. Directory layout on usb device</h3><div style="clear:left"></div>\r
+<div class="sect2">\r
+<h3 id="directory-layout">5.1. Directory layout on usb device</h3>\r
<div class="literalblock">\r
<div class="content">\r
<pre><tt>boot/ ->\r
| `-- grml-small.squashfs [squashfs file for grml-small]\r
`-- ...</tt></pre>\r
</div></div>\r
-<h3 id="source">5.2. Grabbing the source</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="source">5.2. Grabbing the source</h3>\r
<div class="literalblock">\r
<div class="content">\r
<pre><tt>% git clone git://git.grml.org/grml2usb.git</tt></pre>\r
</div></div>\r
-<h3 id="debugging">5.3. Developers Debugging Hints</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="debugging">5.3. Developers Debugging Hints</h3>\r
<div class="paragraph"><p>To play with grml2usb you can avoid using a real device via a loopback file\r
setup, like:</p></div>\r
<div class="literalblock">\r
<pre><tt># mkfs.vfat /dev/loop1\r
# grml2usb --bootloader-only /grml/isos/grml-small_2009.10.iso /dev/loop1</tt></pre>\r
</div></div>\r
-<h3 id="performance-tracing">5.4. Performance tracing</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="performance-tracing">5.4. Performance tracing</h3>\r
<div class="literalblock">\r
<div class="content">\r
<pre><tt># blktrace -d /dev/sdX -o - | blkparse -i -\r
# grml2usb grml_2009.10.iso /dev/sdX1</tt></pre>\r
</div></div>\r
</div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="troubleshooting">6. Troubleshooting and Pitfalls when booting</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>Here is a list of common error messages from BIOS/bootloader when trying to boot\r
</tr>\r
</table></div>\r
</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="faq">7. Frequently Asked Questions (FAQ)</h2>\r
<div class="sectionbody">\r
-<h3 id="download">7.1. Where can I get grml2usb?</h3><div style="clear:left"></div>\r
+<div class="sect2">\r
+<h3 id="download">7.1. Where can I get grml2usb?</h3>\r
<div class="paragraph"><p>grml2usb is available as Debian package via <a href="http://deb.grml.org/">the\r
grml-testing Debian repository</a>.</p></div>\r
<div class="paragraph"><p>If you do not want to (or can’t) use the grml2usb Debian package you can either\r
grml2usb.tgz.</td>\r
</tr></table>\r
</div>\r
-<h3 id="grml2hd-vs-grml2usb">7.2. What’s the difference between grml2hd and grml2usb?</h3><div style="clear:left"></div>\r
-<div class="paragraph"><p>grml2hd installs a running grml system to a harddisk. When rebooting the\r
-harddisk installation can be modified and changes will find their way to the\r
-harddisk immediately. grml2usb copies just the compressed chroot filesystem\r
-(being the squashfs file), some further informational files and a bootloader to\r
-your device. This way you don’t need as much space as with a harddisk\r
-installation (just a USB device with >=ISO size) and when rebooting the system\r
-your changes will be lost (unless you are using the persistency feature, see\r
-<a href="http://wiki.grml.org/doku.php?id=persistency">http://wiki.grml.org/doku.php?id=persistency</a>).\r
-Think of using a better CD version: booting is (usually) faster, you don’t need\r
-to burn a new CD when a new ISO version arrives (just install the new ISO using\r
-grml2usb) and you can carry additional files on a writable medium with yourself.</p></div>\r
-<h3 id="dd">7.3. Why can’t I just dd the ISO to a USB device?</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="dd">7.2. Why can’t I just dd the ISO to a USB device?</h3>\r
<div class="paragraph"><p>Well, you can. :) Starting with grml 2009.10 the ISOs are dd-able straight out-of-the-box.</p></div>\r
<div class="admonitionblock">\r
<table><tr>\r
flexible system like with grml2usb (no multi-ISO setup, no additional default\r
bootoptions,…) but it’s a nice way to get a working USB boot setup if you\r
don’t have grml2usb available.</p></div>\r
-<h3 id="grml2usb-vs-dd">7.4. What’s the difference between grml2usb and just using dd?</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="grml2usb-vs-dd">7.3. What’s the difference between grml2usb and just using dd?</h3>\r
<div class="paragraph"><p>grml2usb does not remove any data from your USB device and does not alter the\r
partition table at all. grml2usb provides multi-ISO support, support for adding\r
default bootoptions and selecting the bootloader (syslinux vs. grub) without\r
having to manually touch the ISO at all.</p></div>\r
-<h3 id="grml2iso">7.5. What’s grml2iso?</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="grml2iso">7.4. What’s grml2iso?</h3>\r
<div class="paragraph"><p>grml2iso is a script which uses grml2usb to generate a multiboot ISO out of\r
several grml ISOs. See <em>man grml2iso</em> for further details.</p></div>\r
-<h3 id="grml2usb-compat">7.6. grml2usb fails with "Fatal: file default.cfg could not be found."</h3><div style="clear:left"></div>\r
-<div class="paragraph"><p>If you are trying to install an older grml ISO (older than grml 2009.10) with a\r
-recent version of grml2usb then you might notice:</p></div>\r
-<div class="literalblock">\r
-<div class="content">\r
-<pre><tt>Fatal: file default.cfg could not be found.\r
-Note: this grml2usb version requires an ISO generated by grml-live >=0.9.24 ...\r
- ... either use grml releases >=2009.10 or switch to an older grml2usb version.\r
- Please visit http://grml.org/grml2usb/#grml2usb-compat for further information\r
-Fatal: a critical error happend during execution (not a grml ISO?), giving up</tt></pre>\r
-</div></div>\r
-<div class="paragraph"><p>Breaking the backward compatibility was necessary to avoid maintainability hell.\r
-If you want to install older grml ISOs please use the grml2usb-compat script\r
-which provides support for older releases.</p></div>\r
-<h3 id="menu-lst">7.7. Why is there a menu.lst and a grub.cfg inside /boot/grub/?</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="menu-lst">7.5. Why is there a menu.lst and a grub.cfg inside /boot/grub/?</h3>\r
<div class="paragraph"><p>grml2usb supports grub version 1 (grub1) as well as grub version 2 (grub2).\r
Whereas grub1 uses menu.lst the new version grub2 needs grub.cfg.\r
Providing both files allows grml2usb to install grub on the target device\r
no matter which grub version is available on the host where grml2usb is\r
executed on.</p></div>\r
-<h3 id="stage1">7.8. grub-install fails with 'The file ../boot/grub/stage1 not read correctly"?!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="stage1">7.6. grub-install fails with 'The file ../boot/grub/stage1 not read correctly"?!</h3>\r
<div class="paragraph"><p>Check whether the partition has the right partition type. For example do NOT use\r
FAT16 (partition type 6) when using a ext3 filesystem on the partition but\r
instead use the correct partition type (<em>83</em> - Linux) then.</p></div>\r
-<h3 id="grub-install-xfs_freeze">7.9. grub-install complains about /sbin/grub-install and/or xfs_freeze?!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="grub-install-xfs_freeze">7.7. grub-install complains about /sbin/grub-install and/or xfs_freeze?!</h3>\r
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
</div></div>\r
<div class="paragraph"><p>This is "normal". grub-install sends those messages to stderr. To avoid hiding any\r
possible real error messages grml2usb doesn’t ignore those messages.</p></div>\r
-<h3 id="device-map">7.10. grub-install complains about /boot/grub/device.map?!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="device-map">7.8. grub-install complains about /boot/grub/device.map?!</h3>\r
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
</div></div>\r
<div class="paragraph"><p>This is "normal" (at least with grub1). This isn’t a problem, because the\r
device.map file will be generated on the target device anyway.</p></div>\r
-<h3 id="unary-operator">7.11. grub-install complains about a unary operator?!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="unary-operator">7.9. grub-install complains about a unary operator?!</h3>\r
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
</div></div>\r
<div class="paragraph"><p>This is "normal". Just ignore it. (It usually doesn’t appear\r
on the second invocation on the same device.)</p></div>\r
-<h3 id="unknown-filesystem">7.12. grub-install fails with grub-probe: error: unknown filesystem?!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="unknown-filesystem">7.10. grub-install fails with grub-probe: error: unknown filesystem?!</h3>\r
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
using FAT32 as filesystem on the partition will not work. Either set filesystem\r
type to FAT32 or format the partition using FAT16. It is essential that\r
device partition table and filesystem use the same filesystem type.</p></div>\r
-<h3 id="mbr-vs-pbr">7.13. grub-setup fails after Attempting to install GRUB to a partition instead of the MBR?!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="mbr-vs-pbr">7.11. grub-setup fails after Attempting to install GRUB to a partition instead of the MBR?!</h3>\r
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
install grub into the MBR (Master Boot Record) using the <em>--grub-mbr</em> option of\r
grml2usb or 3) switch to syslinux as bootmanager (just drop the <em>--grub</em>\r
option).</p></div>\r
-<h3 id="splash-xpm">7.14. I’m getting something like "Error: /usr/share/grml2usb/grub/splash.xpm.gz can not be read"!?</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="splash-xpm">7.12. I’m getting something like "Error: /usr/share/grml2usb/grub/splash.xpm.gz can not be read"!?</h3>\r
<div class="paragraph"><p>Looks like you’ve only the grml2usb script itself available. Please make sure\r
you’ve the grml2usb Debian package installed. The most resent stable version is\r
available via <a href="http://deb.grml.org/">the grml-testing Debian repository</a>. If\r
you do not have a Debian system please see section <a href="#download">Where can I get grml2usb?</a> in this FAQ.</p></div>\r
-<h3 id="fat16">7.15. Why do I have to use a FAT16/FAT32 filesystem?</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="fat16">7.13. Why do I have to use a FAT16/FAT32 filesystem?</h3>\r
<div class="paragraph"><p>Syslinux (currently) does not support any other filesystems besides FAT16/FAT32\r
(though that’s a sane default if you want to share your files with other\r
(operating) systems). If you want to use a different filesystem (like ext2/3)\r
<td class="content">FAT32 is supported since syslinux version 3.0.</td>\r
</tr></table>\r
</div>\r
-<h3 id="cool-idea">7.16. I think I’ve got a really cool idea!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="hdt-hangs">7.14. Addons → Hardware Detection Tool freezes</h3>\r
+<div class="paragraph"><p>This usually means that the machine you ran grml2usb on had syslinux 3.x\r
+installed. The version of hdt (Hardware detection tool) shipping with Grml\r
+2010.12 and newer requires syslinux 4.x.</p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="cool-idea">7.15. I think I’ve got a really cool idea!</h3>\r
<div class="paragraph"><p>Great! Please check out\r
<a href="http://git.grml.org/?p=grml2usb.git;a=blob;f=TODO;hb=HEAD">the TODO file</a>.\r
Feel free to <a href="#author">report your wishes to the author</a>. Patches highly\r
appreciated.</p></div>\r
-<h3 id="booting-from-usb">7.17. I’ve problems with booting from USB.</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="booting-from-usb">7.16. I’ve problems with booting from USB.</h3>\r
<div class="paragraph"><p>Check out <a href="#troubleshooting">Troubleshooting and Pitfalls when booting</a>.</p></div>\r
-<h3 id="found-a-bug">7.18. I’ve found a bug!</h3><div style="clear:left"></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="found-a-bug">7.17. I’ve found a bug!</h3>\r
<div class="paragraph"><p>Please <a href="#author">report it to the author</a>. Please provide usage examples and output\r
of your grml2usb commandline (consider using the "--verbose" option).</p></div>\r
</div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="usage-examples">8. Usage examples</h2>\r
<div class="sectionbody">\r
<div class="literalblock">\r
/dev/sdX.</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml2usb-compat /home/grml/grml_2009.05.iso /dev/sdX1</tt></pre>\r
-</div></div>\r
-<div class="paragraph"><p>Install older grml ISO on device /dev/sdX1.</p></div>\r
-<div class="literalblock">\r
-<div class="content">\r
-<pre><tt># grml2usb --bootoptions="lang=de ssh=mysecret" grml_2009.10.iso /dev/sdX1</tt></pre>\r
+<pre><tt># grml2usb --bootoptions="lang=de ssh=mysecret" grml_2009.10.iso /dev/sdX1\r
+# grml2usb --bootoptions="lang=de" --bootoptions="ssh=mysecret" grml_2009.10.iso /dev/sdX1</tt></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
to every menu entry. %flavour_name will be expanded to the flavour of the specific\r
iso, e.g. grml64 and grml.</p></div>\r
</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="ressources">9. 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>\r
+</div>\r
+<div class="sect1">\r
<h2 id="bugs">10. Bugs</h2>\r
<div class="sectionbody">\r
<div class="paragraph"><p>Please report feedback, bugreports and wishes <a href="#author">to the author</a>.</p></div>\r
</div>\r
+</div>\r
+<div class="sect1">\r
<h2 id="author">11. Author</h2>\r
<div class="sectionbody">\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 2010-06-16 15:30:28 CEST\r
+Last updated 2011-11-26 20:30:03 CET\r
</div>\r
</div>\r
</body>\r
projects / grml.org.git / commitdiff