openadk/package/aboot/src/doc/man/isomarkboot.sgml

<!DOCTYPE RefEntry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry id="isomarkboot">

<refmeta>
<refentrytitle>isomarkboot</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo>isomarkboot</refmiscinfo>
</refmeta>

<refnamediv>
<refname>isomarkboot</refname>
<refpurpose>
Create bootable CD-ROMs for Linux/Alpha systems.
</refpurpose>
</refnamediv>

<refsynopsisdiv>
 <cmdsynopsis>
   <command>isomarkboot</command> 
        <arg choice="plain">/dev/xxx</arg>
        <arg choice="plain">path/to/bootlx</arg>
        <arg choice="opt">path/to/root.bin</arg>
   </cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>COPYRIGHT</title>
<para>
<application>isomarkboot</application> is Copyright (C) 1996 David Mosberger-Tang
</para>
</refsect1>

<refsect1><title>DESCRIPTIONS</title>
<para>
<indexterm><primary>isomarkboot</primary></indexterm>
<application>isomarkboot</application>
enables ISO images created with <application>mkisofs</application>(8) or
retrieved from the net
to be booted on Linux/Alpha systems.
</para>

<para>
First you have to prepare your ISO image and mount it loopback on
<filename>/dev/xxx</filename> (typically <filename>/dev/loop0</filename>)
(see <application>mount</application>(8) for details). 
</para>

<para>
Next you need to locate the aboot-loader (called <filename>bootlx</filename>)
and the RAM-disk image containing the root file system (the latter is optional
but usually sensible to specify) which is often called 
<filename>root.bin</filename> within your ISO image.
</para>
<para>
Finally enable the image to be booted:
</para>
<para>
<command>
isomarkboot <parameter>/dev/xxx path/to/bootlx path/to/root.bin</parameter>
</command>
</para>
<para>
A typical location of <filename>bootlx</filename> on the disk image is
<filename>boot/bootlx</filename>. The paths of <filename>bootlx</filename>
and <filename>root.bin</filename> are relative to the root of the image. If
your image is not mounted you have to replace <filename>/dev/xxx</filename>
with the path to the image.
</para>

<para>
Finally you have to burn the CD using e.g.
<application>xcdroast</application> after unmounting the image.
</para>

</refsect1>
<refsect1><title>BUGS</title>
<para>
<application>isomarkboot</application> is not heavily tested on
architectures other than Linux/Alpha, though it compiles (with
slight patches). Please report bugs if you experience them.
</para>
</refsect1>
<refsect1><title>NOTES</title>
<para>
<application>isomarkboot</application> is capable of handling symlinks
within the image.
</para>
</refsect1>
<refsect1><title>AUTHOR</title>
<para>
This man page was written by Helge Kreutzmann <email>debian@helgefjell.de</email> for the Debian GNU/Linux project but may be used by others.
</para>
</refsect1>
<refsect1><title>SEE ALSO</title>
<para><application>aboot</application>(8), <application>mkisofs</application>(8)
</para>
</refsect1>
</refentry>