3639912ad70c5bec91e0a2fbee7684082686b507
[platform/upstream/mtools.git] / mbadblocks.1
1 '\" t
2 .TH mbadblocks 1 "23Jul21" mtools-4.0.34
3 .SH Name
4 mbadblocks - tests a floppy disk, and marks the bad blocks in the FAT
5 '\" t
6 .de TQ
7 .br
8 .ns
9 .TP \\$1
10 ..
11
12 .tr \(is'
13 .tr \(if`
14 .tr \(pd"
15
16 .SH Note\ of\ warning
17 This manpage has been automatically generated from mtools's texinfo
18 documentation, and may not be entirely accurate or complete.  See the
19 end of this man page for details.
20 .PP
21 .SH Description
22 .PP
23 The \fR\&\f(CWmbadblocks\fR command is used to mark some clusters on an
24 MS-DOS filesystem bad. It has the following syntax:
25 .PP
26 \&\fR\&\f(CWmbadblocks\fR [\fR\&\f(CW-s\fR \fIsectorlist\fR|\fR\&\f(CW-c\fR \fIclusterlist\fR|-w] \fIdrive\fR\fR\&\f(CW:\fR
27 .PP
28 If no command line flags are supplied, \fR\&\f(CWMbadblocks\fR scans an
29 MS-DOS filesystem for bad blocks by simply trying to read them and
30 flag them if read fails. All blocks that are unused are scanned, and
31 if detected bad are marked as such in the FAT.
32 .PP
33 This command is intended to be used right after \fR\&\f(CWmformat\fR.  It is
34 not intended to salvage data from bad disks.
35 .PP
36 .SH Command\ line\ options
37 .TP
38 \&\fR\&\f(CWc\ \fIfile\fR\&\f(CW\fR\ 
39 Use a list of bad clusters, rather than scanning for bad clusters
40 itself.
41 .TP
42 \&\fR\&\f(CWs\ \fIfile\fR\&\f(CW\fR\ 
43 Use a list of bad sectors (counted from beginning of filesystem),
44 rather than trying for bad clusters itself.
45 .TP
46 \&\fR\&\f(CWw\fR\ 
47 Write a random pattern to each cluster, then read it back and flag
48 cluster as bad if mismatch. Only free clusters are tested in such a
49 way, so any file data is preserved.
50 .PP
51 .SH Bugs
52 \&\fR\&\f(CWMbadblocks\fR should (but doesn't yet :-( ) also try to salvage bad
53 blocks which are in use by reading them repeatedly, and then mark them
54 bad.
55 .PP
56 .SH See\ Also
57 Mtools' texinfo doc
58 .SH Viewing\ the\ texi\ doc
59 This manpage has been automatically generated from mtools's texinfo
60 documentation. However, this process is only approximative, and some
61 items, such as crossreferences, footnotes and indices are lost in this
62 translation process.  Indeed, these items have no appropriate
63 representation in the manpage format.  Moreover, not all information has
64 been translated into the manpage version.  Thus I strongly advise you to
65 use the original texinfo doc.  See the end of this manpage for
66 instructions how to view the texinfo doc.
67 .TP
68 * \ \ 
69 To generate a printable copy from the texinfo doc, run the following
70 commands:
71  
72 .nf
73 .ft 3
74 .in +0.3i
75     ./configure; make dvi; dvips mtools.dvi
76 .fi
77 .in -0.3i
78 .ft R
79 .PP
80  
81 \&\fR
82 .TP
83 * \ \ 
84 To generate a html copy,  run:
85  
86 .nf
87 .ft 3
88 .in +0.3i
89     ./configure; make html
90 .fi
91 .in -0.3i
92 .ft R
93 .PP
94  
95 \&\fRA premade html can be found at
96 \&\fR\&\f(CW\(ifhttp://www.gnu.org/software/mtools/manual/mtools.html\(is\fR
97 .TP
98 * \ \ 
99 To generate an info copy (browsable using emacs' info mode), run:
100  
101 .nf
102 .ft 3
103 .in +0.3i
104     ./configure; make info
105 .fi
106 .in -0.3i
107 .ft R
108 .PP
109  
110 \&\fR
111 .PP
112 The texinfo doc looks most pretty when printed or as html.  Indeed, in
113 the info version certain examples are difficult to read due to the
114 quoting conventions used in info.
115 .PP