2000-10-09 10:26:15 +00:00
|
|
|
.\" $NetBSD: fsck.8,v 1.19 1999/03/10 00:08:33 erh Exp $
|
|
|
|
|
.\"
|
|
|
|
|
.\" Copyright (c) 1996 Christos Zoulas. All rights reserved.
|
|
|
|
|
.\"
|
|
|
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
|
|
|
.\" modification, are permitted provided that the following conditions
|
|
|
|
|
.\" are met:
|
|
|
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
|
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
|
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
|
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
|
|
|
.\" must display the following acknowledgement:
|
|
|
|
|
.\" This product includes software developed by Christos Zoulas.
|
|
|
|
|
.\" 4. The name of the author may not be used to endorse or promote products
|
|
|
|
|
.\" derived from this software without specific prior written permission.
|
|
|
|
|
.\"
|
|
|
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
|
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
|
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
|
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
|
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
|
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
|
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
.\"
|
2005-02-09 18:07:17 +00:00
|
|
|
.\" $FreeBSD$
|
|
|
|
|
.\"
|
2019-03-08 10:03:16 +00:00
|
|
|
.Dd March 5, 2019
|
2000-10-09 10:26:15 +00:00
|
|
|
.Dt FSCK 8
|
2000-12-18 15:16:24 +00:00
|
|
|
.Os
|
2000-10-09 10:26:15 +00:00
|
|
|
.Sh NAME
|
|
|
|
|
.Nm fsck
|
2002-08-21 18:11:48 +00:00
|
|
|
.Nd file system consistency check and interactive repair
|
2000-10-09 10:26:15 +00:00
|
|
|
.Sh SYNOPSIS
|
2000-11-20 16:52:27 +00:00
|
|
|
.Nm
|
2009-01-30 18:33:05 +00:00
|
|
|
.Op Fl Cdfnpvy
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
.Op Fl B | F
|
2001-07-15 07:53:42 +00:00
|
|
|
.Op Fl T Ar fstype : Ns Ar fsoptions
|
2005-02-10 09:19:34 +00:00
|
|
|
.Op Fl t Ar fstype
|
2011-10-25 01:46:42 +00:00
|
|
|
.Op Fl c Ar fstab
|
2005-02-10 09:19:34 +00:00
|
|
|
.Oo Ar special | node Oc ...
|
2000-10-09 10:26:15 +00:00
|
|
|
.Sh DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.Nm
|
2002-08-21 18:11:48 +00:00
|
|
|
utility invokes file system-specific programs to check
|
2001-07-15 07:53:42 +00:00
|
|
|
the special devices listed in the
|
2000-10-09 10:26:15 +00:00
|
|
|
.Xr fstab 5
|
|
|
|
|
file or in the command line for consistency.
|
|
|
|
|
.Pp
|
|
|
|
|
It is normally used in the script
|
|
|
|
|
.Pa /etc/rc
|
|
|
|
|
during automatic reboot.
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
Traditionally,
|
|
|
|
|
.Nm
|
2002-08-21 18:11:48 +00:00
|
|
|
is invoked before the file systems are mounted
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
and all checks are done to completion at that time.
|
|
|
|
|
If background checking is available,
|
|
|
|
|
.Nm
|
|
|
|
|
is invoked twice.
|
|
|
|
|
It is first invoked at the traditional time,
|
2002-08-21 18:11:48 +00:00
|
|
|
before the file systems are mounted, with the
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
.Fl F
|
2002-08-21 18:11:48 +00:00
|
|
|
flag to do checking on all the file systems
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
that cannot do background checking.
|
|
|
|
|
It is then invoked a second time,
|
|
|
|
|
after the system has completed going multiuser, with the
|
|
|
|
|
.Fl B
|
2002-08-21 18:11:48 +00:00
|
|
|
flag to do checking on all the file systems
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
that can do background checking.
|
|
|
|
|
Unlike the foreground checking,
|
2002-12-27 12:15:40 +00:00
|
|
|
the background checking is started asynchronously
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
so that other system activity can proceed
|
2002-08-21 18:11:48 +00:00
|
|
|
even on the file systems that are being checked.
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
.Pp
|
2002-08-21 18:11:48 +00:00
|
|
|
If no file systems are specified,
|
2000-10-09 10:26:15 +00:00
|
|
|
.Nm
|
|
|
|
|
reads the table
|
|
|
|
|
.Pa /etc/fstab
|
2002-08-21 18:11:48 +00:00
|
|
|
to determine which file systems to check.
|
2001-04-27 08:28:44 +00:00
|
|
|
Only partitions in
|
|
|
|
|
.Pa /etc/fstab
|
|
|
|
|
that are mounted
|
|
|
|
|
.Dq rw ,
|
|
|
|
|
.Dq rq
|
|
|
|
|
or
|
|
|
|
|
.Dq ro
|
2000-10-09 10:26:15 +00:00
|
|
|
and that have non-zero pass number are checked.
|
2002-12-12 17:26:04 +00:00
|
|
|
File systems with pass number 1 (normally just the root file system)
|
2001-03-30 08:01:34 +00:00
|
|
|
are always checked one at a time.
|
|
|
|
|
.Pp
|
|
|
|
|
If not in preen mode, the remaining entries are checked in order of
|
|
|
|
|
increasing pass number one at a time.
|
2001-04-04 10:36:16 +00:00
|
|
|
This is needed when interaction with
|
|
|
|
|
.Nm
|
|
|
|
|
is required.
|
2001-03-30 08:01:34 +00:00
|
|
|
.Pp
|
2002-08-21 18:11:48 +00:00
|
|
|
In preen mode, after pass 1 completes, all remaining file systems are checked,
|
2001-03-30 08:01:34 +00:00
|
|
|
in pass number order running one process per disk drive in parallel for each
|
|
|
|
|
pass number in increasing order.
|
|
|
|
|
.Pp
|
2004-07-03 00:13:43 +00:00
|
|
|
In other words: In preen mode all pass 1 partitions are checked sequentially.
|
2001-03-30 08:01:34 +00:00
|
|
|
Next all pass 2 partitions are checked in parallel, one process per disk drive.
|
|
|
|
|
Next all pass 3 partitions are checked in parallel, one process per disk drive.
|
|
|
|
|
etc.
|
|
|
|
|
.Pp
|
2002-08-21 18:11:48 +00:00
|
|
|
The disk drive containing each file system is inferred from the shortest prefix
|
2000-10-09 10:26:15 +00:00
|
|
|
of the device name that ends in a digit; the remaining characters are assumed
|
2001-03-30 08:01:34 +00:00
|
|
|
to be the partition and slice designators.
|
2000-10-09 10:26:15 +00:00
|
|
|
.Pp
|
2014-05-23 14:32:57 +00:00
|
|
|
If the
|
|
|
|
|
.Fl t
|
|
|
|
|
or
|
|
|
|
|
.Fl T
|
|
|
|
|
flags are not specified,
|
|
|
|
|
.Nm
|
|
|
|
|
will attempt to determine the file system type and call the
|
|
|
|
|
appropriated file system check utility.
|
|
|
|
|
Failure to detect the file system type will cause
|
|
|
|
|
.Nm
|
|
|
|
|
to fail with a message that the partition has an unknown file system type.
|
|
|
|
|
.Pp
|
2000-10-09 10:26:15 +00:00
|
|
|
The options are as follows:
|
|
|
|
|
.Bl -tag -width indent
|
2009-01-30 18:33:05 +00:00
|
|
|
.It Fl C
|
|
|
|
|
Check if the
|
|
|
|
|
.Dq clean
|
|
|
|
|
flag is set in the superblock and skip file system checks if file system was
|
|
|
|
|
properly dismounted and marked clean.
|
2011-10-25 01:46:42 +00:00
|
|
|
.It Fl c Ar fstab
|
|
|
|
|
Specify the
|
|
|
|
|
.Pa fstab
|
|
|
|
|
file to use.
|
2000-10-09 10:26:15 +00:00
|
|
|
.It Fl d
|
2004-07-02 21:45:06 +00:00
|
|
|
Debugging mode.
|
|
|
|
|
Just print the commands without executing them.
|
|
|
|
|
Available
|
2000-10-09 10:26:15 +00:00
|
|
|
only if
|
|
|
|
|
.Nm
|
|
|
|
|
is compiled to support it.
|
|
|
|
|
.It Fl f
|
2019-03-08 10:03:16 +00:00
|
|
|
Force checking of file systems.
|
|
|
|
|
Running
|
|
|
|
|
.Dq Li fsck -f
|
|
|
|
|
ignores the journal and does a full
|
|
|
|
|
consistency check of the disk so will find and fix the errors about which the
|
|
|
|
|
journal is unaware.
|
2000-10-09 10:26:15 +00:00
|
|
|
.It Fl n
|
|
|
|
|
Causes
|
|
|
|
|
.Nm
|
|
|
|
|
to assume no as the answer to all operator questions, except "CONTINUE?".
|
|
|
|
|
.It Fl p
|
|
|
|
|
Enter preen mode.
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
In preen mode, only a restricted class of innocuous
|
2002-08-21 18:11:48 +00:00
|
|
|
file system inconsistencies will be corrected.
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
If unexpected inconsistencies caused by hardware or
|
2002-12-27 12:15:40 +00:00
|
|
|
software failures are encountered, the check program
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
will exit with a failure.
|
|
|
|
|
See the manual pages for the individual check programs
|
|
|
|
|
for a list of the sorts of failures that they correct
|
|
|
|
|
when running in preen mode.
|
|
|
|
|
.It Fl F
|
|
|
|
|
Run in foreground mode.
|
2002-08-21 18:11:48 +00:00
|
|
|
The check program for each file system is invoked with the
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
.Fl F
|
|
|
|
|
flag to determine whether it wishes to run as part of
|
|
|
|
|
the boot up sequence,
|
|
|
|
|
or if it is able to do its job in background after the
|
|
|
|
|
system is up and running.
|
|
|
|
|
A non-zero exit code indicates that it wants to run in foreground
|
|
|
|
|
and the check program is invoked.
|
|
|
|
|
A zero exit code indicates that it is able to run later in background
|
|
|
|
|
and just a deferred message is printed.
|
|
|
|
|
.It Fl B
|
|
|
|
|
Run in background mode.
|
2002-08-21 18:11:48 +00:00
|
|
|
The check program for each file system is invoked with the
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
.Fl F
|
|
|
|
|
flag to determine whether it wishes to run as part of
|
|
|
|
|
the boot up sequence,
|
|
|
|
|
or if it is able to do its job in background after the
|
|
|
|
|
system is up and running.
|
|
|
|
|
A non-zero exit code indicates that it wanted to run in foreground
|
2002-08-21 18:11:48 +00:00
|
|
|
which is assumed to have been done, so the file system is skipped.
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
A zero exit code indicates that it is able to run in background
|
|
|
|
|
so the check program is invoked with the
|
|
|
|
|
.Fl B
|
2002-08-21 18:11:48 +00:00
|
|
|
flag to indicate that a check on the active file system should be done.
|
Add support for running foreground (-F) and background (-B) checks.
Traditionally, fsck is invoked before the filesystems are mounted
and all checks are done to completion at that time. If background
checking is available, fsck is invoked twice. It is first invoked
at the traditional time, before the filesystems are mounted, with
the -F flag to do checking on all the filesystems that cannot do
background checking. It is then invoked a second time, after the
system has completed going multiuser, with the -B flag to do checking
on all the filesystems that can do background checking. Unlike
the foreground checking, the background checking is started
asynchonously so that other system activity can proceed even on
the filesystems that are being checked.
At the moment, only the fast filesystem supports background checking.
To be able to do background checking, a filesystem must have been
running with soft updates, not have been marked as needing a
foreground check, and be mounted and writable when the background
check is to be done (i.e., not listed as `noauto' in /etc/fstab).
These changes are the final piece needed to support background
filesystem checking. They will not have any effect until you update
your /etc/rc to invoke fsck in its new mode of operation. I am
still playing around with exactly what those changes should be
and should be committing them later this week.
2001-04-25 07:18:22 +00:00
|
|
|
When running in background mode,
|
2002-08-21 18:11:48 +00:00
|
|
|
only one file system at a time will be checked.
|
2010-07-22 18:33:10 +00:00
|
|
|
Note that background
|
|
|
|
|
.Nm
|
2010-08-06 14:33:42 +00:00
|
|
|
is limited to checking for only the most commonly occurring
|
2010-07-22 18:33:10 +00:00
|
|
|
file system abnormalities.
|
|
|
|
|
Under certain circumstances,
|
|
|
|
|
some errors can escape background
|
|
|
|
|
.Nm .
|
|
|
|
|
It is recommended that you perform foreground
|
|
|
|
|
.Nm
|
|
|
|
|
on your systems periodically and whenever you encounter
|
|
|
|
|
file-system\-related panics.
|
2000-10-09 10:26:15 +00:00
|
|
|
.It Fl t Ar fstype
|
|
|
|
|
Invoke
|
|
|
|
|
.Nm
|
2004-07-02 21:45:06 +00:00
|
|
|
only for the comma separated list of file system types.
|
|
|
|
|
If the
|
2000-10-09 10:26:15 +00:00
|
|
|
list starts with
|
|
|
|
|
.Dq no
|
|
|
|
|
then invoke
|
|
|
|
|
.Nm
|
2002-08-21 18:11:48 +00:00
|
|
|
for the file system types that are not specified in the list.
|
2000-10-09 10:26:15 +00:00
|
|
|
.It Fl v
|
|
|
|
|
Print the commands before executing them.
|
|
|
|
|
.It Fl y
|
|
|
|
|
Causes
|
|
|
|
|
.Nm
|
|
|
|
|
to assume yes
|
|
|
|
|
as the answer to all operator questions.
|
2001-07-15 07:53:42 +00:00
|
|
|
.It Fl T Ar fstype : Ns Ar fsoptions
|
2002-08-21 18:11:48 +00:00
|
|
|
List of comma separated file system specific options for the specified
|
|
|
|
|
file system type, in the same format as
|
2000-10-09 10:26:15 +00:00
|
|
|
.Xr mount 8 .
|
|
|
|
|
.El
|
|
|
|
|
.Sh FILES
|
|
|
|
|
.Bl -tag -width /etc/fstab -compact
|
|
|
|
|
.It Pa /etc/fstab
|
2002-08-21 18:11:48 +00:00
|
|
|
file system table
|
2000-10-09 10:26:15 +00:00
|
|
|
.El
|
|
|
|
|
.Sh SEE ALSO
|
|
|
|
|
.Xr fstab 5 ,
|
2001-04-27 08:28:44 +00:00
|
|
|
.Xr fsck_ffs 8 ,
|
2001-08-22 14:16:31 +00:00
|
|
|
.Xr fsck_msdosfs 8 ,
|
2001-04-27 08:28:44 +00:00
|
|
|
.Xr mount 8
|
2016-10-05 20:31:44 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
|
A
|
|
|
|
|
.Nm
|
|
|
|
|
utility appeared in
|
|
|
|
|
.Bx 4.0 .
|
|
|
|
|
It was reimplemented as a filesystem independent wrapper in
|
|
|
|
|
.Nx 1.3
|
|
|
|
|
and first appeared in
|
|
|
|
|
.Fx 5.0 .
|
|
|
|
|
The original filesystem specific utility became
|
|
|
|
|
.Xr fsck_ffs 8
|
|
|
|
|
at this point.
|
