btrfs-progs: add fsck.btrfs stub and manpage

Signed-off-by: David Sterba <dsterba@suse.cz>
Signed-off-by: Chris Mason <clm@fb.com>
This commit is contained in:
David Sterba 2013-09-02 17:22:24 +02:00 committed by Chris Mason
parent f1d08d2253
commit b085b145b6
4 changed files with 90 additions and 1 deletions

View File

@ -236,6 +236,7 @@ $(CLEANDIRS):
install: $(libs) $(progs) $(INSTALLDIRS)
$(INSTALL) -m755 -d $(DESTDIR)$(bindir)
$(INSTALL) $(progs) $(DESTDIR)$(bindir)
$(INSTALL) fsck.btrfs $(DESTDIR)$(bindir)
# btrfsck is a link to btrfs in the src tree, make it so for installed file as well
$(LN) -f $(DESTDIR)$(bindir)/btrfs $(DESTDIR)$(bindir)/btrfsck
$(INSTALL) -m755 -d $(DESTDIR)$(libdir)

40
fsck.btrfs Executable file
View File

@ -0,0 +1,40 @@
#!/bin/sh -f
#
# Copyright (c) 2013 SUSE
#
# copied from fsck.xfs
# Copyright (c) 2006 Silicon Graphics, Inc. All Rights Reserved.
#
# fsck.btrfs is a type of utility that should exist for any filesystem and is
# called during system setup when the corresponding /etc/fstab entries contain
# non-zero value for fs_passno. (See fstab(5) for more.)
#
# Traditional filesystems need to run their respective fsck utility in case the
# filesystem was not unmounted cleanly and the log needs to be replayed before
# mount. This is not needed for BTRFS. You should set fs_passno to 0.
#
# If you wish to check the consistency of a BTRFS filesystem or repair a
# damaged filesystem, see btrfs(8) subcommand 'check'. By default the
# filesystem consistency is checked, the repair mode is enabled via --repair
# option (use with care!).
AUTO=false
while getopts ":aApy" c
do
case $c in
a|A|p|y) AUTO=true;;
esac
done
eval DEV=\${$#}
if [ ! -e $DEV ]; then
echo "$0: $DEV does not exist"
exit 8
fi
if $AUTO; then
echo "$0: BTRFS file system."
else
echo "If you wish to check the consistency of a BTRFS filesystem or"
echo "repair a damaged filesystem, see btrfs(8) subcommand 'check'."
fi
exit 0

View File

@ -13,7 +13,8 @@ man8dir = $(mandir)/man8
MANPAGES = mkfs.btrfs.8.gz btrfsck.8.gz btrfs-image.8.gz btrfs.8.gz \
btrfs-debug-tree.8.gz btrfs-show-super.8.gz btrfs-find-root.8.gz \
btrfs-convert.8.gz btrfstune.8.gz btrfs-zero-log.8.gz btrfs-map-logical.8.gz
btrfs-convert.8.gz btrfstune.8.gz btrfs-zero-log.8.gz btrfs-map-logical.8.gz \
fsck.btrfs.8.gz
INFILES = ${MANPAGES:.in=.gz}
all: $(MANPAGES)

47
man/fsck.btrfs.8.in Normal file
View File

@ -0,0 +1,47 @@
.TH fsck.btrfs 8
.SH NAME
fsck.btrfs \- do nothing, successfully
.SH SYNOPSIS
.B fsck.btrfs
[\fB-aApy\fP]
[\fBdevice...\fP]
.SH DESCRIPTION
.B fsck.btrfs
is a type of utility that should exist for any filesystem and is
called during system setup when the corresponding
.BR /etc/fstab
entries contain non-zero value for
.BR fs_passno
, see
.BR fstab(5)
for more.
.PP
Traditional filesystems need to run their respective fsck utility in case the
filesystem was not unmounted cleanly and the log needs to be replayed before
mount. This is not needed for BTRFS. You should set fs_passno to 0.
.PP
If you wish to check the consistency of a BTRFS filesystem or repair a damaged
filesystem, see
.BR btrfs(8)
subcommand 'check'. By default the filesystem
consistency is checked, the repair mode is enabled via --repair option (use
with care!).
.SH OPTIONS
The options detect if \fBfsck.btrfs\fP is executed in non-interactive mode and exits
with success, otherwise prints a message about \fBbtrfs check\fP.
.SH EXIT CODE
There are two possible exit code returned:
.RS
.IP 0 5
No errors
.IP 8 5
Operational error, eg. device does not exist
.RE
.
.SH FILES
.IR /etc/fstab .
.SH SEE ALSO
.BR btrfs (8),
.BR fsck (8),
.BR fstab (5),
.\" btrfsck is intentionally left out