annotate docs/nitros9guide/cobbler.refentry @ 239:8b71b12c468f

Checking in the floppy disk device descriptors for Dragon 64
author roug
date Thu, 18 Jul 2002 19:53:53 +0000
parents 52af9581ef1e
children c565a4700689
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
134
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="cobbler">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>COBBLER</refname>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Make a bootstrap file</refpurpose>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
6
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>COBBLER</command>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="plain">
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
11 &replstart;device name&replend;
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
13 </cmdsynopsis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
14 </refsynopsisdiv>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
15
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
16 <refsect1><title>Description</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
17 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
18 COBBLER is used to create the &quot;OS9Boot&quot; file required on any disk
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
19 from which OS-9 is to be bootstrapped. The boot file will consist
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
20 of the <emphasis>same modules which were loaded into memory during the most
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
21 recent boostrap.</emphasis>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
22 To add modules to the bootstrap file use the
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
23 &quot;OS9Gen&quot; command. COBBLER also writes the OS-9 kernel on the first
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
24 fifteen sectors of track 34, and excludes these sectors from the
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
25 disk allocation map. If any files are present on these sectors
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
26 COBBLER will display an error message.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
27 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
28 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
29 NOTE: The boot file must fit into one contiguous block on the mass-storage
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
30 device. For this reason COBBLER is normally used on a
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
31 freshly formatted disk. If COBBLER is used on a disk and there is
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
32 not a contiguous block of storage large enough to hold the boot
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
33 file, the old boot file may have been destroyed and OS-9 will not be
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
34 able to boot from that disk until it is reformatted.
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
35 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
36 <para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
37 For more information see: 1.1.2, 6.1
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
38 </para>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
39 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
40 <refsect1><title>Examples</title>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
41 <screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
42 OS9: cobbler /D1
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
43 </screen>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
44 </refsect1>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
45 </refentry>
52af9581ef1e Split up the commands into individual files.
roug
parents:
diff changeset
46