xref: /freebsd/sbin/fsck_msdosfs/fsck_msdosfs.8 (revision d9ad257a2649e83f19e1454898d5bbb76bc7483a)
10121b42aSDavid E. O'Brien.\"	$NetBSD: fsck_msdos.8,v 1.9 1997/10/17 11:19:58 ws Exp $
20121b42aSDavid E. O'Brien.\"
30121b42aSDavid E. O'Brien.\" Copyright (C) 1995 Wolfgang Solfrank
40121b42aSDavid E. O'Brien.\" Copyright (c) 1995 Martin Husemann
50121b42aSDavid E. O'Brien.\"
60121b42aSDavid E. O'Brien.\" Redistribution and use in source and binary forms, with or without
70121b42aSDavid E. O'Brien.\" modification, are permitted provided that the following conditions
80121b42aSDavid E. O'Brien.\" are met:
90121b42aSDavid E. O'Brien.\" 1. Redistributions of source code must retain the above copyright
100121b42aSDavid E. O'Brien.\"    notice, this list of conditions and the following disclaimer.
110121b42aSDavid E. O'Brien.\" 2. Redistributions in binary form must reproduce the above copyright
120121b42aSDavid E. O'Brien.\"    notice, this list of conditions and the following disclaimer in the
130121b42aSDavid E. O'Brien.\"    documentation and/or other materials provided with the distribution.
140121b42aSDavid E. O'Brien.\"
150121b42aSDavid E. O'Brien.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
160121b42aSDavid E. O'Brien.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
170121b42aSDavid E. O'Brien.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
180121b42aSDavid E. O'Brien.\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
190121b42aSDavid E. O'Brien.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
200121b42aSDavid E. O'Brien.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
210121b42aSDavid E. O'Brien.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
220121b42aSDavid E. O'Brien.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
230121b42aSDavid E. O'Brien.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
240121b42aSDavid E. O'Brien.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
250121b42aSDavid E. O'Brien.\"
26*d9ad257aSJuraj Lutter.Dd December 18, 2024
27acc8166aSRuslan Ermilov.Dt FSCK_MSDOSFS 8
28acc8166aSRuslan Ermilov.Os
290121b42aSDavid E. O'Brien.Sh NAME
30acc8166aSRuslan Ermilov.Nm fsck_msdosfs
310121b42aSDavid E. O'Brien.Nd DOS/Windows (FAT) file system consistency checker
320121b42aSDavid E. O'Brien.Sh SYNOPSIS
33acc8166aSRuslan Ermilov.Nm
340121b42aSDavid E. O'Brien.Fl p
35*d9ad257aSJuraj Lutter.Op Fl BCf
360121b42aSDavid E. O'Brien.Ar filesystem ...
37acc8166aSRuslan Ermilov.Nm
38*d9ad257aSJuraj Lutter.Op Fl BCMny
390121b42aSDavid E. O'Brien.Ar filesystem ...
400121b42aSDavid E. O'Brien.Sh DESCRIPTION
410121b42aSDavid E. O'BrienThe
420121b42aSDavid E. O'Brien.Nm
430121b42aSDavid E. O'Brienutility verifies and repairs
440121b42aSDavid E. O'Brien.Tn FAT
450121b42aSDavid E. O'Brienfile systems (more commonly known
460121b42aSDavid E. O'Brienas
470121b42aSDavid E. O'Brien.Tn DOS
480121b42aSDavid E. O'Brienfile systems).
490121b42aSDavid E. O'Brien.Pp
500121b42aSDavid E. O'BrienThe first form of
510121b42aSDavid E. O'Brien.Nm
520121b42aSDavid E. O'Brienpreens the specified file systems.
530121b42aSDavid E. O'BrienIt is normally started by
540121b42aSDavid E. O'Brien.Xr fsck 8
550121b42aSDavid E. O'Brienrun from
560121b42aSDavid E. O'Brien.Pa /etc/rc
570121b42aSDavid E. O'Brienduring automatic reboot, when a FAT file system is detected.
580121b42aSDavid E. O'BrienWhen preening file systems,
590121b42aSDavid E. O'Brien.Nm
60acc8166aSRuslan Ermilovwill fix common inconsistencies non-interactively.
61acc8166aSRuslan ErmilovIf more serious problems are found,
620121b42aSDavid E. O'Brien.Nm
630121b42aSDavid E. O'Briendoes not try to fix them, indicates that it was not
640121b42aSDavid E. O'Briensuccessful, and exits.
650121b42aSDavid E. O'Brien.Pp
660121b42aSDavid E. O'BrienThe second form of
670121b42aSDavid E. O'Brien.Nm
680121b42aSDavid E. O'Brienchecks the specified file systems and tries to repair all
690121b42aSDavid E. O'Briendetected inconsistencies, requesting confirmation before
700121b42aSDavid E. O'Brienmaking any changes.
710121b42aSDavid E. O'Brien.Pp
720121b42aSDavid E. O'BrienThe options are as follows:
73acc8166aSRuslan Ermilov.Bl -tag -width indent
74*d9ad257aSJuraj Lutter.It Fl B
75*d9ad257aSJuraj LutterIgnored for
766f81b90fSAndriy Gapon.Xr fsck 8
77*d9ad257aSJuraj Luttercompatibility.
78*d9ad257aSJuraj Lutter.It Fl C
79*d9ad257aSJuraj LutterIgnored for
80*d9ad257aSJuraj Lutter.Xr fsck 8
81*d9ad257aSJuraj Luttercompatibility.
82f5619a23SDavid E. O'Brien.It Fl F
83f5619a23SDavid E. O'BrienCompatibility with the wrapper
84f5619a23SDavid E. O'Brien.Xr fsck 8
85f5619a23SDavid E. O'Brienwhich seeks to determine whether the file system needs to be cleaned
86f5619a23SDavid E. O'Brienimmediately in foreground, or if its cleaning can be deferred to background.
87f5619a23SDavid E. O'BrienFAT (MS-DOS) file systems must always be cleaned in the foreground.
88f5619a23SDavid E. O'BrienA non-zero exit code is always returned for this option.
899a67c570SXin LI.It Fl M
909a67c570SXin LICauses
919a67c570SXin LI.Nm
929a67c570SXin LIto not use
939a67c570SXin LI.Xr mmap 2
949a67c570SXin LIwhen checking a FAT32 file system.
959a67c570SXin LIThis option is mainly for debugging purposes and is not normally necessary.
969a67c570SXin LIThe
979a67c570SXin LI.Nm
989a67c570SXin LIutility will automatically fall back to use a simple LRU cache of 4 MiB
999a67c570SXin LIwhen it failed to perform
1009a67c570SXin LI.Xr mmap 2 ,
1019a67c570SXin LIor when
1029a67c570SXin LI.Fl M
1039a67c570SXin LIis specified.
1040121b42aSDavid E. O'Brien.It Fl f
105cede1f56STom RhodesForce
106cede1f56STom Rhodes.Nm
10748eb2607SBruce Evansto check
108d04b5dfeSRuslan Ermilov.Dq clean
10948eb2607SBruce Evansfile systems when preening.
1100121b42aSDavid E. O'Brien.It Fl n
1110121b42aSDavid E. O'BrienCauses
1120121b42aSDavid E. O'Brien.Nm
113acc8166aSRuslan Ermilovto assume
114acc8166aSRuslan Ermilov.Dq Li no
115acc8166aSRuslan Ermilovas the answer to all operator
1160121b42aSDavid E. O'Brienquestions, except
117acc8166aSRuslan Ermilov.Dq Li CONTINUE? .
1180121b42aSDavid E. O'Brien.It Fl p
1190121b42aSDavid E. O'BrienPreen the specified file systems.
1200121b42aSDavid E. O'Brien.It Fl y
1210121b42aSDavid E. O'BrienCauses
1220121b42aSDavid E. O'Brien.Nm
123acc8166aSRuslan Ermilovto assume
124acc8166aSRuslan Ermilov.Dq Li yes
125acc8166aSRuslan Ermilovas the answer to all operator questions.
1260121b42aSDavid E. O'Brien.El
1270121b42aSDavid E. O'Brien.Sh SEE ALSO
1280121b42aSDavid E. O'Brien.Xr fsck 8 ,
1290121b42aSDavid E. O'Brien.Xr fsck_ffs 8 ,
1302ccd2170SPhilippe Charnier.Xr mount_msdosfs 8
1310121b42aSDavid E. O'Brien.Sh HISTORY
1320121b42aSDavid E. O'BrienThe
1330121b42aSDavid E. O'Brien.Nm
1344cbf0257SSevan Janiyanutility appeared in
1354cbf0257SSevan Janiyan.Nx 1.2 .
1364cbf0257SSevan Janiyan.Nm
1374cbf0257SSevan Janiyanfirst appeared in
1380121b42aSDavid E. O'Brien.Fx 4.4 .
1396087df9eSRuslan Ermilov.Sh BUGS
1406087df9eSRuslan ErmilovThe
1416087df9eSRuslan Ermilov.Nm
1426087df9eSRuslan Ermilovutility is
14330fc54eaSUlrich Spörlein.Ud
144