Mercurial > hg > Members > kono > nitros9-code

annotate docs/nitros9guide/free.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
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="free">
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>FREE</refname>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Display free space remaining on mass-storage device</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>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>FREE</command>
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 displays the number of unused 256-byte sectors on a
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
19 device which are available for new files or for expanding existing
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
20 files. The device name given must be that of a mass-storage
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
21 multifile device. <command>Free</command> also displays the disk's name, creation
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
22 date, and cluster size.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
23 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
24 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
25 Data sectors are allocated in groups called &quot;clusters&quot;. The number
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
26 of sectors per cluster depends on the storage capacity and physical
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
27 characteristics of the specific device. This means that small
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
28 amounts of free space may not be divisible into as many files. For
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
29 example, if a given disk system uses 8 sectors per cluster, and a
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
30 <command>free</command> command shows 32 sectors free, a maximum of four new files
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
31 could be created even if each has only one cluster.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
32 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
33 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
34 For more information see: 3.10
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
35 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
36 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37 <refsect1><title>Examples</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
38 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39 OS9: free
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
40 BACKUP DATA DISK created on: 80/06/12
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
41 Capacity: 1,232 sectors (1-sector clusters)
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
42 1,020 free sectors, largest block 935 sectors
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
43
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
44 OS9: free /D1
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
45 OS-9 Documentation Disk created on: 81/04/13
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
46 Capacity: 1,232 sectors (1-sector clusters)
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
47 568 Free sectors, largest block 440 sectors
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
48 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
49 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
50 </refentry>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
51