From 55b6d4a3d82543419a2e38859c524646fd22b26d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=BD=D0=B0=D0=B1?= Date: Wed, 26 May 2021 14:34:00 +0200 Subject: [PATCH] fsck.zfs.8: modernise MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reviewed-by: Brian Behlendorf Signed-off-by: Ahelenia Ziemiańska Closes #12125 --- man/man8/fsck.zfs.8 | 96 +++++++++++++++++++++++---------------------- 1 file changed, 49 insertions(+), 47 deletions(-) diff --git a/man/man8/fsck.zfs.8 b/man/man8/fsck.zfs.8 index 934abc6772..b88dd847b1 100644 --- a/man/man8/fsck.zfs.8 +++ b/man/man8/fsck.zfs.8 @@ -1,4 +1,3 @@ -'\" t .\" .\" CDDL HEADER START .\" @@ -19,53 +18,56 @@ .\" .\" CDDL HEADER END .\" -.\" .\" Copyright 2013 Darik Horn . 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 +.Dd May 26, 2021 +.Dt FSCK.ZFS 8 +.Os +. +.Sh NAME +.Nm fsck.zfs +.Nd dummy ZFS filesystem checker +.Sh SYNOPSIS +.Nm +.Op Ar options +.Ar dataset Ns No … +. +.Sh DESCRIPTION +.Nm +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 +.Pp +If more than one +.Ar dataset +is specified, each is checked in turn and the results binary-ored. +. +.Sh OPTIONS +Ignored. +. +.Sh NOTES +ZFS datasets are checked by running +.Nm zpool Cm scrub +on the containing pool. +An individual ZFS dataset is never checked independently of its pool, +which is unlike a regular filesystem. +.Pp 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 . - -.SH "SEE ALSO" -.BR fsck (8), -.BR fstab (5), -.BR zpool-scrub (8) +.Xr fsck 8 +interface still allows it to communicate some errors: if the +.Ar dataset +is in a degraded pool, then +.Nm +will return exit code 4 to indicate an uncorrected filesystem error. +.Pp +Similarly, if the +.Ar dataset +is in a faulted pool and has a legacy +.Pa /etc/fstab +record, then +.Nm +will return exit code 8 to indicate a fatal operational error. +.Sh SEE ALSO +.Xr fstab 5 , +.Xr fsck 8 , +.Xr zpool-scrub 8