.TH fsck_ext2fs 8 2006-07-02 "Matthias Andree" "FreeBSD Ports"
.\"
.\" fsck_ext2fs.8 - manual page for fsck_ext2fs wrapper
.\"
.\" (C) Copyright 2006 by Matthias Andree <matthias.andree@gmx.de>
.\"
.\" License: This file may be redistributed in accordance with the terms
.\" of the GNU General Public License v2.
.\"
.\" Upstream $Id: fsck_ext2fs.8,v 1.3 2006/07/02 11:45:21 emma Exp $
.\" $FreeBSD$
.\"
.SH NAME
.B fsck_ext2fs
\- compatibility wrapper for e2fsck
.SH SYNOPSIS
.P
.B fsck_ext2fs
[\fB\-Fpfnyv\fR] [\fB\-b\fR \fIblock\fR]
.SH DESCRIPTION
.P
\fBfsck_ext2fs\fR maps the traditional FreeBSD \fBfsck_ffs\fR options to
options with the same functionality for \fBe2fsck,\fR runs \fBe2fsck\fR
and then maps its exit status to values that FreeBSD understands.
\fBe2fsck\fR is a utility to check and repair ext2 and ext3 file
systems.

.SH OPTIONS
.IP \fB\-F\fR
(check foreground mode required) Immediately exits with status 1 to tell
\fBfsck\fR that ext2fs cannot be checked in the background. \fBfsck\fR
usually runs \fBfsck_*\fR programs twice, first with \fB\-F\fR to find
out if they can do background checking, then either immediately without
\fB\-F\fR for foreground checking or deferred in the background with
\fB\-B\fR.
.IP \fB\-p\fR
(preen mode) This option suppresses adding the \fB\-f\fR option (unless
\fB\-f\fR is also given) and adds the \fB\-p\fR option to the
\fBe2fsck\fR command line. This causes \fBe2fsck\fR to automatically fix
any filesystem problems that can safely be fixed without operator
intervention. Without this option given, \fBe2fsck\fR will be run with
the \fB\-f\fR option to force a check, since interactive scan and repair
mode is the default on FreeBSD, but not on Linux where \fBe2fsck\fR
comes from.
.IP \fB\-f\fR
(force check) This option forces the check of a clean file system while
preening and is passed to \fBe2fsck\fR verbatim.
.IP \fB\-n\fR
("no" mode) This option causes the file system to be opened in read-only
mode and assume "no" as answer to all questions. This is the only way to
safely run \fBfsck\fR on a mounted ext2 or ext3 file system. This option
is passed to \fBe2fsck\fR verbatim.
.IP \fB\-y\fR
("yes" mode) This option is passed verbatim to \fBe2fsck\fR and causes
it to assume "yes" as answer to all questions. This allows the
non-interactive use of e2fsck but is rather aggressive. Use with care.
.IP \fB\-v\fR
(verbose output) This option is passed verbatim to \fBe2fsck\fR and
causes it to verbosely report its progress.
.IP "\fB\-b\fR \fIblock\fR"
(use alternate super block) This option is passed verbatim to
\fBe2fsck\fR and selects an alternate super block, for use when the
primary super block has been damaged. Please see the \fBe2fsck\fR(8)
manual page for details.

.SH EXIT STATUS
If errors remain after \fBe2fsck\fR, an invalid option or too many
options have been specified, \fBe2fsck\fR was killed with a signal or
the \fIfork\fB system call failed, \fBfsck_ext2fs\fR exits with status
EXIT_FAILURE (usually 1). If \fBe2fsck\fR cannot be started, exits with
status 127. If the file system is clean after \fBe2fsck\fR operation,
exits with status EXIT_SUCCESS (0).

.SH NOTES
.P
This utility is merely meant as an adaptor so that \fBe2fsck\fR can be
run during the boot process, it does not support all options that
\fBe2fsck\fR offers. If you need one of its advanced options, please run
\fBe2fsck\fR directly.

.SH FILES
.TP
.I /sbin/e2fsck
is the location of the \fBe2fsck\fR program to run.

.SH AUTHOR
.P
Matthias Andree <matthias.andree@gmx.de> wrote the program and this
manual page.
.SH CONFORMING TO
The FreeBSD 6.1 command line interface for \fBfsck_ufs\fR(8).
.SH SEE ALSO
.BR fsck (8),
.BR e2fsck (8)
and
.BR fsck_ufs (8).