annotate docs/nitros9guide/format.refentry @ 1352:69e75af20e16

Added padrom help file
author boisy
date Wed, 17 Sep 2003 20:24:09 +0000
parents 4dae346c4969
children b00cf13c9f61
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="format">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>FORMAT</refname>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Initialize disk media</refpurpose>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
6
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
9 <command>format</command>
138
d9631713b7cd 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: 138
diff changeset
11 <replaceable>devname</replaceable>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
13 </cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
14 </refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
15
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
16 <refsect1><title>Description</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
17 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
18 This command is used to physically initialize, verify, and establish
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
19 an initial file structure on a disk. All disks must be formatted
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
20 before they can be used on an OS-9 system.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
21 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
22 <para>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
23 NOTE: If the diskette is to be used as a system disk, <command>OS9gen</command> or
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
24 <command>cobbler</command> must be run to create the bootstrap after the disk has
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
25 been formatted.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
26 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
27 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
28
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
29 The formatting process works as follows:
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
30 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
31
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
32 <orderedlist numeration="arabic">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
33 <listitem>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
34 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
35 The disk surface is physically initialized and sectored.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
36 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37 </listitem>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
38 <listitem>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
40 Each sector is read back and verified. If the sector fails to
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
41 verify after several attempts, the offending sector is excluded from
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
42 the initial free space on the disk. As the verification is
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
43 performed, track numbers are displayed on the standard output
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
44 device.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
45 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
46 </listitem>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
47 <listitem>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
48 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
49 The disk allocation map, root directory, and identification sector are written
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
50 to the first few sectors of track zero. These
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
51 sectors <emphasis>cannot</emphasis> be defective.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
52 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
53 </listitem>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
54 </orderedlist>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
55 <para>
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
56 <command>Format</command> will prompt for a disk volume name, which can be up to 32
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
57 characters long and may include spaces or punctuation. This name
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
58 can later be displayed using the FREE command.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
59 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
60 <para>
1093
4dae346c4969 Added crossreferences and lowercased synopsises
roug
parents: 1053
diff changeset
61 For more information see: <xref linkend="sec3.10"/>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
62 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
63 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
64 </refentry>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
65