0c2eb3f540
Update the fsck.zfs helper to bubble up some already-known-about errors if they are detected in the pool. health=degraded => 4/"Filesystem errors left uncorrected" health=faulted && dataset in /etc/fstab => 8/"Operational error" pool not found => 8/"Operational error" everything else => 0 Reviewed-by: Brian Behlendorf <behlendorf1@llnl.gov> Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz> Closes #11806
72 lines
2.1 KiB
Groff
72 lines
2.1 KiB
Groff
'\" t
|
|
.\"
|
|
.\" CDDL HEADER START
|
|
.\"
|
|
.\" The contents of this file are subject to the terms of the
|
|
.\" Common Development and Distribution License (the "License").
|
|
.\" You may not use this file except in compliance with the License.
|
|
.\"
|
|
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
|
|
.\" or http://www.opensolaris.org/os/licensing.
|
|
.\" See the License for the specific language governing permissions
|
|
.\" and limitations under the License.
|
|
.\"
|
|
.\" When distributing Covered Code, include this CDDL HEADER in each
|
|
.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
|
|
.\" If applicable, add the following below this CDDL HEADER, with the
|
|
.\" fields enclosed by brackets "[]" replaced with your own identifying
|
|
.\" information: Portions Copyright [yyyy] [name of copyright owner]
|
|
.\"
|
|
.\" CDDL HEADER END
|
|
.\"
|
|
.\"
|
|
.\" Copyright 2013 Darik Horn <dajhorn@vanadac.com>. All rights reserved.
|
|
.\"
|
|
.TH FSCK.ZFS 8 "Mar 27, 2021" OpenZFS
|
|
|
|
.SH NAME
|
|
fsck.zfs \- Dummy ZFS filesystem checker.
|
|
|
|
.SH SYNOPSIS
|
|
.LP
|
|
.BI "fsck.zfs [" "options" "] <" "dataset" ">…"
|
|
|
|
.SH DESCRIPTION
|
|
.LP
|
|
\fBfsck.zfs\fR is a thin shell wrapper that at most checks the status of a
|
|
dataset's container pool. It is installed by OpenZFS because some Linux
|
|
distributions expect a fsck helper for all filesystems.
|
|
.LP
|
|
If more than one \fIdataset\fR is specified, each is checked in turn
|
|
and results binary ored.
|
|
|
|
.SH OPTIONS
|
|
.HP
|
|
All \fIoptions\fR are ignored.
|
|
|
|
.SH "NOTES"
|
|
.LP
|
|
ZFS datasets are checked by running \fBzpool scrub\fR on the
|
|
containing pool. An individual ZFS dataset is never checked
|
|
independently of its pool, which is unlike a regular filesystem.
|
|
|
|
.LP
|
|
However, the
|
|
.BR fsck (8)
|
|
interface still allows it to communicate some errors:
|
|
if the \fIdataset\fR is in a degraded pool, then \fBfsck.zfs\fR will
|
|
return exit code 4 to indicate an uncorrected filesystem error.
|
|
.LP
|
|
Similarly, if the \fIdataset\fR is in a faulted pool and has a legacy
|
|
/etc/fstab record, then \fBfsck.zfs\fR will return exit code 8 to
|
|
indicate a fatal operational error.
|
|
|
|
.SH "AUTHORS"
|
|
.LP
|
|
Darik Horn <dajhorn@vanadac.com>.
|
|
|
|
.SH "SEE ALSO"
|
|
.BR fsck (8),
|
|
.BR fstab (5),
|
|
.BR zpool-scrub (8)
|