view docs/nitros9guide/cobbler.refentry @ 1053:b5ff125a1d60

Since this book was only typeset in fixed width, single-font, they used capitalization and quotes (") to show what was commands, files and just text. With today's formatting, this is not necessary, so everywhere capitalization was used to show a command the <command> element is now used instead, and everywhere a file is mentioned the <filename> element is used.
author roug
date Thu, 20 Mar 2003 20:19:53 +0000
parents c565a4700689
children 4dae346c4969
line wrap: on
line source

<refentry id="cobbler">
<refnamediv>
<refname>COBBLER</refname>
<refpurpose>Make a bootstrap file</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>COBBLER</command>
<arg choice="plain">
  <replaceable>device name</replaceable>
</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
<command>Cobbler</command> is used to create the <filename>OS9Boot</filename> file required on any disk
from which OS-9 is to be bootstrapped. The boot file will consist
of the <emphasis>same modules which were loaded into memory during the most
recent boostrap.</emphasis>
To add modules to the bootstrap file use the
<command>OS9Gen</command> command. <command>Cobbler</command> also writes the OS-9 kernel on the first
fifteen sectors of track 34, and excludes these sectors from the
disk allocation map. If any files are present on these sectors
<command>cobbler</command> will display an error message.
</para>
<para>
NOTE: The boot file must fit into one contiguous block on the mass-storage
device. For this reason <command>cobbler</command> is normally used on a
freshly formatted disk. If <command>cobbler</command> is used on a disk and there is
not a contiguous block of storage large enough to hold the boot
file, the old boot file may have been destroyed and OS-9 will not be
able to boot from that disk until it is reformatted.
</para>
<para>
For more information see: 1.1.2, 6.1
</para>
</refsect1>
<refsect1><title>Examples</title>
<screen>
OS9: cobbler /D1
</screen>
</refsect1>
</refentry>