EMILE/docs/emile-mkisofs.sgml

261 lines
7.7 KiB
Plaintext

<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
<!-- Process this file with docbook-to-man to generate an nroff manual
page: `docbook-to-man manpage.sgml > manpage.1'. You may view
the manual page with: `docbook-to-man manpage.sgml | nroff -man |
less'. A typical entry in a Makefile or Makefile.am is:
manpage.1: manpage.sgml
docbook-to-man $< > $@
-->
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "<firstname>Laurent</firstname>">
<!ENTITY dhsurname "<surname>Vivier</surname>">
<!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>March 23, 2007</date>">
<!ENTITY dhsection "<manvolnum>8</manvolnum>">
<!ENTITY dhemail "<email>Laurent@Vivier.EU</email>">
<!ENTITY dhusername "Laurent Vivier">
<!ENTITY dhucpackage "<refentrytitle>emile-mkisofs</refentrytitle>">
<!ENTITY dhpackage "emile">
<!ENTITY dhprogram "emile-mkisofs">
<!ENTITY debian "<productname>Debian GNU/Linux</productname>">
<!ENTITY gnu "<acronym>GNU</acronym>">
]>
<refentry>
<refentryinfo>
<address>
&dhemail;
</address>
<author>
&dhfirstname;
&dhsurname;
</author>
<copyright>
<year>2007</year>
<holder>&dhusername;</holder>
</copyright>
&dhdate;
</refentryinfo>
<refmeta>
&dhucpackage;
&dhsection;
</refmeta>
<refnamediv>
<refname>&dhprogram;</refname>
<refpurpose>install the <command>&dhpackage;</command>
bootloader on a CD-ROM
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhprogram;</command>
<arg><replaceable>options</replaceable></arg> <arg>filename</arg> <arg>pathspec</arg> <arg>...</arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para><command>&dhprogram;</command> creates an
<command>&dhpackage;</command> bootable CD-ROM image into file <option>filename</option>.
ISO9660 filesystem will be poppulated with files given
by <option>pathspec</option> (see mkisofs(1)).
</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term><option>-h</option>
<option>--help</option></term>
<listitem>
<para>Show summary of options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-v</option>
<option>--verbose</option></term>
<listitem>
<para>Activate verbose mode.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-f</option>
<option>--first PATH</option></term>
<listitem>
<para>EMILE first level to copy to CD-ROM.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-s</option>
<option>--second PATH</option></term>
<listitem>
<para>EMILE second level to copy to CD-ROM.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-k</option>
<option>--kernel PATH</option></term>
<listitem>
<para>Set path of kernel on the CD-ROM.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-r</option>
<option>--ramdisk PATH</option></term>
<listitem>
<para>Set path of ramdisk on the CD-ROM.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-a</option>
<option>--append ARG</option></term>
<listitem>
<para>Set kernel command line.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-d</option>
<option>--appledriver FILE</option></term>
<listitem>
<para>Apple Driver to copy to CD-ROM.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-e</option>
<option>--emiledriver FILE</option></term>
<listitem>
<para>Use the Apple Driver provided by EMILE to copy to CD-ROM.
EMILE Apple Driver doesn't contain any copyrighted
Apple Material.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-c</option>
<option>--config PATH</option></term>
<listitem>
<para>Specify the path to the configuration file.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>EXAMPLES</title>
<para>A bootable CD-ROM with an Apple Driver</para>
<para>
<command>&dhprogram;</command> -k "/install/kernels/vmlinuz-2.2.25-mac"
-r "/install/cdrom/initrd22.gz" -d Apple_Driver43
-a "root =/dev/ramdisk ramdisk_size=13000" boot.img /mnt/cdrom
</para>
<para>This command generates a bootable CD-ROM image in boot.img.
The pathes of the kernel, ramdisk in the CD-ROM filesystem are repectively "/install/kernels/vmlinuz-2.2.25-mac" and "/install/cdrom/initrd22.gz".
The Apple Driver is provided by the file Apple_Driver43.
The kernel command line is "root =/dev/ramdisk ramdisk_size=13000".
The ISO9660 filesystem of the CD-ROM poppulated with the files
found in /mnt/cdrom. This filesystem must provide "/install/kernels/vmlinuz-2.2.25-mac" and "/install/cdrom/initrd22.gz". See emile-map-set(8) to
know how to extract Apple_Driver43.
</para>
<para>A bootable CD-ROM with an EMILE Apple Driver and a configuration
file</para>
<para>before all write the configuration file, cdrom.conf:</para>
<programlisting>
timeout 5
default 0
vga default
title Sarge Install
kernel /install/kernels/vmlinuz-2.2.25-mac
args root=/dev/ramdisk ramdisk_size=13000
initrd /install/cdrom/initrd22.gz
title Sarge Install (Expert Mode)
kernel /install/kernels/vmlinuz-2.2.25-mac
args priority=low root=/dev/ramdisk ramdisk_size=13000
initrd /install/cdrom/initrd22.gz
title Rescue Mode
kernel /install/kernels/vmlinuz-2.2.25-mac
args root=/dev/ramdisk ramdisk_size=13000 rescue/enable=true
initrd /install/cdrom/initrd22.gz
</programlisting>
<para> and copy it into the CD-ROM filesystem, for instance
Debian_3.1_r0a_m68k_Bin-1/install/cdrom.conf</para>
<para>then, you can generate your CD-ROM image:</para>
<para>
<command>&dhprogram;</command> -c /install/cdrom.conf \
Debian_3.1_r0a_m68k_Bin-1.iso Debian_3.1_r0a_m68k_Bin-1
</para>
</refsect1>
<refsect1>
<title>FILES</title>
<para>/boot/emile/first_scsi</para>
<para>/boot/emile/m68k-second_scsi</para>
</refsect1>
<refsect1>
<title>REPORTING BUGS</title>
<para>Report bugs to Laurent Vivier &lt;Laurent@Vivier.EU&gt;</para>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>emile-install(8), emile-set-cmdline(8), emile-first-tune(8),
emile-map-set(8), emile-set-output(8), emile-mkisofs(8).</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>This manual page was written by &dhusername; <&dhemail;> for
the &debian; system (but may be used by others). Permission is
granted to copy, distribute and/or modify this document under
the terms of the <acronym>GNU</acronym> GPL License, Version 2
or any later version published by the Free Software Foundation.
</para>
<para>
On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->