]> git.ipfire.org Git - thirdparty/util-linux.git/blob - disk-utils/fsck.minix.8
Merge branch 'meson-more-build-options' of https://github.com/jwillikers/util-linux
[thirdparty/util-linux.git] / disk-utils / fsck.minix.8
1 .\" Copyright 1992, 1993, 1994 Rickard E. Faith (faith@cs.unc.edu)
2 .\" May be freely distributed.
3 .TH FSCK.MINIX 8 "June 2015" "util-linux" "System Administration"
4 .SH NAME
5 fsck.minix \- check consistency of Minix filesystem
6 .SH SYNOPSIS
7 .B fsck.minix
8 [options]
9 .I device
10 .SH DESCRIPTION
11 .B fsck.minix
12 performs a consistency check for the Linux MINIX filesystem.
13 .PP
14 The program assumes the filesystem is quiescent.
15 .B fsck.minix
16 should not be used on a mounted device unless you can be sure nobody is
17 writing to it. Remember that the kernel can write to device when it
18 searches for files.
19 .PP
20 The \fIdevice\fR name will usually have the following form:
21 .RS
22 .TS
23 tab(:);
24 l l.
25 /dev/hda[1\(en63]:IDE disk 1
26 /dev/hdb[1\(en63]:IDE disk 2
27 /dev/sda[1\(en15]:SCSI disk 1
28 /dev/sdb[1\(en15]:SCSI disk 2
29 .TE
30 .RE
31 .PP
32 If the filesystem was changed, i.e., repaired, then
33 .B fsck.minix
34 will print "FILE SYSTEM HAS CHANGED" and will
35 .BR sync (2)
36 three times before exiting. There is
37 .I no
38 need to reboot after check.
39 .SH WARNING
40 .B fsck.minix
41 should
42 .B not
43 be used on a mounted filesystem. Using
44 .B fsck.minix
45 on a mounted filesystem is very dangerous, due to the possibility that
46 deleted files are still in use, and can seriously damage a perfectly good
47 filesystem! If you absolutely have to run
48 .B fsck.minix
49 on a mounted filesystem, such as the root filesystem, make sure nothing
50 is writing to the disk, and that no files are "zombies" waiting for
51 deletion.
52 .SH OPTIONS
53 .TP
54 \fB\-l\fR, \fB\-\-list\fR
55 List all filenames.
56 .TP
57 \fB\-r\fR, \fB\-\-repair\fR
58 Perform interactive repairs.
59 .TP
60 \fB\-a\fR, \fB\-\-auto\fR
61 Perform automatic repairs. This option implies
62 .B \-\-repair
63 and serves to answer all of the questions asked with the default. Note
64 that this can be extremely dangerous in the case of extensive filesystem
65 damage.
66 .TP
67 \fB\-v\fR, \fB\-\-verbose\fR
68 Be verbose.
69 .TP
70 \fB\-s\fR, \fB\-\-super\fR
71 Output super-block information.
72 .TP
73 \fB\-m\fR, \fB\-\-uncleared\fR
74 Activate MINIX-like "mode not cleared" warnings.
75 .TP
76 \fB\-f\fR, \fB\-\-force\fR
77 Force a filesystem check even if the filesystem was marked as valid.
78 Marking is done by the kernel when the filesystem is unmounted.
79 .TP
80 \fB\-V\fR, \fB\-\-version\fR
81 Display version information and exit.
82 .TP
83 \fB\-h\fR, \fB\-\-help\fR
84 Display help text and exit.
85 .SH DIAGNOSTICS
86 There are numerous diagnostic messages. The ones mentioned here are the
87 most commonly seen in normal usage.
88 .PP
89 If the device does not exist,
90 .B fsck.minix
91 will print "unable to read super block". If the device exists, but is not
92 a MINIX filesystem,
93 .B fsck.minix
94 will print "bad magic number in super-block".
95 .SH "EXIT CODES"
96 The exit code returned by
97 .B fsck.minix
98 is the sum of the following:
99 .PP
100 .RS
101 .PD 0
102 .TP
103 .B 0
104 No errors
105 .TP
106 .B 3
107 Filesystem errors corrected, system should be rebooted if filesystem was
108 mounted
109 .TP
110 .B 4
111 Filesystem errors left uncorrected
112 .TP
113 .B 7
114 Combination of exit codes 3 and 4
115 .TP
116 .B 8
117 Operational error
118 .TP
119 .B 16
120 Usage or syntax error
121 .PD
122 .RE
123 .PP
124 .SH AUTHORS
125 .MT torvalds@\:cs.\:helsinki.\:fi
126 Linus Torvalds
127 .ME
128 .br
129 Error code values by
130 .MT faith@\:cs.\:unc.\:edu
131 Rik Faith
132 .ME
133 .br
134 Added support for filesystem valid flag:
135 .MT greg%\:wind.\:uucp@\:plains.\:nodak.\:edu
136 Dr.\& Wettstein
137 .ME .
138 .br
139 Check to prevent fsck of mounted filesystem added by
140 .MT quinlan@\:yggdrasil.\:com
141 Daniel Quinlan
142 .ME .
143 .br
144 Minix v2 fs support by
145 .MT schwab@\:issan.\:informatik.\:uni-dortmund.\:de
146 Andreas Schwab
147 .ME ,
148 updated by
149 .MT janl@\:math.\:uio.\:no
150 Nicolai Langfeldt
151 .ME .
152 .br
153 Portability patch by
154 .MT rmk@\:ecs.\:soton.\:ac.\:uk
155 Russell King
156 .ME .
157 .SH "SEE ALSO"
158 .BR fsck (8),
159 .BR fsck.ext2 (8),
160 .BR mkfs (8),
161 .BR mkfs.ext2 (8),
162 .BR mkfs.minix (8),
163 .BR reboot (8)
164 .SH AVAILABILITY
165 The fsck.minix command is part of the util-linux package and is available from
166 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
167 Linux Kernel Archive
168 .UE .