<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.7" />\r
+<meta name="generator" content="AsciiDoc 8.6.9" />\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
*\r
* */\r
\r
-tt {\r
- font-family: "Courier New", Courier, 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
* */\r
\r
-.monospaced {\r
- font-family: "Courier New", Courier, 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
/*<![CDATA[*/\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.iso grml_2009.05.iso grml64_2009.05.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="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.iso /srv/grml/grml_2009.10.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="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.iso /srv/grml-small_2009.10.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><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 grml2iso -o /srv/grml.iso /srv/grml/grml_2009.05.iso /srv/grml/grml64-medium_2009.05.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="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.iso grml_2009.05.iso grml64_2009.05.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="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.iso /srv/grml-small_2009.10.iso /srv/grml64-small_2009.10.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
<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.7" />\r
+<meta name="generator" content="AsciiDoc 8.6.9" />\r
<title>grml2usb(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
*\r
* */\r
\r
-tt {\r
- font-family: "Courier New", Courier, 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
* */\r
\r
-.monospaced {\r
- font-family: "Courier New", Courier, 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
/*<![CDATA[*/\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
+<pre><code>boot/ ->\r
|-- addons/\r
| |-- allinone.img [grub - all in one image]\r
| |-- bsd4grml/ [MirBSD]\r
`-- syslinux/\r
|-- grml.png [graphical bootsplash background image for syslinux]\r
|-- syslinux.cfg [main configuration file for syslinux]\r
- `-- [....] [several further config files for syslinux]</tt></pre>\r
+ `-- [....] [several further config files for syslinux]</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grml/\r
+<pre><code>grml/\r
|-- grml2usb.txt [not yet implemented]\r
|-- grml-cheatcodes.txt [list of bootoptions for grml]\r
|-- grml-version.txt [file containing information about grml-version]\r
|-- button.png\r
|-- favicon.png\r
|-- linux.jpg\r
- `-- logo.png</tt></pre>\r
+ `-- logo.png</code></pre>\r
</div></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>live/\r
+<pre><code>live/\r
|-- grml/\r
| |-- filesystem.module [module specifying which squashfs should be used for grml]\r
| `-- grml.squashfs [squashfs file for grml]\r
|-- grml-small/\r
| |-- filesystem.module [module specifying which squashfs should be used for grml-medium]\r
| `-- grml-small.squashfs [squashfs file for grml-small]\r
- `-- ...</tt></pre>\r
+ `-- ...</code></pre>\r
</div></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
+<pre><code>% git clone git://git.grml.org/grml2usb.git</code></pre>\r
</div></div>\r
</div>\r
<div class="sect2">\r
setup, like:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># dd if=/dev/zero of=~/loopback bs=1M count=100 # adjust size to your needs\r
-# losetup /dev/loop1 ~/loopback</tt></pre>\r
+<pre><code># dd if=/dev/zero of=~/loopback bs=1M count=100 # adjust size to your needs\r
+# losetup /dev/loop1 ~/loopback</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Then create according partitions either running for example:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># echo -en "n\np\n1\n\n\nt\n6\na\n1\n w\n" | fdisk /dev/loop1</tt></pre>\r
+<pre><code># echo -en "n\np\n1\n\n\nt\n6\na\n1\n w\n" | fdisk /dev/loop1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>or:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># parted /dev/loop1 -s "mkpart primary fat16 0 -1s mkfs 1 fat16"</tt></pre>\r
+<pre><code># parted /dev/loop1 -s "mkpart primary fat16 0 -1s mkfs 1 fat16"</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Finally create a filesystem and execute grml2usb as needed:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># mkfs.vfat /dev/loop1\r
-# grml2usb --bootloader-only /grml/isos/grml-small_2013.01.iso /dev/loop1</tt></pre>\r
+<pre><code># mkfs.vfat /dev/loop1\r
+# grml2usb --bootloader-only /grml/isos/grml-small_2013.01.iso /dev/loop1</code></pre>\r
</div></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_2013.01.iso /dev/sdX1</tt></pre>\r
+<pre><code># blktrace -d /dev/sdX -o - | blkparse -i -\r
+# grml2usb grml_2013.01.iso /dev/sdX1</code></pre>\r
</div></div>\r
</div>\r
</div>\r
use the grml2usb git tree running:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>git clone git://git.grml.org/grml2usb.git\r
+<pre><code>git clone git://git.grml.org/grml2usb.git\r
cd grml2usb\r
make -C mbr\r
-sudo ./grml2usb ...</tt></pre>\r
+sudo ./grml2usb ...</code></pre>\r
</div></div>\r
<div class="paragraph"><p>or download the provided\r
<a href="http://grml.org/grml2usb/grml2usb.tgz">http://grml.org/grml2usb/grml2usb.tgz</a>\r
system available) running:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>% dd if=grml_2013.01.iso of=/dev/sdX</tt></pre>\r
+<pre><code>% dd if=grml_2013.01.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="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>You shouldn't call /sbin/grub-install. Please call /usr/sbin/grub-install instead!\r
-xfs_freeze: specified file ["/tmp/tmpqaBK6z/boot/grub"] is not on an XFS filesystem</tt></pre>\r
+<pre><code>You shouldn't call /sbin/grub-install. Please call /usr/sbin/grub-install instead!\r
+xfs_freeze: specified file ["/tmp/tmpqaBK6z/boot/grub"] is not on an XFS filesystem</code></pre>\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
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grub-probe: error: Cannot open `/boot/grub/device.map'</tt></pre>\r
+<pre><code>grub-probe: error: Cannot open `/boot/grub/device.map'</code></pre>\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
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>'/usr/sbin/grub-install: line 374: [: =: unary operator expected'</tt></pre>\r
+<pre><code>'/usr/sbin/grub-install: line 374: [: =: unary operator expected'</code></pre>\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
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grub-probe: error: unknown filesystem\r
+<pre><code>grub-probe: error: unknown filesystem\r
Auto-detection of a filesystem module failed.\r
-Please specify the module with the option `--modules' explicitly.</tt></pre>\r
+Please specify the module with the option `--modules' explicitly.</code></pre>\r
</div></div>\r
<div class="paragraph"><p>usually means that the device partition table says something else than the\r
filesystem on the device. For example using FAT16 as filesystem type and\r
<div class="paragraph"><p>The following message:</p></div>\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt>grub-setup: warn: Attempting to install GRUB to a partition instead of the MBR. This is a BAD idea.\r
+<pre><code>grub-setup: warn: Attempting to install GRUB to a partition instead of the MBR. This is a BAD idea.\r
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.\r
-grub-setup: error: Cannot read `/grub/core.img' correctly</tt></pre>\r
+grub-setup: error: Cannot read `/grub/core.img' correctly</code></pre>\r
</div></div>\r
<div class="paragraph"><p>appears when using grub2 versions older than 1.98 as those version introduced a\r
regression which avoids that grub is being installed into a partition (PBR,\r
<div class="sectionbody">\r
<div class="literalblock">\r
<div class="content">\r
-<pre><tt># grml2usb /home/grml/grml_2013.01.iso /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb /home/grml/grml_2013.01.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><tt># grml2usb /home/grml/grml_2013.01.iso /home/grml/grml_small_2013.01.iso /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb /home/grml/grml_2013.01.iso /home/grml/grml_small_2013.01.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><tt># grml2usb /lib/live/mount/medium /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb /lib/live/mount/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><tt># grml2usb /lib/live/mount/medium /home/grml/grml_2013.01.iso /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb /lib/live/mount/medium /home/grml/grml_2013.01.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><tt># grml2usb --fat16 /home/grml/grml_2013.01.iso /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb --fat16 /home/grml/grml_2013.01.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><tt># grml2usb --grub --grub-mbr /home/grml/grml_2013.01.iso /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb --grub --grub-mbr /home/grml/grml_2013.01.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><tt># 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</tt></pre>\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
</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><tt># grml2usb --remove-bootoption="vga=791" --remove-bootoption="nomce" grml_2013.01.iso /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb --remove-bootoption="vga=791" --remove-bootoption="nomce" grml_2013.01.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><tt># grml2usb --bootoptions="persistent-path=%flavour_name" grml64_2010.04.iso grml_2010.04.iso /dev/sdX1</tt></pre>\r
+<pre><code># grml2usb --bootoptions="persistent-path=%flavour_name" grml64_2010.04.iso grml_2010.04.iso /dev/sdX1</code></pre>\r
</div></div>\r
<div class="paragraph"><p>Install specified Isos on device /dev/sdx and add parameter persisten-path\r
to every menu entry. %flavour_name will be expanded to the flavour of the specific\r
projects / grml.org.git / commitdiff