Improve the process for GNU tools
[minix3.git] / minix / commands / fsck.mfs / fsck.mfs.1
blobe800c74481f38c6d4cfd164aa669189a79f01b8c
1 .TH FSCK 1
2 .SH NAME
3 fsck \- perform file system consistency check
4 .SH SYNOPSIS
5 \fBfsck\fR [\fB\-aclmrs\fR]\fR [\fIdevice\fR] ...\fR
6 .br
7 .de FL
8 .TP
9 \\fB\\$1\\fR
10 \\$2
12 .de EX
13 .TP 20
14 \\fB\\$1\\fR
15 # \\$2
17 .SH OPTIONS
18 .TP 5
19 .B \-a
20 # Automatically repair inconsistencies
21 .TP 5
22 .B \-c
23 # Check and list only the specified i-nodes
24 .TP 5
25 .B \-l
26 # List the files and directories in the filesytem
27 .TP 5
28 .B \-r
29 # Prompt user for repairs if inconsistencies are found
30 .TP 5
31 .B \-s
32 # List the superblock of the file system
33 .SH EXAMPLES
34 .TP 20
35 .B fsck /dev/c0d0p3
36 # Check file system on \fI/dev/c0d0p3\fR
37 .TP 20
38 .B fsck \-a /dev/at0
39 # Automatically fix errors on \fI/dev/at0\fR
40 .TP 20
41 .B fsck \-l /dev/fd0
42 # List the contents of \fI/dev/fd0\fR
43 .TP 20
44 .B fsck \-c 2 3 /dev/c0d0p2
45 # Check and list \fI/dev/c0d0p2\fR i-nodes 2 & 3
46 .SH DESCRIPTION
47 .PP
48 \fIFsck\fR performs consistency checks on the file systems which reside 
49 on the specified devices.
50 When either the \fB\-a\fR or \fB\-r\fR flags are given, the file system
51 will be repaired if errors are found.
52 Before running \fIfsck\fR on a mounted file system, it must first be unmounted.
53 Trying to repair a mounted file system is dangerous and should not be 
54 attempted.
55 .PP
56 To repair the root file system (which cannot be unmounted), first 
57 type CTRL-F9 at the console to kill any and all processes.  Log back in
58 as \fBroot\fR, type \fIsync\fR to force any buffered changes to disk,
59 run \fIfsck\fR on the root file system and immediately reboot the
60 computer by typing \fIreboot\fR.
61 .PP
62 It is necessary to kill all processes before repairing the root file system
63 to prevent them from modifying any disk blocks while \fIfsck\fR is running.
64 This is only necessary for the root file system, any other file system can
65 simply be unmounted before it is checked.
66 .SH "SEE ALSO"
67 .BR mkfs (1),
68 .BR mount (1).
69 .\" disk name refs corrected, i.e., old hd1 now c0d0p0 -- ASW 2005-01-15