xref: /openbsd/sbin/fsck_msdos/fsck_msdos.8 (revision 78b63d65)
1.\"	$OpenBSD: fsck_msdos.8,v 1.10 2000/11/09 17:52:56 aaron Exp $
2.\"	$NetBSD: fsck_msdos.8,v 1.4 1996/10/17 20:41:24 cgd Exp $
3.\"
4.\" Copyright (C) 1995 Wolfgang Solfrank
5.\" Copyright (c) 1995 Martin Husemann
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\" 1. Redistributions of source code must retain the above copyright
11.\"    notice, this list of conditions and the following disclaimer.
12.\" 2. Redistributions in binary form must reproduce the above copyright
13.\"    notice, this list of conditions and the following disclaimer in the
14.\"    documentation and/or other materials provided with the distribution.
15.\" 3. All advertising materials mentioning features or use of this software
16.\"    must display the following acknowledgement:
17.\"	This product includes software developed by Martin Husemann
18.\"	and Wolfgang Solfrank.
19.\" 4. Neither the name of the University nor the names of its contributors
20.\"    may be used to endorse or promote products derived from this software
21.\"    without specific prior written permission.
22.\"
23.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
24.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
25.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26.\" IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
27.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
28.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
29.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
30.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
31.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
32.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
33.\"
34.\"
35.Dd August 13, 1995
36.Dt FSCK_MSDOS 8
37.Os
38.Sh NAME
39.Nm fsck_msdos
40.Nd DOS/Windows (FAT) filesystem consistency checker
41.Sh SYNOPSIS
42.Nm fsck_msdos
43.Fl p
44.Op Fl f
45.Ar filesystem
46.Ar ...
47.Nm fsck_msdos
48.Op Fl fny
49.Ar filesystem
50.Ar ...
51.Sh DESCRIPTION
52The
53.Nm
54utility verifies and repairs
55.Tn FAT
56filesystems (more commonly known as
57.Tn DOS
58filesystems).
59.Pp
60The first form of
61.Nm
62preens the specified filesystems.
63It is normally started by
64.Xr fsck 8
65run from
66.Pa /etc/rc
67during automatic reboot, when a FAT filesystem is detected.
68When preening file systems,
69.Nm
70will fix common inconsistencies non-interactively.
71If more serious problems are found,
72.Nm
73does not try to fix them, indicates that it was not
74successful, and exits.
75.Pp
76The second form of
77.Nm
78checks the specified file systems and tries to repair all
79detected inconsistencies, requesting confirmation before
80making any changes.
81.Pp
82The options are as follows:
83.Bl -tag -width Ds
84.It Fl f
85This option is ignored by
86.Nm fsck_msdos ,
87and is present only for compatibility with programs that
88check other file system types for consistency, such as
89.Xr fsck_ffs 8 .
90.It Fl n
91Causes
92.Nm
93to assume
94.Dq no
95as the answer to all operator
96questions, except
97.Dq CONTINUE? .
98.It Fl p
99Preen the specified filesystems.
100.It Fl y
101Causes
102.Nm
103to assume
104.Dq yes
105as the answer to all operator questions.
106.El
107.Sh SEE ALSO
108.Xr fsck 8 ,
109.Xr fsck_ffs 8 ,
110.Xr mount_msdos 8
111.Sh BUGS
112.Nm
113is still under construction.
114