X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=grml2usb%2Findex.html;h=40b72ca497aef80768111d2ff2d18940bc919d0b;hb=e215725a6170731a9508f92e654794a1892b8fba;hp=a14f69bbf6f8d3684e47e62ed054395232fa7691;hpb=4889a146240f5fb67fed024b80ba935789805cab;p=grml.org.git

diff --git a/grml2usb/index.html b/grml2usb/index.html
index a14f69b..40b72ca 100644
--- a/grml2usb/index.html
+++ b/grml2usb/index.html
@@ -3,7 +3,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.6.6" />
+<meta name="generator" content="AsciiDoc 8.6.9" />
 <title>grml2usb(8)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -87,10 +87,16 @@ ul, ol, li > p {
 ul > li     { color: #aaa; }
 ul > li > * { color: black; }
 
-pre {
+.monospaced, code, pre {
+  font-family: "Courier New", Courier, monospace;
+  font-size: inherit;
+  color: navy;
   padding: 0;
   margin: 0;
 }
+pre {
+  white-space: pre-wrap;
+}
 
 #author {
   color: #527bbd;
@@ -219,7 +225,7 @@ div.exampleblock > div.content {
 }
 
 div.imageblock div.content { padding-left: 0; }
-span.image img { border-style: none; }
+span.image img { border-style: none; vertical-align: text-bottom; }
 a.image:visited { color: white; }
 
 dl {
@@ -349,7 +355,7 @@ div.colist td img {
   margin-bottom: 0.1em;
 }
 
-div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
   margin-top: 0;
   margin-bottom: 0;
 }
@@ -407,18 +413,14 @@ span.underline { text-decoration: underline; }
 span.overline { text-decoration: overline; }
 span.line-through { text-decoration: line-through; }
 
+div.unbreakable { page-break-inside: avoid; }
+
 
 /*
  * xhtml11 specific
  *
  * */
 
-tt {
-  font-family: monospace;
-  font-size: inherit;
-  color: navy;
-}
-
 div.tableblock {
   margin-top: 1.0em;
   margin-bottom: 1.5em;
@@ -452,12 +454,6 @@ div.tableblock > table[frame="vsides"] {
  *
  * */
 
-.monospaced {
-  font-family: monospace;
-  font-size: inherit;
-  color: navy;
-}
-
 table.tableblock {
   margin-top: 1.0em;
   margin-bottom: 1.5em;
@@ -537,6 +533,8 @@ body.manpage div.sectionbody {
 @media print {
   body.manpage div#toc { display: none; }
 }
+
+
 </style>
 <script type="text/javascript">
 /*<![CDATA[*/
@@ -581,7 +579,7 @@ toc: function (toclevels) {
 
   function tocEntries(el, toclevels) {
     var result = new Array;
-    var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
+    var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
     // Function that scans the DOM tree for header elements (the DOM2
     // nodeIterator API would be a better technique but not supported by all
     // browsers).
@@ -610,7 +608,7 @@ toc: function (toclevels) {
   var i;
   for (i = 0; i < toc.childNodes.length; i++) {
     var entry = toc.childNodes[i];
-    if (entry.nodeName == 'div'
+    if (entry.nodeName.toLowerCase() == 'div'
      && entry.getAttribute("class")
      && entry.getAttribute("class").match(/^toclevel/))
       tocEntriesToRemove.push(entry);
@@ -656,7 +654,7 @@ footnotes: function () {
   var entriesToRemove = [];
   for (i = 0; i < noteholder.childNodes.length; i++) {
     var entry = noteholder.childNodes[i];
-    if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote")
+    if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
       entriesToRemove.push(entry);
   }
   for (i = 0; i < entriesToRemove.length; i++) {
@@ -745,7 +743,7 @@ asciidoc.install(2);
 <div class="sect1">
 <h2 id="_name">1. Name</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>grml2usb - install grml ISO(s) on usb device for booting</p></div>
+<div class="paragraph"><p>grml2usb - install Grml ISO(s) on usb device for booting</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -754,19 +752,20 @@ asciidoc.install(2);
 <div class="paragraph"><p>grml2usb [ options ] &lt;ISO[s]&gt; &lt;device&gt;</p></div>
 <div class="sidebarblock">
 <div class="content">
-<div class="paragraph"><p>Important! The grml team does not take responsibility for loss of any data!</p></div>
+<div class="paragraph"><p>Important! The Grml team does not take responsibility for loss of any data!</p></div>
 </div></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="introduction">3. Introduction</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>grml2usb installs grml on a given partition of your usb device and makes it
-bootable. It provides multi-iso support, meaning you can specify several grml
-ISOs on the command line at once and select the grml flavour you would like to
-boot on the bootprompt then. Note that the <strong>first</strong> ISO specified on the grml2usb
-command line will become the default one (that&#8217;s the one that will boot when
-just pressing enter on the bootprompt or wait until the boot timeout matches).</p></div>
+<div class="paragraph"><p>grml2usb installs Grml on a given partition of your usb device and makes
+it bootable. It provides multiboot ISO support, meaning you can specify
+several Grml ISOs on the command line at once and select the Grml
+flavour you would like to boot on the bootprompt then. Note that the
+<strong>first</strong> ISO specified on the grml2usb command line will become the
+default one (that&#8217;s the one that will boot when just pressing enter on
+the bootprompt or wait until the boot timeout matches).</p></div>
 <div class="admonitionblock">
 <table><tr>
 <td class="icon">
@@ -784,8 +783,8 @@ default MBR consider using <em>--syslinux-mbr</em> instead.</td>
 <div class="sect1">
 <h2 id="options">4. Options</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>The ISO[s] should be the path to one or multiple grml-ISOs and/or the path to
-the currently running live-system (being /live/image).</p></div>
+<div class="paragraph"><p>ISO[s] should be the path to one or multiple grml-ISOs and/or the path to
+the currently running live-system (being /lib/live/mount/medium).</p></div>
 <div class="paragraph"><p>The device either might be a device name like /dev/sdX1 or a directory. When
 specifying a device name the device is mounted automatically. When specifying a
 directory grml2usb is assuming that you did set up a bootloader on your own (or
@@ -827,7 +826,7 @@ Copy files only but do <strong>not</strong> install a bootloader.
 <p>
 Avoid executing commands, instead show what would be executed.
 Warning: please notice that the ISO has to be mounted anyway, otherwise
-identifying the grml flavour would not be possible.
+identifying the Grml flavour would not be possible.
 </p>
 </dd>
 <dt class="hdlist1">
@@ -914,6 +913,14 @@ multiple entries for removing different bootoptions at once.
 </p>
 </dd>
 <dt class="hdlist1">
+<strong>--skip-bootflag</strong>
+</dt>
+<dd>
+<p>
+Do not check for presence of bootflag on target device.
+</p>
+</dd>
+<dt class="hdlist1">
 <strong>--skip-grub-config</strong>
 </dt>
 <dd>
@@ -942,6 +949,16 @@ file no matter whether you&#8217;re using grub or syslinux as bootloader.
 </p>
 </dd>
 <dt class="hdlist1">
+<strong>--skip-usb-check</strong>
+</dt>
+<dd>
+<p>
+Skip check to verify whether given device is a removable device.
+Some USB devices are known to report wrong information, when using
+such a device you can skip grml2usb&#8217;s removable device check.
+</p>
+</dd>
+<dt class="hdlist1">
 <strong>--syslinux</strong>
 </dt>
 <dd>
@@ -992,7 +1009,7 @@ Enable verbose mode.
 <h3 id="directory-layout">5.1. Directory layout on usb device</h3>
 <div class="literalblock">
 <div class="content">
-<pre><tt>boot/ -&gt;
+<pre><code>boot/ -&gt;
   |-- addons/
   |   |-- allinone.img     [grub - all in one image]
   |   |-- bsd4grml/        [MirBSD]
@@ -1026,13 +1043,13 @@ Enable verbose mode.
   `-- syslinux/
       |-- grml.png         [graphical bootsplash background image for syslinux]
       |-- syslinux.cfg     [main configuration file for syslinux]
-      `-- [....]           [several further config files for syslinux]</tt></pre>
+      `-- [....]           [several further config files for syslinux]</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>grml/
+<pre><code>grml/
   |-- grml2usb.txt         [not yet implemented]
-  |-- grml-cheatcodes.txt  [list of bootoptions for grml]
+  |-- grml-cheatcodes.txt  [list of bootoptions for Grml]
   |-- grml-version.txt     [file containing information about grml-version]
   |-- LICENSE.txt          [license information]
   |-- md5sums              [md5sums of original ISO]
@@ -1044,11 +1061,11 @@ Enable verbose mode.
           |-- button.png
           |-- favicon.png
           |-- linux.jpg
-          `-- logo.png</tt></pre>
+          `-- logo.png</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>live/
+<pre><code>live/
   |-- grml/
   |   |-- filesystem.module    [module specifying which squashfs should be used for grml]
   |   `-- grml.squashfs        [squashfs file for grml]
@@ -1058,14 +1075,14 @@ Enable verbose mode.
   |-- grml-small/
   |   |-- filesystem.module    [module specifying which squashfs should be used for grml-medium]
   |   `-- grml-small.squashfs  [squashfs file for grml-small]
-  `-- ...</tt></pre>
+  `-- ...</code></pre>
 </div></div>
 </div>
 <div class="sect2">
 <h3 id="source">5.2. Grabbing the source</h3>
 <div class="literalblock">
 <div class="content">
-<pre><tt>% git clone git://git.grml.org/grml2usb.git</tt></pre>
+<pre><code>% git clone git://git.grml.org/grml2usb.git</code></pre>
 </div></div>
 </div>
 <div class="sect2">
@@ -1074,32 +1091,32 @@ Enable verbose mode.
 setup, like:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># dd if=/dev/zero of=~/loopback bs=1M count=100 # adjust size to your needs
-# losetup /dev/loop1 ~/loopback</tt></pre>
+<pre><code># dd if=/dev/zero of=~/loopback bs=1M count=100 # adjust size to your needs
+# losetup /dev/loop1 ~/loopback</code></pre>
 </div></div>
 <div class="paragraph"><p>Then create according partitions either running for example:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># echo -en "n\np\n1\n\n\nt\n6\na\n1\n w\n" | fdisk /dev/loop1</tt></pre>
+<pre><code># echo -en "n\np\n1\n\n\nt\n6\na\n1\n w\n" | fdisk /dev/loop1</code></pre>
 </div></div>
 <div class="paragraph"><p>or:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># parted /dev/loop1 -s "mkpart primary fat16 0 -1s mkfs 1 fat16"</tt></pre>
+<pre><code># parted /dev/loop1 -s "mkpart primary fat16 0 -1s mkfs 1 fat16"</code></pre>
 </div></div>
 <div class="paragraph"><p>Finally create a filesystem and execute grml2usb as needed:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># mkfs.vfat /dev/loop1
-# grml2usb --bootloader-only /grml/isos/grml-small_2009.10.iso /dev/loop1</tt></pre>
+<pre><code># mkfs.vfat /dev/loop1
+# grml2usb --bootloader-only /grml/isos/grml-small_2013.01.iso /dev/loop1</code></pre>
 </div></div>
 </div>
 <div class="sect2">
 <h3 id="performance-tracing">5.4. Performance tracing</h3>
 <div class="literalblock">
 <div class="content">
-<pre><tt># blktrace -d /dev/sdX -o - | blkparse -i -
-# grml2usb grml_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># blktrace -d /dev/sdX -o - | blkparse -i -
+# grml2usb grml_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
 </div>
 </div>
@@ -1274,10 +1291,10 @@ grml-testing Debian repository</a>.</p></div>
 use the grml2usb git tree running:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>git clone git://git.grml.org/grml2usb.git
+<pre><code>git clone git://git.grml.org/grml2usb.git
 cd grml2usb
 make -C mbr
-sudo ./grml2usb ...</tt></pre>
+sudo ./grml2usb ...</code></pre>
 </div></div>
 <div class="paragraph"><p>or download the provided
 <a href="http://grml.org/grml2usb/grml2usb.tgz">http://grml.org/grml2usb/grml2usb.tgz</a>
@@ -1296,7 +1313,7 @@ grml2usb.tgz.</td>
 </div>
 <div class="sect2">
 <h3 id="dd">7.2. Why can&#8217;t I just dd the ISO to a USB device?</h3>
-<div class="paragraph"><p>Well, you can. :) Starting with grml 2009.10 the ISOs are dd-able straight out-of-the-box.</p></div>
+<div class="paragraph"><p>Well, you can. :) Starting with Grml 2009.10 the ISOs are dd-able straight out-of-the-box.</p></div>
 <div class="admonitionblock">
 <table><tr>
 <td class="icon">
@@ -1311,7 +1328,7 @@ using the dd approach.</td>
 system available) running:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>% dd if=grml_2009.10.iso of=/dev/sdX</tt></pre>
+<pre><code>% dd if=grml_2013.01.iso of=/dev/sdX</code></pre>
 </div></div>
 <div class="paragraph"><p>where /dev/sdX is your USB device. Of course this doesn&#8217;t provide such a
 flexible system like with grml2usb (no multi-ISO setup, no additional default
@@ -1349,8 +1366,8 @@ instead use the correct partition type (<em>83</em> - Linux) then.</p></div>
 <div class="paragraph"><p>The following message:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>You shouldn't call /sbin/grub-install. Please call /usr/sbin/grub-install instead!
-xfs_freeze: specified file ["/tmp/tmpqaBK6z/boot/grub"] is not on an XFS filesystem</tt></pre>
+<pre><code>You shouldn't call /sbin/grub-install. Please call /usr/sbin/grub-install instead!
+xfs_freeze: specified file ["/tmp/tmpqaBK6z/boot/grub"] is not on an XFS filesystem</code></pre>
 </div></div>
 <div class="paragraph"><p>This is "normal". grub-install sends those messages to stderr. To avoid hiding any
 possible real error messages grml2usb doesn&#8217;t ignore those messages.</p></div>
@@ -1360,7 +1377,7 @@ possible real error messages grml2usb doesn&#8217;t ignore those messages.</p></
 <div class="paragraph"><p>The following message:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>grub-probe: error: Cannot open `/boot/grub/device.map'</tt></pre>
+<pre><code>grub-probe: error: Cannot open `/boot/grub/device.map'</code></pre>
 </div></div>
 <div class="paragraph"><p>This is "normal" (at least with grub1). This isn&#8217;t a problem, because the
 device.map file will be generated on the target device anyway.</p></div>
@@ -1370,7 +1387,7 @@ device.map file will be generated on the target device anyway.</p></div>
 <div class="paragraph"><p>The following message:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>'/usr/sbin/grub-install: line 374: [: =: unary operator expected'</tt></pre>
+<pre><code>'/usr/sbin/grub-install: line 374: [: =: unary operator expected'</code></pre>
 </div></div>
 <div class="paragraph"><p>This is "normal". Just ignore it. (It usually doesn&#8217;t appear
 on the second invocation on the same device.)</p></div>
@@ -1380,9 +1397,9 @@ on the second invocation on the same device.)</p></div>
 <div class="paragraph"><p>The following message:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>grub-probe: error: unknown filesystem
+<pre><code>grub-probe: error: unknown filesystem
 Auto-detection of a filesystem module failed.
-Please specify the module with the option `--modules' explicitly.</tt></pre>
+Please specify the module with the option `--modules' explicitly.</code></pre>
 </div></div>
 <div class="paragraph"><p>usually means that the device partition table says something else than the
 filesystem on the device. For example using FAT16 as filesystem type and
@@ -1395,9 +1412,9 @@ device partition table and filesystem use the same filesystem type.</p></div>
 <div class="paragraph"><p>The following message:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>grub-setup: warn: Attempting to install GRUB to a partition instead of the MBR.  This is a BAD idea.
+<pre><code>grub-setup: warn: Attempting to install GRUB to a partition instead of the MBR.  This is a BAD idea.
 grub-setup: warn: Embedding is not possible.  GRUB can only be installed in this setup by using blocklists.  However, blocklists are UNRELIABLE and its use is discouraged.
-grub-setup: error: Cannot read `/grub/core.img' correctly</tt></pre>
+grub-setup: error: Cannot read `/grub/core.img' correctly</code></pre>
 </div></div>
 <div class="paragraph"><p>appears when using grub2 versions older than 1.98 as those version introduced a
 regression which avoids that grub is being installed into a partition (PBR,
@@ -1458,55 +1475,55 @@ of your grml2usb commandline (consider using the "--verbose" option).</p></div>
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb /home/grml/grml_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
 <div class="paragraph"><p>Install specified ISO on device /dev/sdX1.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb /home/grml/grml_2009.10.iso /home/grml/grml_small_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb /home/grml/grml_2013.01.iso /home/grml/grml_small_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
 <div class="paragraph"><p>Install specified ISOs on device /dev/sdX1 for multibooting ISOs.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb /live/image /dev/sdX1</tt></pre>
+<pre><code># grml2usb /lib/live/mount/medium /dev/sdX1</code></pre>
 </div></div>
-<div class="paragraph"><p>Install currently running grml live system on device /dev/sdX1.</p></div>
+<div class="paragraph"><p>Install currently running Grml live system on device /dev/sdX1.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb /live/image /home/grml/grml_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb /lib/live/mount/medium /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
-<div class="paragraph"><p>Install currently running grml live system and the specified
+<div class="paragraph"><p>Install currently running Grml live system and the specified
 ISO on device /dev/sdX1 for multibooting.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb --fat16 /home/grml/grml_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb --fat16 /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
 <div class="paragraph"><p>Install specified ISO on device /dev/sdX1 and format partition /dev/sdX1 with
 FAT16 filesystem.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb --grub --grub-mbr /home/grml/grml_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb --grub --grub-mbr /home/grml/grml_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
 <div class="paragraph"><p>Install specified ISO on device /dev/sdX1 and use grub as bootloader (instead of
 syslinux being the default) and install a master boot record (MBR) to the MBR of
 /dev/sdX.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb --bootoptions="lang=de ssh=mysecret" grml_2009.10.iso /dev/sdX1
-# grml2usb --bootoptions="lang=de" --bootoptions="ssh=mysecret" grml_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb --bootoptions="lang=de ssh=mysecret" grml_2013.01.iso /dev/sdX1
+# grml2usb --bootoptions="lang=de" --bootoptions="ssh=mysecret" grml_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
 <div class="paragraph"><p>Install specified ISO on device /dev/sdX1 and use "lang=de ssh=mysecret" as
 default bootoptions.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb --remove-bootoption="vga=791" --remove-bootoption="nomce" grml_2009.10.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb --remove-bootoption="vga=791" --remove-bootoption="nomce" grml_2013.01.iso /dev/sdX1</code></pre>
 </div></div>
 <div class="paragraph"><p>Install specified ISO on device /dev/sdX1 remove vga=791 and nomce from existing bootoptions.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt># grml2usb --bootoptions="persistent-path=%flavour_name" grml64_2010.04.iso grml_2010.04.iso /dev/sdX1</tt></pre>
+<pre><code># grml2usb --bootoptions="persistent-path=%flavour_name" grml64_2010.04.iso grml_2010.04.iso /dev/sdX1</code></pre>
 </div></div>
-<div class="paragraph"><p>Install specified Isos on device /dev/sdx and add parameter persisten-path
+<div class="paragraph"><p>Install specified ISOs on device /dev/sdx and add parameter persistent-path
 to every menu entry. %flavour_name will be expanded to the flavour of the specific
 iso, e.g. grml64 and grml.</p></div>
 </div>
@@ -1534,7 +1551,8 @@ iso, e.g. grml64 and grml.</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2011-12-25 18:20:03 CET
+Last updated
+ 2015-03-05 01:31:15 CET
 </div>
 </div>
 </body>
