libbtrfsutil: always build libbtrfsutil.so.$MAJOR
[platform/upstream/btrfs-progs.git] / Documentation / fsck.btrfs.asciidoc
1 fsck.btrfs(8)
2 =============
3
4 NAME
5 ----
6 fsck.btrfs - do nothing, successfully
7
8 SYNOPSIS
9 --------
10 *fsck.btrfs* [-aApy] [<device>...]
11
12 DESCRIPTION
13 -----------
14 *fsck.btrfs* is a type of utility that should exist for any filesystem and is
15 called during system setup when the corresponding `/etc/fstab` entries
16 contain non-zero value for `fs_passno`, see `fstab`(5) for more.
17
18 Traditional filesystems need to run their respective fsck utility in case the
19 filesystem was not unmounted cleanly and the log needs to be replayed before
20 mount. This is not needed for BTRFS. You should set fs_passno to 0.
21
22 If you wish to check the consistency of a BTRFS filesystem or repair a damaged
23 filesystem, see `btrfs-check`(8). By default filesystem consistency is checked,
24 the repair mode is enabled via the '--repair' option (use with care!).
25
26 OPTIONS
27 -------
28 The options are all the same and detect if *fsck.btrfs* is executed in
29 non-interactive mode and exits with success,
30 otherwise prints a message about btrfs check.
31
32 EXIT STATUS
33 -----------
34 There are two possible exit code returned:
35
36 0::
37 No error
38
39 8::
40 Operational error, eg. device does not exist
41
42 FILES
43 -----
44 `/etc/fstab`
45
46 SEE ALSO
47 --------
48 `btrfs`(8),
49 `fsck`(8),
50 `fstab`(5),