Mercurial > hg > Members > kono > nitros9-code

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

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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
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">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 134
diff changeset
11 <replaceable>device name</replaceable>
134
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>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
18 <command>Cobbler</command> is used to create the <filename>OS9Boot</filename> file required on any disk
134
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
23 <command>OS9Gen</command> command. <command>Cobbler</command> also writes the OS-9 kernel on the first
134
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
26 <command>cobbler</command> will display an error message.
134
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
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
30 device. For this reason <command>cobbler</command> is normally used on a
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
31 freshly formatted disk. If <command>cobbler</command> is used on a disk and there is
134
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