path: root/templates/man5/btrfs.5.pot

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2024-06-01 05:43+0200\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "BTRFS"
msgstr ""

#. type: TH
#: archlinux
#, no-wrap
msgid "May 03, 2024"
msgstr ""

#. type: TH
#: archlinux fedora-rawhide opensuse-tumbleweed
#, no-wrap
msgid "6.8.1"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"btrfs - topics about the BTRFS filesystem (mount options, supported file "
"attributes and other)"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This document describes topics related to BTRFS that are not specific to the "
"tools.  Currently covers:"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "1."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "mount options"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "2."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "filesystem features"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "3."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "checksum algorithms"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "4."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "compression"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "5."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "sysfs interface"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "6."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "filesystem exclusive operations"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "7."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "filesystem limits"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "8."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "bootloader support"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "9."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "file attributes"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "10."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "zoned mode"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "11."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "control device"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "12."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "filesystems with multiple block group profiles"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "13."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "seeding device"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "14."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "RAID56 status and recommended practices"
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "15."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "storage model, hardware considerations"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "MOUNT OPTIONS"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "BTRFS SPECIFIC MOUNT OPTIONS"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"This section describes mount options specific to BTRFS.  For the generic "
"mount options please refer to \\X'tty: link https://man7.org/linux/man-pages/"
"man8/mount.8.html'I<\\%mount(8)>\\X'tty: link' manual page. The options are "
"sorted alphabetically (discarding the I<no> prefix)."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<NOTE:>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Most mount options apply to the whole filesystem and only options in the "
"first mounted subvolume will take effect. This is due to lack of "
"implementation and may change in the future. This means that (for example) "
"you can\\(aqt set per-subvolume I<nodatacow>, I<nodatasum>, or I<compress> "
"using mount options. This should eventually be fixed, but it has proved to "
"be difficult to implement correctly within the Linux VFS framework."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Mount options are processed in order, only the last occurrence of an option "
"takes effect and may disable other options due to constraints (see e.g.  "
"I<nodatacow> and I<compress>). The output of B<mount> command shows which "
"options have been applied."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<acl, noacl>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: on)"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Enable/disable support for POSIX Access Control Lists (ACLs).  See the "
"\\X'tty: link https://man7.org/linux/man-pages/man5/acl.5.html'I<\\"
"%acl(5)>\\X'tty: link' manual page for more information about ACLs."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The support for ACL is build-time configurable (BTRFS_FS_POSIX_ACL) and "
"mount fails if I<acl> is requested but the feature is not compiled in."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<autodefrag, noautodefrag>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.0, default: off)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Enable automatic file defragmentation.  When enabled, small random writes "
"into files (in a range of tens of kilobytes, currently it\\(aqs 64KiB) are "
"detected and queued up for the defragmentation process.  May not be well "
"suited for large database workloads."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The read latency may increase due to reading the adjacent blocks that make "
"up the range for defragmentation, successive write will merge the blocks in "
"the new location."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<WARNING:>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Defragmenting with Linux kernel versions E<lt> 3.9 or ≥ 3.14-rc2 as well as "
"with Linux stable kernel versions ≥ 3.10.31, ≥ 3.12.12 or ≥ 3.13.4 will "
"break up the reflinks of COW data (for example files copied with B<cp --"
"reflink>, snapshots or de-duplicated data).  This may cause considerable "
"increase of space usage depending on the broken up reflinks."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<barrier, nobarrier>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Ensure that all IO write operations make it through the device cache and are "
"stored permanently when the filesystem is at its consistency checkpoint. "
"This typically means that a flush command is sent to the device that will "
"synchronize all pending data and ordinary metadata blocks, then writes the "
"superblock and issues another flush."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The write flushes incur a slight hit and also prevent the IO block scheduler "
"to reorder requests in a more effective way. Disabling barriers gets rid of "
"that penalty but will most certainly lead to a corrupted filesystem in case "
"of a crash or power loss. The ordinary metadata blocks could be yet "
"unwritten at the time the new superblock is stored permanently, expecting "
"that the block pointers to metadata were stored permanently before."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"On a device with a volatile battery-backed write-back cache, the "
"I<nobarrier> option will not lead to filesystem corruption as the pending "
"blocks are supposed to make it to the permanent storage."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<check_int, check_int_data, check_int_print_mask=E<lt>valueE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"These debugging options control the behavior of the integrity checking "
"module (the BTRFS_FS_CHECK_INTEGRITY config option required). The main goal "
"is to verify that all blocks from a given transaction period are properly "
"linked."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<check_int> enables the integrity checker module, which examines all block "
"write requests to ensure on-disk consistency, at a large memory and CPU cost."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<check_int_data> includes extent data in the integrity checks, and implies "
"the I<check_int> option."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<check_int_print_mask> takes a bitmask of BTRFSIC_PRINT_MASK_* values as "
"defined in I<fs/btrfs/check-integrity.c>, to control the integrity checker "
"module behavior."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"See comments at the top of I<fs/btrfs/check-integrity.c> for more "
"information."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<clear_cache>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Force clearing and rebuilding of the free space cache if something has gone "
"wrong."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"For free space cache I<v1>, this only clears (and, unless I<nospace_cache> "
"is used, rebuilds) the free space cache for block groups that are modified "
"while the filesystem is mounted with that option. To actually clear an "
"entire free space cache I<v1>, see B<btrfs check --clear-space-cache v1>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"For free space cache I<v2>, this clears the entire free space cache.  To do "
"so without requiring to mounting the filesystem, see B<btrfs check --clear-"
"space-cache v2>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "See also: I<space_cache>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<commit=E<lt>secondsE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.12, default: 30)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Set the interval of periodic transaction commit when data are synchronized "
"to permanent storage. Higher interval values lead to larger amount of "
"unwritten data, which has obvious consequences when the system crashes.  The "
"upper bound is not forced, but a warning is printed if it\\(aqs more than "
"300 seconds (5 minutes). Use with care."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<compress, compress=E<lt>type[:level]E<gt>, compress-force, compress-force=E<lt>type[:level]E<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: off, level support since: 5.1)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Control BTRFS file data compression.  Type may be specified as I<zlib>, "
"I<lzo>, I<zstd> or I<no> (for no compression, used for remounting).  If no "
"type is specified, I<zlib> is used.  If I<compress-force> is specified, then "
"compression will always be attempted, but the data may end up uncompressed "
"if the compression would make them larger."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Both I<zlib> and I<zstd> (since version 5.1) expose the compression level as "
"a tunable knob with higher levels trading speed and memory (I<zstd>) for "
"higher compression ratios. This can be set by appending a colon and the "
"desired level.  ZLIB accepts the range [1, 9] and ZSTD accepts [1, 15]. If "
"no level is set, both currently use a default level of 3. The value 0 is an "
"alias for the default level."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Otherwise some simple heuristics are applied to detect an incompressible "
"file.  If the first blocks written to a file are not compressible, the whole "
"file is permanently marked to skip compression. As this is too simple, the "
"I<compress-force> is a workaround that will compress most of the files at "
"the cost of some wasted CPU cycles on failed attempts.  Since kernel 4.15, a "
"set of heuristic algorithms have been improved by using frequency sampling, "
"repeated pattern detection and Shannon entropy calculation to avoid that."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "If compression is enabled, I<nodatacow> and I<nodatasum> are disabled."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<datacow, nodatacow>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Enable data copy-on-write for newly created files.  I<Nodatacow> implies "
"I<nodatasum>, and disables I<compression>\\&. All files created under "
"I<nodatacow> are also set the NOCOW file attribute (see \\X'tty: link "
"https://man7.org/linux/man-pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: "
"link')."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "If I<nodatacow> or I<nodatasum> are enabled, compression is disabled."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Updates in-place improve performance for workloads that do frequent "
"overwrites, at the cost of potential partial writes, in case the write is "
"interrupted (system crash, device failure)."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<datasum, nodatasum>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Enable data checksumming for newly created files.  I<Datasum> implies "
"I<datacow>, i.e. the normal mode of operation. All files created under "
"I<nodatasum> inherit the \"no checksums\" property, however there\\(aqs no "
"corresponding file attribute (see \\X'tty: link https://man7.org/linux/man-"
"pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: link')."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There is a slight performance gain when checksums are turned off, the "
"corresponding metadata blocks holding the checksums do not need to updated.  "
"The cost of checksumming of the blocks in memory is much lower than the IO, "
"modern CPUs feature hardware support of the checksumming algorithm."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<degraded>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: off)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Allow mounts with fewer devices than the RAID profile constraints require.  "
"A read-write mount (or remount) may fail when there are too many devices "
"missing, for example if a stripe member is completely missing from RAID0."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Since 4.14, the constraint checks have been improved and are verified on the "
"chunk level, not at the device level. This allows degraded mounts of "
"filesystems with mixed RAID profiles for data and metadata, even if the "
"device number constraints would not be satisfied for some of the profiles."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Example: metadata -- raid1, data -- single, devices -- B</dev/sda>, B</dev/"
"sdb>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Suppose the data are completely stored on I<sda>, then missing I<sdb> will "
"not prevent the mount, even if 1 missing device would normally prevent "
"(any)  I<single> profile to mount. In case some of the data chunks are "
"stored on I<sdb>, then the constraint of single/data is not satisfied and "
"the filesystem cannot be mounted."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<device=E<lt>devicepathE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Specify a path to a device that will be scanned for BTRFS filesystem during "
"mount. This is usually done automatically by a device manager (like udev) or "
"using the B<btrfs device scan> command (e.g. run from the initial ramdisk). "
"In cases where this is not possible the I<device> mount option can help."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Booting e.g. a RAID1 system may fail even if all filesystem\\(aqs I<device> "
"paths are provided as the actual device nodes may not be discovered by the "
"system at that point."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<discard, discard=sync, discard=async, nodiscard>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(default: async when devices support it since 6.2, async support since: 5.6)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Enable discarding of freed file blocks.  This is useful for SSD devices, "
"thinly provisioned LUNs, or virtual machine images; however, every storage "
"layer must support discard for it to work."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In the synchronous mode (I<sync> or without option value), lack of "
"asynchronous queued TRIM on the backing device TRIM can severely degrade "
"performance, because a synchronous TRIM operation will be attempted instead. "
"Queued TRIM requires newer than SATA revision 3.1 chipsets and devices."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The asynchronous mode (I<async>) gathers extents in larger chunks before "
"sending them to the devices for TRIM. The overhead and performance impact "
"should be negligible compared to the previous mode and it\\(aqs supposed to "
"be the preferred mode if needed."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If it is not necessary to immediately discard freed blocks, then the "
"B<fstrim> tool can be used to discard all free blocks in a batch. Scheduling "
"a TRIM during a period of low system activity will prevent latent "
"interference with the performance of other operations. Also, a device may "
"ignore the TRIM command if the range is too small, so running a batch "
"discard has a greater probability of actually discarding the blocks."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<enospc_debug, noenospc_debug>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Enable verbose output for some ENOSPC conditions. It\\(aqs safe to use but "
"can be noisy if the system reaches near-full state."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<fatal_errors=E<lt>actionE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.4, default: bug)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Action to take when encountering a fatal error."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<bug>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<BUG()> on a fatal error, the system will stay in the crashed state and may "
"be still partially usable, but reboot is required for full operation"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<panic>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<panic()> on a fatal error, depending on other system configuration, this "
"may be followed by a reboot. Please refer to the documentation of kernel "
"boot parameters, e.g. I<panic>, I<oops> or I<crashkernel>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<flushoncommit, noflushoncommit>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This option forces any data dirtied by a write in a prior transaction to "
"commit as part of the current commit, effectively a full filesystem sync."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This makes the committed state a fully consistent view of the file system "
"from the application\\(aqs perspective (i.e. it includes all completed file "
"system operations). This was previously the behavior only when a snapshot "
"was created."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When off, the filesystem is consistent but buffered writes may last more "
"than one transaction commit."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<fragment=E<lt>typeE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(depends on compile-time option CONFIG_BTRFS_DEBUG, since: 4.4, default: off)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A debugging helper to intentionally fragment given I<type> of block groups. "
"The type can be I<data>, I<metadata> or I<all>\\&. This mount option should "
"not be used outside of debugging environments and is not recognized if the "
"kernel config option I<CONFIG_BTRFS_DEBUG> is not enabled."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<nologreplay>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: off, even read-only)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The tree-log contains pending updates to the filesystem until the full "
"commit.  The log is replayed on next mount, this can be disabled by this "
"option.  See also I<treelog>\\&.  Note that I<nologreplay> is the same as "
"I<norecovery>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Currently, the tree log is replayed even with a read-only mount! To disable "
"that behaviour, mount also with I<nologreplay>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<max_inline=E<lt>bytesE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: min(2048, page size) )"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Specify the maximum amount of space, that can be inlined in a metadata b-"
"tree leaf.  The value is specified in bytes, optionally with a K suffix "
"(case insensitive).  In practice, this value is limited by the filesystem "
"block size (named I<sectorsize> at mkfs time), and memory page size of the "
"system. In case of sectorsize limit, there\\(aqs some space unavailable due "
"to b-tree leaf headers.  For example, a 4KiB sectorsize, maximum size of "
"inline data is about 3900 bytes."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Inlining can be completely turned off by specifying 0. This will increase "
"data block slack if file sizes are much smaller than block size but will "
"reduce metadata consumption in return."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The default value has changed to 2048 in kernel 4.6."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<metadata_ratio=E<lt>valueE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: 0, internal logic)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Specifies that 1 metadata chunk should be allocated after every I<value> "
"data chunks. Default behaviour depends on internal logic, some percent of "
"unused metadata space is attempted to be maintained but is not always "
"possible if there\\(aqs not enough space left for chunk allocation. The "
"option could be useful to override the internal logic in favor of the "
"metadata allocation if the expected workload is supposed to be metadata "
"intense (snapshots, reflinks, xattrs, inlined files)."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<norecovery>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 4.5, default: off)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Do not attempt any data recovery at mount time. This will disable "
"I<logreplay> and avoids other write operations. Note that this option is the "
"same as I<nologreplay>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The opposite option I<recovery> used to have different meaning but was "
"changed for consistency with other filesystems, where I<norecovery> is used "
"for skipping log replay. BTRFS does the same and in general will try to "
"avoid any write operations."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<rescan_uuid_tree>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.12, default: off)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Force check and rebuild procedure of the UUID tree. This should not normally "
"be needed."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<rescue>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 5.9)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Modes allowing mount with damaged filesystem structures."
msgstr ""

#. type: IP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "\\(bu"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<usebackuproot> (since: 5.9, replaces standalone option I<usebackuproot>)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<nologreplay> (since: 5.9, replaces standalone option I<nologreplay>)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<ignorebadroots>, I<ibadroots> (since: 5.11)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<ignoredatacsums>, I<idatacsums> (since: 5.11)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<all> (since: 5.9)"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<skip_balance>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.3, default: off)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Skip automatic resume of an interrupted balance operation. The operation can "
"later be resumed with B<btrfs balance resume>, or the paused state can be "
"removed with B<btrfs balance cancel>\\&. The default behaviour is to resume "
"an interrupted balance immediately after a volume is mounted."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<space_cache, space_cache=E<lt>versionE<gt>, nospace_cache>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(I<nospace_cache> since: 3.2, I<space_cache=v1> and I<space_cache=v2> since "
"4.5, default: I<space_cache=v2>)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Options to control the free space cache. The free space cache greatly "
"improves performance when reading block group free space into memory. "
"However, managing the space cache consumes some resources, including a small "
"amount of disk space."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are two implementations of the free space cache. The original one, "
"referred to as I<v1>, used to be a safe default but has been superseded by "
"I<v2>\\&.  The I<v1> space cache can be disabled at mount time with "
"I<nospace_cache> without clearing."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"On very large filesystems (many terabytes) and certain workloads, the "
"performance of the I<v1> space cache may degrade drastically. The I<v2> "
"implementation, which adds a new b-tree called the free space tree, "
"addresses this issue. Once enabled, the I<v2> space cache will always be "
"used and cannot be disabled unless it is cleared. Use I<clear_cache,"
"space_cache=v1> or I<clear_cache,nospace_cache> to do so. If I<v2> is "
"enabled, and I<v1> space cache will be cleared (at the first mount) and "
"kernels without I<v2> support will only be able to mount the filesystem in "
"read-only mode.  On an unmounted filesystem the caches (both versions) can "
"be cleared by \"btrfs check --clear-space-cache\"."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<\\%btrfs-check(8)> and I<:doc:\\(gamkfs.btrfs> commands have full "
"I<v2> free space cache support since v4.19."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If a version is not explicitly specified, the default implementation will be "
"chosen, which is I<v2>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<ssd, ssd_spread, nossd, nossd_spread>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: SSD autodetected)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Options to control SSD allocation schemes.  By default, BTRFS will enable or "
"disable SSD optimizations depending on status of a device with respect to "
"rotational or non-rotational type. This is determined by the contents of I</"
"sys/block/DEV/queue/rotational>). If it is 0, the I<ssd> option is turned "
"on.  The option I<nossd> will disable the autodetection."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The optimizations make use of the absence of the seek penalty that\\(aqs "
"inherent for the rotational devices. The blocks can be typically written "
"faster and are not offloaded to separate threads."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Since 4.14, the block layout optimizations have been dropped. This used to "
"help with first generations of SSD devices. Their FTL (flash translation "
"layer) was not effective and the optimization was supposed to improve the "
"wear by better aligning blocks. This is no longer true with modern SSD "
"devices and the optimization had no real benefit. Furthermore it caused "
"increased fragmentation. The layout tuning has been kept intact for the "
"option I<ssd_spread>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<ssd_spread> mount option attempts to allocate into bigger and aligned "
"chunks of unused space, and may perform better on low-end SSDs.  "
"I<ssd_spread> implies I<ssd>, enabling all other SSD heuristics as well. The "
"option I<nossd> will disable all SSD options while I<nossd_spread> only "
"disables I<ssd_spread>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<subvol=E<lt>pathE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Mount subvolume from I<path> rather than the toplevel subvolume. The I<path> "
"is always treated as relative to the toplevel subvolume.  This mount option "
"overrides the default subvolume set for the given filesystem."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<subvolid=E<lt>subvolidE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Mount subvolume specified by a I<subvolid> number rather than the toplevel "
"subvolume.  You can use B<btrfs subvolume list> of B<btrfs subvolume show> "
"to see subvolume ID numbers.  This mount option overrides the default "
"subvolume set for the given filesystem."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If both I<subvolid> and I<subvol> are specified, they must point at the same "
"subvolume, otherwise the mount will fail."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<thread_pool=E<lt>numberE<gt>>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(default: min(NRCPUS + 2, 8) )"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The number of worker threads to start. NRCPUS is number of on-line CPUs "
"detected at the time of mount. Small number leads to less parallelism in "
"processing data and metadata, higher numbers could lead to a performance hit "
"due to increased locking contention, process scheduling, cache-line bouncing "
"or costly data transfers between local CPU memories."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<treelog, notreelog>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Enable the tree logging used for I<fsync> and I<O_SYNC> writes. The tree log "
"stores changes without the need of a full filesystem sync. The log "
"operations are flushed at sync and transaction commit. If the system crashes "
"between two such syncs, the pending tree log operations are replayed during "
"mount."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Currently, the tree log is replayed even with a read-only mount! To disable "
"that behaviour, also mount with I<nologreplay>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The tree log could contain new files/directories, these would not exist on a "
"mounted filesystem if the log is not replayed."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<usebackuproot>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 4.6, default: off)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Enable autorecovery attempts if a bad tree root is found at mount time.  "
"Currently this scans a backup list of several previous tree roots and tries "
"to use the first readable. This can be used with read-only mounts as well."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "This option has replaced I<recovery>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<user_subvol_rm_allowed>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Allow subvolumes to be deleted by their respective owner. Otherwise, only "
"the root user can do that."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Historically, any user could create a snapshot even if he was not owner of "
"the source subvolume, the subvolume deletion has been restricted for that "
"reason. The subvolume creation has been restricted but this mount option is "
"still required. This is a usability issue.  Since 4.18, the \\X'tty: link "
"https://man7.org/linux/man-pages/man2/rmdir.2.html'I<\\%rmdir(2)>\\X'tty: "
"link' syscall can delete an empty subvolume just like an ordinary directory. "
"Whether this is possible can be detected at runtime, see I<rmdir_subvol> "
"feature in I<FILESYSTEM FEATURES>\\&."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "DEPRECATED MOUNT OPTIONS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"List of mount options that have been removed, kept for backward "
"compatibility."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<recovery>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.2, default: off, deprecated since: 4.5)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This option has been replaced by I<usebackuproot> and should not be used but "
"will work on 4.5+ kernels."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<inode_cache, noinode_cache>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(removed in: 5.11, since: 3.0, default: off)"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"The functionality has been removed in 5.11, any stale data created by "
"previous use of the I<inode_cache> option can be removed by \\X'tty: link "
"#man-rescue-clear-ino-cache'I<\\%btrfs rescue clear-ino-cache>\\X'tty: "
"link'\\&."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "NOTES ON GENERIC MOUNT OPTIONS"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Some of the general mount options from \\X'tty: link https://man7.org/linux/"
"man-pages/man8/mount.8.html'I<\\%mount(8)>\\X'tty: link' that affect BTRFS "
"and are worth mentioning."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<noatime>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"under read intensive work-loads, specifying I<noatime> significantly "
"improves performance because no new access time information needs to be "
"written. Without this option, the default is I<relatime>, which only reduces "
"the number of inode atime updates in comparison to the traditional "
"I<strictatime>\\&. The worst case for atime updates under I<relatime> occurs "
"when many files are read whose atime is older than 24 h and which are "
"freshly snapshotted. In that case the atime is updated and COW happens - for "
"each file - in bulk. See also \\X'tty: link https://lwn.net/"
"Articles/499293/'I<\\%https://lwn.net/Articles/499293/>\\X'tty: link' - "
"I<Atime and btrfs: a bad combination? (LWN, 2012-05-31)>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Note that I<noatime> may break applications that rely on atime uptimes like "
"the venerable Mutt (unless you use maildir mailboxes)."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "FILESYSTEM FEATURES"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The basic set of filesystem features gets extended over time. The backward "
"compatibility is maintained and the features are optional, need to be "
"explicitly asked for so accidental use will not create incompatibilities."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are several classes and the respective tools to manage the features:"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<at mkfs time only>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This is namely for core structures, like the b-tree nodesize or checksum "
"algorithm, see I<\\%mkfs.btrfs(8)> for more details."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<after mkfs, on an unmounted filesystem>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Features that may optimize internal structures or add new structures to "
"support new functionality, see I<\\%btrfstune(8)>\\&. The command B<btrfs "
"inspect-internal dump-super /dev/sdx> will dump a superblock, you can map "
"the value of I<incompat_flags> to the features listed below"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<after mkfs, on a mounted filesystem>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The features of a filesystem (with a given UUID) are listed in B</sys/fs/"
"btrfs/UUID/features/>, one file per feature. The status is stored inside the "
"file. The value I<1> is for enabled and active, while I<0> means the feature "
"was enabled at mount time but turned off afterwards."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Whether a particular feature can be turned on a mounted filesystem can be "
"found in the directory B</sys/fs/btrfs/features/>, one file per feature. The "
"value I<1> means the feature can be enabled."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"List of features (see also I<\\%mkfs.btrfs(8)> section \\X'tty: link #man-"
"mkfs-filesystem-features'I<\\%FILESYSTEM FEATURES>\\X'tty: link'):"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<big_metadata>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.4)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the filesystem uses I<nodesize> for metadata blocks, this can be bigger than "
"the page size"
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<block_group_tree>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 6.1)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"block group item representation using a dedicated b-tree, this can greatly "
"reduce mount time for large filesystems"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<compress_lzo>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 2.6.38)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the I<lzo> compression has been used on the filesystem, either as a mount "
"option or via B<btrfs filesystem defrag>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<compress_zstd>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 4.14)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the I<zstd> compression has been used on the filesystem, either as a mount "
"option or via B<btrfs filesystem defrag>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<default_subvol>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 2.6.34)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "the default subvolume has been set on the filesystem"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<extended_iref>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.7)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"increased hardlink limit per file in a directory to 65536, older kernels "
"supported a varying number of hardlinks depending on the sum of all file "
"name sizes that can be stored into one metadata block"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<free_space_tree>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 4.5)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"free space representation using a dedicated b-tree, successor of v1 space "
"cache"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<metadata_uuid>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 5.0)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the main filesystem UUID is the metadata_uuid, which stores the new UUID "
"only in the superblock while all metadata blocks still have the UUID set at "
"mkfs time, see I<\\%btrfstune(8)> for more"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<mixed_backref>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 2.6.31)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "the last major disk format change, improved backreferences, now default"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<mixed_groups>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 2.6.37)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"mixed data and metadata block groups, i.e. the data and metadata are not "
"separated and occupy the same block groups, this mode is suitable for small "
"volumes as there are no constraints how the remaining space should be used "
"(compared to the split mode, where empty metadata space cannot be used for "
"data and vice versa)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"on the other hand, the final layout is quite unpredictable and possibly "
"highly fragmented, which means worse performance"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<no_holes>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.14)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"improved representation of file extents where holes are not explicitly "
"stored as an extent, saves a few percent of metadata if sparse files are used"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<raid1c34>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 5.5)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "extended RAID1 mode with copies on 3 or 4 devices respectively"
msgstr ""

#. type: TP
#: archlinux fedora-rawhide opensuse-tumbleweed
#, no-wrap
msgid "B<raid_stripe_tree>"
msgstr ""

#. type: Plain text
#: archlinux fedora-rawhide opensuse-tumbleweed
msgid "(since: 6.7)"
msgstr ""

#. type: Plain text
#: archlinux fedora-rawhide opensuse-tumbleweed
msgid "a separate tree for tracking file extents on RAID profiles"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<RAID56>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.9)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "the filesystem contains or contained a RAID56 profile of block groups"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<rmdir_subvol>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 4.18)"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"indicate that \\X'tty: link https://man7.org/linux/man-pages/man2/rmdir.2."
"html'I<\\%rmdir(2)>\\X'tty: link' syscall can delete an empty subvolume just "
"like an ordinary directory. Note that this feature only depends on the "
"kernel version."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<skinny_metadata>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 3.10)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"reduced-size metadata for extent references, saves a few percent of metadata"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<send_stream_version>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 5.10)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "number of the highest supported send stream version"
msgstr ""

#. type: TP
#: archlinux fedora-rawhide opensuse-tumbleweed
#, no-wrap
msgid "B<simple_quota>"
msgstr ""

#. type: Plain text
#: archlinux fedora-rawhide opensuse-tumbleweed
msgid "simplified quota accounting"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<supported_checksums>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"list of checksum algorithms supported by the kernel module, the respective "
"modules or built-in implementing the algorithms need to be present to mount "
"the filesystem, see section I<\\%CHECKSUM ALGORITHMS>\\&."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<supported_sectorsizes>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 5.13)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"list of values that are accepted as sector sizes (B<mkfs.btrfs --"
"sectorsize>) by the running kernel"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<supported_rescue_options>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 5.11)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"list of values for the mount option I<rescue> that are supported by the "
"running kernel, see I<\\%btrfs(5)>"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<zoned>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(since: 5.12)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"zoned mode is allocation/write friendly to host-managed zoned devices, "
"allocation space is partitioned into fixed-size zones that must be updated "
"sequentially, see section I<\\%ZONED MODE>"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SWAPFILE SUPPORT"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"A swapfile, when active, is a file-backed swap area.  It is supported since "
"kernel 5.0.  Use \\X'tty: link https://man7.org/linux/man-pages/man8/"
"swapon.8.html'I<\\%swapon(8)>\\X'tty: link' to activate it, until then "
"(respectively again after deactivating it with \\X'tty: link https://man7."
"org/linux/man-pages/man8/swapoff.8.html'I<\\%swapoff(8)>\\X'tty: link') "
"it\\(aqs just a normal file (with NODATACOW set), for which the special "
"restrictions for active swapfiles don\\(aqt apply."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are some limitations of the implementation in BTRFS and Linux swap "
"subsystem:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "filesystem - must be only single device"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "filesystem - must have only I<single> data profile"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "subvolume - cannot be snapshotted if it contains any active swapfiles"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "swapfile - must be preallocated (i.e. no holes)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "swapfile - must be NODATACOW (i.e. also NODATASUM, no compression)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The limitations come namely from the COW-based design and mapping layer of "
"blocks that allows the advanced features like relocation and multi-device "
"filesystems. However, the swap subsystem expects simpler mapping and no "
"background changes of the file block location once they\\(aqve been assigned "
"to swap."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"With active swapfiles, the following whole-filesystem operations will skip "
"swapfile extents or may fail:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"balance - block groups with extents of any active swapfiles are skipped and "
"reported, the rest will be processed normally"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "resize grow - unaffected"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"resize shrink - works as long as the extents of any active swapfiles are "
"outside of the shrunk range"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"device add - if the new devices do not interfere with any already active "
"swapfiles this operation will work, though no new swapfile can be activated "
"afterwards"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"device delete - if the device has been added as above, it can be also deleted"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "device replace - ditto"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When there are no active swapfiles and a whole-filesystem exclusive "
"operation is running (e.g. balance, device delete, shrink), the swapfiles "
"cannot be temporarily activated. The operation must finish first."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "To create and activate a swapfile run the following commands:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# truncate -s 0 swapfile\n"
"# chattr +C swapfile\n"
"# fallocate -l 2G swapfile\n"
"# chmod 0600 swapfile\n"
"# mkswap swapfile\n"
"# swapon swapfile\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Since version 6.1 it\\(aqs possible to create the swapfile in a single "
"command (except the activation):"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# btrfs filesystem mkswapfile --size 2G swapfile\n"
"# swapon swapfile\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Please note that the UUID returned by the I<mkswap> utility identifies the "
"swap \"filesystem\" and because it\\(aqs stored in a file, it\\(aqs not "
"generally visible and usable as an identifier unlike if it was on a block "
"device."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Once activated the file will appear in B</proc/swaps>:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# cat /proc/swaps\n"
"Filename          Type          Size           Used      Priority\n"
"/path/swapfile    file          2097152        0         -2\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The swapfile can be created as one-time operation or, once properly created, "
"activated on each boot by the B<swapon -a> command (usually started by the "
"service manager). Add the following entry to I</etc/fstab>, assuming the "
"filesystem that provides the I</path> has been already mounted at this "
"point.  Additional mount options relevant for the swapfile can be set too "
"(like priority, not the BTRFS mount options)."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "/path/swapfile        none        swap        defaults      0 0\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"From now on the subvolume with the active swapfile cannot be snapshotted "
"until the swapfile is deactivated again by B<swapoff>\\&. Then the swapfile "
"is a regular file and the subvolume can be snapshotted again, though this "
"would prevent another activation any swapfile that has been snapshotted. New "
"swapfiles (not snapshotted) can be created and activated."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Otherwise, an inactive swapfile does not affect the containing subvolume. "
"Activation creates a temporary in-memory status and prevents some file "
"operations, but is not stored permanently."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "HIBERNATION"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A swapfile can be used for hibernation but it\\(aqs not straightforward. "
"Before hibernation a resume offset must be written to file I</sys/power/"
"resume_offset> or the kernel command line parameter I<resume_offset> must be "
"set."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The value is the physical offset on the device. Note that B<this is not the "
"same value that> B<filefrag> B<prints as physical offset!>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Btrfs filesystem uses mapping between logical and physical addresses but "
"here the physical can still map to one or more device-specific physical "
"block addresses. It\\(aqs the device-specific physical offset that is "
"suitable as resume offset."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Since version 6.1 there\\(aqs a command \\X'tty: link #man-inspect-map-"
"swapfile'I<\\%btrfs inspect-internal map-swapfile>\\X'tty: link' that will "
"print the device physical offset and the adjusted value for B</sys/power/"
"resume_offset>\\&.  Note that the value is divided by page size, i.e.  "
"it\\(aqs not the offset itself."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# btrfs filesystem mkswapfile swapfile\n"
"# btrfs inspect-internal map-swapfile swapfile\n"
"Physical start: 811511726080\n"
"Resume offset:     198122980\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"For scripting and convenience the option I<-r> will print just the offset:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# btrfs inspect-internal map-swapfile -r swapfile\n"
"198122980\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The command B<map-swapfile> also verifies all the requirements, i.e. no "
"holes, single device, etc."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "TROUBLESHOOTING"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If the swapfile activation fails please verify that you followed all the "
"steps above or check the system log (e.g. B<dmesg> or B<journalctl>) for "
"more information."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Notably, the B<swapon> utility exits with a message that does not say what "
"failed:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# swapon /path/swapfile\n"
"swapon: /path/swapfile: swapon failed: Invalid argument\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The specific reason is likely to be printed to the system log by the btrfs "
"module:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# journalctl -t kernel | grep swapfile\n"
"kernel: BTRFS warning (device sda): swapfile must have single data profile\n"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "CHECKSUM ALGORITHMS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Data and metadata are checksummed by default, the checksum is calculated "
"before write and verified after reading the blocks from devices. The whole "
"metadata block has a checksum stored inline in the b-tree node header, each "
"data block has a detached checksum stored in the checksum tree."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are several checksum algorithms supported. The default and backward "
"compatible is I<crc32c>\\&.  Since kernel 5.5 there are three more with "
"different characteristics and trade-offs regarding speed and strength. The "
"following list may help you to decide which one to select."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<CRC32C (32bit digest)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"default, best backward compatibility, very fast, modern CPUs have "
"instruction-level support, not collision-resistant but still good error "
"detection capabilities"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<XXHASH (64bit digest)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"can be used as CRC32C successor, very fast, optimized for modern CPUs "
"utilizing instruction pipelining, good collision resistance and error "
"detection"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<SHA256 (256bit digest)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"a cryptographic-strength hash, relatively slow but with possible CPU "
"instruction acceleration or specialized hardware cards, FIPS certified and "
"in wide use"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<BLAKE2b (256bit digest)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"a cryptographic-strength hash, relatively fast with possible CPU "
"acceleration using SIMD extensions, not standardized but based on BLAKE "
"which was a SHA3 finalist, in wide use, the algorithm used is BLAKE2b-256 "
"that\\(aqs optimized for 64bit platforms"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<digest size> affects overall size of data block checksums stored in "
"the filesystem.  The metadata blocks have a fixed area up to 256 bits (32 "
"bytes), so there\\(aqs no increase. Each data block has a separate checksum "
"stored, with additional overhead of the b-tree leaves."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
msgid ""
"Approximate relative performance of the algorithms, measured against CRC32C "
"using implementations on a 11th gen 3.6GHz intel CPU:"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Digest"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Cycles/4KiB"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Ratio"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Implementation"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "_"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "CRC32C"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "470"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "1.00"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "CPU instruction, PCL combination"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "XXHASH"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "870"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "1.9"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "reference impl."
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SHA256"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "7600"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "16"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "libgcrypt"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "8500"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "18"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "openssl"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "8700"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "botan"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "32000"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "68"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "builtin, CPU instruction"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "37000"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "78"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "libsodium"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "78000"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "166"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "builtin, reference impl."
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "BLAKE2b"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "10000"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "21"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "builtin/AVX2"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "10900"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "23"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "13500"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "29"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "builtin/SSE41"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "13700"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "14100"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "30"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "14500"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "31"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "kcapi"
msgstr ""

#. type: tbl table
#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
#, no-wrap
msgid "34"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Many kernels are configured with SHA256 as built-in and not as a module.  "
"The accelerated versions are however provided by the modules and must be "
"loaded explicitly (B<modprobe sha256>) before mounting the filesystem to "
"make use of them. You can check in B</sys/fs/btrfs/FSID/checksum> which one "
"is used. If you see I<sha256-generic>, then you may want to unmount and "
"mount the filesystem again, changing that on a mounted filesystem is not "
"possible.  Check the file B</proc/crypto>, when the implementation is built-"
"in, you\\(aqd find"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"name         : sha256\n"
"driver       : sha256-generic\n"
"module       : kernel\n"
"priority     : 100\n"
"\\&...\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "while accelerated implementation is e.g."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"name         : sha256\n"
"driver       : sha256-avx2\n"
"module       : sha256_ssse3\n"
"priority     : 170\n"
"\\&...\n"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "COMPRESSION"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Btrfs supports transparent file compression. There are three algorithms "
"available: ZLIB, LZO and ZSTD (since v4.14), with various levels.  The "
"compression happens on the level of file extents and the algorithm is "
"selected by file property, mount option or by a defrag command.  You can "
"have a single btrfs mount point that has some files that are uncompressed, "
"some that are compressed with LZO, some with ZLIB, for instance (though you "
"may not want it that way, it is supported)."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Once the compression is set, all newly written data will be compressed, i."
"e.  existing data are untouched. Data are split into smaller chunks (128KiB) "
"before compression to make random rewrites possible without a high "
"performance hit. Due to the increased number of extents the metadata "
"consumption is higher. The chunks are compressed in parallel."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The algorithms can be characterized as follows regarding the speed/ratio "
"trade-offs:"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<ZLIB>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "slower, higher compression ratio"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "levels: 1 to 9, mapped directly, default level is 3"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "good backward compatibility"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<LZO>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"faster compression and decompression than ZLIB, worse compression ratio, "
"designed to be fast"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "no levels"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<ZSTD>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"compression comparable to ZLIB with higher compression/decompression speeds "
"and different ratio"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "levels: 1 to 15, mapped directly (higher levels are not available)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "since 4.14, levels since 5.1"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The differences depend on the actual data set and cannot be expressed by a "
"single number or recommendation. Higher levels consume more CPU time and may "
"not bring a significant improvement, lower levels are close to real time."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "HOW TO ENABLE COMPRESSION"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Typically the compression can be enabled on the whole filesystem, specified "
"for the mount point. Note that the compression mount options are shared "
"among all mounts of the same filesystem, either bind mounts or subvolume "
"mounts.  Please refer to I<\\%btrfs(5)> section I<\\%MOUNT OPTIONS>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "$ mount -o compress=zstd /dev/sdx /mnt\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This will enable the B<zstd> algorithm on the default level (which is 3).  "
"The level can be specified manually too like B<zstd:3>\\&. Higher levels "
"compress better at the cost of time. This in turn may cause increased write "
"latency, low levels are suitable for real-time compression and on reasonably "
"fast CPU don\\(aqt cause noticeable performance drops."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "$ btrfs filesystem defrag -czstd file\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The command above will start defragmentation of the whole I<file> and apply "
"the compression, regardless of the mount option. (Note: specifying level is "
"not yet implemented). The compression algorithm is not persistent and "
"applies only to the defragmentation command, for any other writes other "
"compression settings apply."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Persistent settings on a per-file basis can be set in two ways:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"$ chattr +c file\n"
"$ btrfs property set file compression zstd\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The first command is using legacy interface of file attributes inherited "
"from ext2 filesystem and is not flexible, so by default the I<zlib> "
"compression is set. The other command sets a property on the file with the "
"given algorithm.  (Note: setting level that way is not yet implemented.)"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "COMPRESSION LEVELS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The level support of ZLIB has been added in v4.14, LZO does not support "
"levels (the kernel implementation provides only one), ZSTD level support has "
"been added in v5.1."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are 9 levels of ZLIB supported (1 to 9), mapping 1:1 from the mount "
"option to the algorithm defined level. The default is level 3, which "
"provides the reasonably good compression ratio and is still reasonably fast. "
"The difference in compression gain of levels 7, 8 and 9 is comparable but "
"the higher levels take longer."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The ZSTD support includes levels 1 to 15, a subset of full range of what "
"ZSTD provides. Levels 1-3 are real-time, 4-8 slower with improved "
"compression and 9-15 try even harder though the resulting size may not be "
"significantly improved."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Level 0 always maps to the default. The compression level does not affect "
"compatibility."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "INCOMPRESSIBLE DATA"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Files with already compressed data or with data that won\\(aqt compress well "
"with the CPU and memory constraints of the kernel implementations are using "
"a simple decision logic. If the first portion of data being compressed is "
"not smaller than the original, the compression of the file is disabled -- "
"unless the filesystem is mounted with I<compress-force>\\&. In that case "
"compression will always be attempted on the file only to be later discarded. "
"This is not optimal and subject to optimizations and further development."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If a file is identified as incompressible, a flag is set (I<NOCOMPRESS>) and "
"it\\(aqs sticky. On that file compression won\\(aqt be performed unless "
"forced. The flag can be also set by B<chattr +m> (since e2fsprogs 1.46.2) or "
"by properties with value I<no> or I<none>\\&. Empty value will reset it to "
"the default that\\(aqs currently applicable on the mounted filesystem."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "There are two ways to detect incompressible data:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"actual compression attempt - data are compressed, if the result is not "
"smaller, it\\(aqs discarded, so this depends on the algorithm and level"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"pre-compression heuristics - a quick statistical evaluation on the data is "
"performed and based on the result either compression is performed or "
"skipped, the NOCOMPRESS bit is not set just by the heuristic, only if the "
"compression algorithm does not make an improvement"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"$ lsattr file\n"
"---------------------m file\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Using the forcing compression is not recommended, the heuristics are "
"supposed to decide that and compression algorithms internally detect "
"incompressible data too."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "PRE-COMPRESSION HEURISTICS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The heuristics aim to do a few quick statistical tests on the compressed "
"data in order to avoid probably costly compression that would turn out to be "
"inefficient. Compression algorithms could have internal detection of "
"incompressible data too but this leads to more overhead as the compression "
"is done in another thread and has to write the data anyway. The heuristic is "
"read-only and can utilize cached memory."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The tests performed based on the following: data sampling, long repeated "
"pattern detection, byte frequency, Shannon entropy."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "COMPATIBILITY"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"Compression is done using the COW mechanism so it\\(aqs incompatible with "
"I<nodatacow>\\&. Direct IO read works on compressed files but will fall back "
"to buffered writes and leads to no compression even if force compression is "
"set.  Currently I<nodatasum> and compression don\\(aqt work together."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The compression algorithms have been added over time so the version "
"compatibility should be also considered, together with other tools that may "
"access the compressed data like bootloaders."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SYSFS INTERFACE"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Btrfs has a sysfs interface to provide extra knobs."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The top level path is B</sys/fs/btrfs/>, and the main directory layout is "
"the following:"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Relative Path"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Description"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Version"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "features/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "All supported features"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "3.14+"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Mounted fs UUID"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/allocation/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Space allocation info"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/features/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Features of the filesystem"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/devices/E<lt>DEVIDE<gt>/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Symlink to each block device sysfs"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "5.6+"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/devinfo/E<lt>DEVIDE<gt>/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Btrfs specific info for each device"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/qgroups/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Global qgroup info"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "5.9+"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/qgroups/E<lt>LEVELE<gt>_E<lt>IDE<gt>/"
msgstr ""

#. type: tbl table
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Info for each qgroup"
msgstr ""

#. type: tbl table
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "E<lt>UUIDE<gt>/discard/"
msgstr ""

#. type: tbl table
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Discard stats and tunables"
msgstr ""

#. type: tbl table
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "6.1+"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"For B</sys/fs/btrfs/features/> directory, each file means a supported "
"feature for the current kernel."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"For B</sys/fs/btrfs/E<lt>UUIDE<gt>/features/> directory, each file means an "
"enabled feature for the mounted filesystem."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The features shares the same name in section I<\\%FILESYSTEM FEATURES>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Files in B</sys/fs/btrfs/E<lt>UUIDE<gt>/> directory are:"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<bg_reclaim_threshold>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RW, since: 5.19)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Used space percentage of total device space to start auto block group "
"claim.  Mostly for zoned devices."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<checksum>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.5)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The checksum used for the mounted filesystem.  This includes both the "
"checksum type (see section I<\\%CHECKSUM ALGORITHMS>)  and the implemented "
"driver (mostly shows if it\\(aqs hardware accelerated)."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<clone_alignment>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 3.16)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The bytes alignment for I<clone> and I<dedupe> ioctls."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<commit_stats>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RW, since: 6.0)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The performance statistics for btrfs transaction commit.  Mostly for debug "
"purposes."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Writing into this file will reset the maximum commit duration to the input "
"value."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<exclusive_operation>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.10)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the running exclusive operation.  Check section I<\\%FILESYSTEM "
"EXCLUSIVE OPERATIONS> for details."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<generation>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.11)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Show the generation of the mounted filesystem."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<label>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RW, since: 3.14)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Show the current label of the mounted filesystem."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.0)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the metadata uuid of the mounted filesystem.  Check I<metadata_uuid> "
"feature for more details."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<nodesize>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 3.14)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Show the nodesize of the mounted filesystem."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<quota_override>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RW, since: 4.13)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the current quota override status.  0 means no quota override.  1 "
"means quota override, quota can ignore the existing limit settings."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<read_policy>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RW, since: 5.11)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the current balance policy for reads.  Currently only \"pid\" (balance "
"using pid value) is supported."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<sectorsize>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the sectorsize of the mounted filesystem."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Files and directories in B</sys/fs/btrfs/E<lt>UUIDE<gt>/allocations> "
"directory are:"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<global_rsv_reserved>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The used bytes of the global reservation."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<global_rsv_size>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The total size of the global reservation."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "I<data/>B<, >I<metadata/>B< and >I<system/>B< directories>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.14)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Space info accounting for the 3 chunk types.  Mostly for debug purposes."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Files in B</sys/fs/btrfs/E<lt>UUIDE<gt>/allocations/>I<data,metadata,system> "
"directory are:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Reclaimable space percentage of block group\\(aqs size (excluding "
"permanently unusable space) to reclaim the block group.  Can be used on "
"regular or zoned devices."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<chunk_size>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the chunk size. Can be changed for data and metadata.  Cannot be set "
"for zoned devices."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Files in B</sys/fs/btrfs/E<lt>UUIDE<gt>/devinfo/E<lt>DEVIDE<gt>> directory "
"are:"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<error_stats:>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows all the history error numbers of the device."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<fsid:>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.17)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the fsid which the device belongs to.  It can be different than the "
"I<E<lt>UUIDE<gt>> if it\\(aqs a seed device."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<in_fs_metadata>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.6)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows whether we have found the device.  Should always be 1, as if this "
"turns to 0, the I<E<lt>DEVIDE<gt>> directory would get removed automatically."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<missing>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows whether the device is missing."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<replace_target>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows whether the device is the replace target.  If no dev-replace is "
"running, this value should be 0."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<scrub_speed_max>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RW, since: 5.14)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the scrub speed limit for this device. The unit is Bytes/s.  0 means "
"no limit."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<writeable>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Show if the device is writeable."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Files in B</sys/fs/btrfs/E<lt>UUIDE<gt>/qgroups/> directory are:"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<enabled>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 6.1)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows if qgroup is enabled.  Also, if qgroup is disabled, the I<qgroups> "
"directory would be removed automatically."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<inconsistent>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows if the qgroup numbers are inconsistent.  If 1, it\\(aqs recommended to "
"do a qgroup rescan."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<drop_subtree_threshold>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RW, since: 6.1)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the subtree drop threshold to automatically mark qgroup inconsistent."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When dropping large subvolumes with qgroup enabled, there would be a huge "
"load for qgroup accounting.  If we have a subtree whose level is larger than "
"or equal to this value, we will not trigger qgroup account at all, but mark "
"qgroup inconsistent to avoid the huge workload."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Default value is 8, where no subtree drop can trigger qgroup."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Lower value can reduce qgroup workload, at the cost of extra qgroup rescan "
"to re-calculate the numbers."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Files in B</sys/fs/btrfs/E<lt>UUIDE<gt>/E<lt>LEVELE<gt>_E<lt>IDE<gt>/> "
"directory are:"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<exclusive>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "(RO, since: 5.9)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the exclusively owned bytes of the qgroup."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<limit_flags>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the numeric value of the limit flags.  If 0, means no limit implied."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<max_exclusive>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the limits on exclusively owned bytes."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<max_referenced>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the limits on referenced bytes."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<referenced>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the referenced bytes of the qgroup."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<rsv_data>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the reserved bytes for data."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<rsv_meta_pertrans>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the reserved bytes for per transaction metadata."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<rsv_meta_prealloc>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows the reserved bytes for preallocated metadata."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Files in B</sys/fs/btrfs/E<lt>UUIDE<gt>/discard/> directory are:"
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<discardable_bytes>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows amount of bytes that can be discarded in the async discard and "
"nodiscard mode."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<discardable_extents>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows number of extents to be discarded in the async discard and nodiscard "
"mode."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<discard_bitmap_bytes>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows amount of discarded bytes from data tracked as bitmaps."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<discard_extent_bytes>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Shows amount of discarded extents from data tracked as bitmaps."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<discard_bytes_saved>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Shows the amount of bytes that were reallocated without being discarded."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<kbps_limit>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Tunable limit of kilobytes per second issued as discard IO in the async "
"discard mode."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<iops_limit>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Tunable limit of number of discard IO operations to be issued in the async "
"discard mode."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<max_discard_size>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Tunable limit for size of one IO discard request."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "FILESYSTEM EXCLUSIVE OPERATIONS"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are several operations that affect the whole filesystem and cannot be "
"run in parallel. Attempt to start one while another is running will fail "
"(see exceptions below)."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Since kernel 5.10 the currently running operation can be obtained from B</"
"sys/fs/UUID/exclusive_operation> with following values and operations:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "balance"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "balance paused (since 5.17)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "device add"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "device delete"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "device replace"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "resize"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "swapfile activate"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "none"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Enqueuing is supported for several btrfs subcommands so they can be started "
"at once and then serialized."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There\\(aqs an exception when a paused balance allows to start a device add "
"operation as they don\\(aqt really collide and this can be used to add more "
"space for the balance to finish."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "FILESYSTEM LIMITS"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<maximum file name length>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "255"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This limit is imposed by Linux VFS, the structures of BTRFS could store "
"larger file names."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<maximum symlink target length>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"depends on the I<nodesize> value, for 4KiB it\\(aqs 3949 bytes, for larger "
"nodesize it\\(aqs 4095 due to the system limit PATH_MAX"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"The symlink target may not be a valid path, i.e. the path name components "
"can exceed the limits (NAME_MAX), there\\(aqs no content validation at "
"\\X'tty: link https://man7.org/linux/man-pages/man3/symlink.3.html'I<\\"
"%symlink(3)>\\X'tty: link' creation."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<maximum number of inodes>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"2\\s-2\\u64\\d\\s0 but depends on the available metadata space as the inodes "
"are created dynamically"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Each subvolume is an independent namespace of inodes and thus their numbers, "
"so the limit is per subvolume, not for the whole filesystem."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<inode numbers>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"minimum number: 256 (for subvolumes), regular files and directories: 257, "
"maximum number: (2\\s-2\\u64\\d\\s0 - 256)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The inode numbers that can be assigned to user created files are from the "
"whole 64bit space except first 256 and last 256 in that range that are "
"reserved for internal b-tree identifiers."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<maximum file length>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"inherent limit of BTRFS is 2\\s-2\\u64\\d\\s0 (16 EiB) but the practical "
"limit of Linux VFS is 2\\s-2\\u63\\d\\s0 (8 EiB)"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<maximum number of subvolumes>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the subvolume ids can go up to 2\\s-2\\u48\\d\\s0 but the number of actual "
"subvolumes depends on the available metadata space"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The space consumed by all subvolume metadata includes bookkeeping of shared "
"extents can be large (MiB, GiB). The range is not the full 64bit range "
"because of qgroups that use the upper 16 bits for another purposes."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<maximum number of hardlinks of a file in a directory>"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"65536 when the I<extref> feature is turned on during mkfs (default), roughly "
"100 otherwise and depends on file name length that fits into one metadata "
"node"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<minimum filesystem size>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the minimal size of each device depends on the I<mixed-bg> feature, without "
"that (the default) it\\(aqs about 109MiB, with mixed-bg it\\(aqs is 16MiB"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "BOOTLOADER SUPPORT"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"GRUB2 (\\X'tty: link https://www.gnu.org/software/grub'I<\\%https://www.gnu."
"org/software/grub>\\X'tty: link') has the most advanced support of booting "
"from BTRFS with respect to features."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"U-Boot (\\X'tty: link https://www.denx.de/wiki/U-Boot/'I<\\%https://www.denx."
"de/wiki/U-Boot/>\\X'tty: link') has decent support for booting but not all "
"BTRFS features are implemented, check the documentation."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In general, the first 1MiB on each device is unused with the exception of "
"primary superblock that is on the offset 64KiB and spans 4KiB. The rest can "
"be freely used by bootloaders or for other system information. Note that "
"booting from a filesystem on I<\\%zoned device> is not supported."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "FILE ATTRIBUTES"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The btrfs filesystem supports setting file attributes or flags. Note there "
"are old and new interfaces, with confusing names. The following list should "
"clarify that:"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"I<attributes>: \\X'tty: link https://man7.org/linux/man-pages/man1/chattr.1."
"html'I<\\%chattr(1)>\\X'tty: link' or \\X'tty: link https://man7.org/linux/"
"man-pages/man1/lsattr.1.html'I<\\%lsattr(1)>\\X'tty: link' utilities (the "
"ioctls are FS_IOC_GETFLAGS and FS_IOC_SETFLAGS), due to the ioctl names the "
"attributes are also called flags"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"I<xflags>: to distinguish from the previous, it\\(aqs extended flags, with "
"tunable bits similar to the attributes but extensible and new bits will be "
"added in the future (the ioctls are FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR "
"but they are not related to extended attributes that are also called "
"xattrs), there\\(aqs no standard tool to change the bits, there\\(aqs "
"support in \\X'tty: link https://man7.org/linux/man-pages/man8/xfs_io.8."
"html'I<\\%xfs_io(8)>\\X'tty: link' as command B<xfs_io -c chattr>"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Attributes"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<a>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<append only>, new writes are always written at the end of the file"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<A>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<no atime updates>"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<c>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<compress data>, all data written after this attribute is set will be "
"compressed.  Please note that compression is also affected by the mount "
"options or the parent directory attributes."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When set on a directory, all newly created files will inherit this "
"attribute.  This attribute cannot be set with \\(aqm\\(aq at the same time."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<C>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<no copy-on-write>, file data modifications are done in-place"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When set on a directory, all newly created files will inherit this attribute."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Due to implementation limitations, this flag can be set/unset only on empty "
"files."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<d>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"I<no dump>, makes sense with 3rd party tools like \\X'tty: link https://man7."
"org/linux/man-pages/man8/dump.8.html'I<\\%dump(8)>\\X'tty: link', on BTRFS "
"the attribute can be set/unset but no other special handling is done"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<D>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"I<synchronous directory updates>, for more details search \\X'tty: link "
"https://man7.org/linux/man-pages/man2/open.2.html'I<\\%open(2)>\\X'tty: "
"link' for I<O_SYNC> and I<O_DSYNC>"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<i>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<immutable>, no file data and metadata changes allowed even to the root "
"user as long as this attribute is set (obviously the exception is unsetting "
"the attribute)"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<m>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"I<no compression>, permanently turn off compression on the given file. Any "
"compression mount options will not affect this file. (\\X'tty: link https://"
"man7.org/linux/man-pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: link' "
"support added in 1.46.2)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When set on a directory, all newly created files will inherit this "
"attribute.  This attribute cannot be set with I<c> at the same time."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<S>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"I<synchronous updates>, for more details search \\X'tty: link https://man7."
"org/linux/man-pages/man2/open.2.html'I<\\%open(2)>\\X'tty: link' for "
"I<O_SYNC> and I<O_DSYNC>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"No other attributes are supported.  For the complete list please refer to "
"the \\X'tty: link https://man7.org/linux/man-pages/man1/chattr.1.html'I<\\"
"%chattr(1)>\\X'tty: link' manual page."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "XFLAGS"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"There\\(aqs an overlap of letters assigned to the bits with the attributes, "
"this list refers to what \\X'tty: link https://man7.org/linux/man-pages/man8/"
"xfs_io.8.html'I<\\%xfs_io(8)>\\X'tty: link' provides:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<immutable>, same as the attribute"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<append only>, same as the attribute"
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<s>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<synchronous updates>, same as the attribute I<S>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<no atime updates>, same as the attribute"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<no dump>, same as the attribute"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "ZONED MODE"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Since version 5.12 btrfs supports so called I<zoned mode>\\&. This is a "
"special on-disk format and allocation/write strategy that\\(aqs friendly to "
"zoned devices.  In short, a device is partitioned into fixed-size zones and "
"each zone can be updated by append-only manner, or reset. As btrfs has no "
"fixed data structures, except the super blocks, the zoned mode only requires "
"block placement that follows the device constraints. You can learn about the "
"whole architecture at \\X'tty: link https://zonedstorage.io'I<\\%https://"
"zonedstorage.io>\\X'tty: link' ."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The devices are also called SMR/ZBC/ZNS, in I<host-managed> mode. Note that "
"there are devices that appear as non-zoned but actually are, this is I<drive-"
"managed> and using zoned mode won\\(aqt help."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The zone size depends on the device, typical sizes are 256MiB or 1GiB. In "
"general it must be a power of two. Emulated zoned devices like I<null_blk> "
"allow to set various zone sizes."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Requirements, limitations"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "all devices must have the same zone size"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "maximum zone size is 8GiB"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "minimum zone size is 4MiB"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"mixing zoned and non-zoned devices is possible, the zone writes are "
"emulated, but this is namely for testing"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the super block is handled in a special way and is at different locations "
"than on a non-zoned filesystem:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "primary: 0B (and the next two zones)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "secondary: 512GiB (and the next two zones)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "tertiary: 4TiB (4096GiB, and the next two zones)"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Incompatible features"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The main constraint of the zoned devices is lack of in-place update of the "
"data.  This is inherently incompatible with some features:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "NODATACOW - overwrite in-place, cannot create such files"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "fallocate - preallocating space for in-place first write"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"mixed-bg - unordered writes to data and metadata, fixing that means using "
"separate data and metadata block groups"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"booting - the zone at offset 0 contains superblock, resetting the zone would "
"destroy the bootloader data"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Initial support lacks some features but they\\(aqre planned:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "only single (data, metadata) and DUP (metadata) profile is supported"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "fstrim - due to dependency on free space cache v1"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Super block"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"As said above, super block is handled in a special way. In order to be crash "
"safe, at least one zone in a known location must contain a valid "
"superblock.  This is implemented as a ring buffer in two consecutive zones, "
"starting from known offsets 0B, 512GiB and 4TiB."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The values are different than on non-zoned devices. Each new super block is "
"appended to the end of the zone, once it\\(aqs filled, the zone is reset and "
"writes continue to the next one. Looking up the latest super block needs to "
"read offsets of both zones and determine the last written version."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The amount of space reserved for super block depends on the zone size. The "
"secondary and tertiary copies are at distant offsets as the capacity of the "
"devices is expected to be large, tens of terabytes. Maximum zone size "
"supported is 8GiB, which would mean that e.g. offset 0-16GiB would be "
"reserved just for the super block on a hypothetical device of that zone "
"size. This is wasteful but required to guarantee crash safety."
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Devices"
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Real hardware"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The WD Ultrastar series 600 advertises HM-SMR, i.e. the host-managed zoned "
"mode. There are two more: DA (device managed, no zoned information exported "
"to the system), HA (host aware, can be used as regular disk but zoned writes "
"improve performance). There are not many devices available at the moment, "
"the information about exact zoned mode is hard to find, check data sheets or "
"community sources gathering information from real devices."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Note: zoned mode won\\(aqt work with DM-SMR disks."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"Ultrastar® DC ZN540 NVMe ZNS SSD (\\X'tty: link https://documents."
"westerndigital.com/content/dam/doc-library/en_us/assets/public/western-"
"digital/collateral/product-brief/product-brief-ultrastar-dc-zn540.pdf'I<\\"
"%product brief>\\X'tty: link')"
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Emulated: null_blk"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The driver I<null_blk> provides memory backed device and is suitable for "
"testing. There are some quirks setting up the devices. The module must be "
"loaded with I<nr_devices=0> or the numbering of device nodes will be offset. "
"The I<configfs> must be mounted at I</sys/kernel/config> and the "
"administration of the null_blk devices is done in I</sys/kernel/config/"
"nullb>\\&. The device nodes are named like B</dev/nullb0> and are numbered "
"sequentially. NOTE: the device name may be different than the named "
"directory in sysfs!"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Setup:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"modprobe\\ configfs\n"
"modprobe\\ null_blk\\ nr_devices=0\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Create a device I<mydev>, assuming no other previously created devices, size "
"is 2048MiB, zone size 256MiB. There are more tunable parameters, this is a "
"minimal example taking defaults:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"cd\\ /sys/kernel/config/nullb/\n"
"mkdir\\ mydev\n"
"cd\\ mydev\n"
"echo\\ 2048\\ E<gt>\\ size\n"
"echo\\ 1\\ E<gt>\\ zoned\n"
"echo\\ 1\\ E<gt>\\ memory_backed\n"
"echo\\ 256\\ E<gt>\\ zone_size\n"
"echo\\ 1\\ E<gt>\\ power\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This will create a device B</dev/nullb0> and the value of file I<index> will "
"match the ending number of the device node."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Remove the device:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "rmdir\\ /sys/kernel/config/nullb/mydev\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Then continue with B<mkfs.btrfs /dev/nullb0>, the zoned mode is auto-"
"detected."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"For convenience, there\\(aqs a script wrapping the basic null_blk management "
"operations \\X'tty: link https://github.com/kdave/nullb.git'I<\\%https://"
"github.com/kdave/nullb.git>\\X'tty: link', the above commands become:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"nullb setup\n"
"nullb create -s 2g -z 256\n"
"mkfs.btrfs /dev/nullb0\n"
"\\&...\n"
"nullb rm nullb0\n"
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Emulated: TCMU runner"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"TCMU is a framework to emulate SCSI devices in userspace, providing various "
"backends for the storage, with zoned support as well. A file-backed zoned "
"device can provide more options for larger storage and zone size. Please "
"follow the instructions at \\X'tty: link https://zonedstorage.io/projects/"
"tcmu-runner/'I<\\%https://zonedstorage.io/projects/tcmu-runner/>\\X'tty: "
"link' ."
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Compatibility, incompatibility"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the feature sets an incompat bit and requires new kernel to access the "
"filesystem (for both read and write)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"superblock needs to be handled in a special way, there are still 3 copies "
"but at different offsets (0, 512GiB, 4TiB) and the 2 consecutive zones are a "
"ring buffer of the superblocks, finding the latest one needs reading it from "
"the write pointer or do a full scan of the zones"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"mixing zoned and non zoned devices is possible (zones are emulated) but is "
"recommended only for testing"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "mixing zoned devices with different zone sizes is not possible"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"zone sizes must be power of two, zone sizes of real devices are e.g. 256MiB "
"or 1GiB, larger size is expected, maximum zone size supported by btrfs is "
"8GiB"
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Status, stability, reporting bugs"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"The zoned mode has been released in 5.12 and there are still some rough "
"edges and corner cases one can hit during testing. Please report bugs to "
"\\X'tty: link https://github.com/naota/linux/issues/'I<\\%https://github.com/"
"naota/linux/issues/>\\X'tty: link' ."
msgstr ""

#. type: SS
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "References"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://zonedstorage.io'I<\\%https://zonedstorage.io>\\X'tty: "
"link'"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://zonedstorage.io/projects/libzbc/'I<\\%https://"
"zonedstorage.io/projects/libzbc/>\\X'tty: link' -- I<libzbc> is library and "
"set of tools to directly manipulate devices with ZBC/ZAC support"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://zonedstorage.io/projects/libzbd/'I<\\%https://"
"zonedstorage.io/projects/libzbd/>\\X'tty: link' -- I<libzbd> uses the kernel "
"provided zoned block device interface based on the ioctl() system calls"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://hddscan.com/blog/2020/hdd-wd-smr.html'I<\\%https://"
"hddscan.com/blog/2020/hdd-wd-smr.html>\\X'tty: link' -- some details about "
"exact device types"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://lwn.net/Articles/853308/'I<\\%https://lwn.net/"
"Articles/853308/>\\X'tty: link' -- I<Btrfs on zoned block devices>"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://www.usenix.org/conference/vault20/presentation/"
"bjorling'I<\\%https://www.usenix.org/conference/vault20/presentation/"
"bjorling>\\X'tty: link' -- Zone Append: A New Way of Writing to Zoned Storage"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "CONTROL DEVICE"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There\\(aqs a character special device B</dev/btrfs-control> with major and "
"minor numbers 10 and 234 (the device can be found under the I<misc> "
"category)."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"$ ls -l /dev/btrfs-control\n"
"crw------- 1 root root 10, 234 Jan  1 12:00 /dev/btrfs-control\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The device accepts some ioctl calls that can perform following actions on "
"the filesystem module:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"scan devices for btrfs filesystem (i.e. to let multi-device filesystems "
"mount automatically) and register them with the kernel module"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"similar to scan, but also wait until the device scanning process is finished "
"for a given filesystem"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"get the supported features (can be also found under B</sys/fs/btrfs/"
"features>)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The device is created when btrfs is initialized, either as a module or a "
"built-in functionality and makes sense only in connection with that. Running "
"e.g. mkfs without the module loaded will not register the device and will "
"probably warn about that."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In rare cases when the module is loaded but the device is not present (most "
"likely accidentally deleted), it\\(aqs possible to recreate it by"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "# mknod --mode=600 /dev/btrfs-control c 10 234\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "or (since 5.11) by a convenience command"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "# btrfs rescue create-control-device\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The control device is not strictly required but the device scanning will not "
"work and a workaround would need to be used to mount a multi-device "
"filesystem.  The mount option I<device> can trigger the device scanning "
"during mount, see also B<btrfs device scan>\\&."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "FILESYSTEM WITH MULTIPLE PROFILES"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"It is possible that a btrfs filesystem contains multiple block group "
"profiles of the same type.  This could happen when a profile conversion "
"using balance filters is interrupted (see I<\\%btrfs-balance(8)>).  Some "
"B<btrfs> commands perform a test to detect this kind of condition and print "
"a warning like this:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"WARNING: Multiple block group profiles detected, see \\(aqman btrfs(5)\\(aq.\n"
"WARNING:   Data: single, raid1\n"
"WARNING:   Metadata: single, raid1\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The corresponding output of B<btrfs filesystem df> might look like:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"WARNING: Multiple block group profiles detected, see \\(aqman btrfs(5)\\(aq.\n"
"WARNING:   Data: single, raid1\n"
"WARNING:   Metadata: single, raid1\n"
"Data, RAID1: total=832.00MiB, used=0.00B\n"
"Data, single: total=1.63GiB, used=0.00B\n"
"System, single: total=4.00MiB, used=16.00KiB\n"
"Metadata, single: total=8.00MiB, used=112.00KiB\n"
"Metadata, RAID1: total=64.00MiB, used=32.00KiB\n"
"GlobalReserve, single: total=16.25MiB, used=0.00B\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There\\(aqs more than one line for type I<Data> and I<Metadata>, while the "
"profiles are I<single> and I<RAID1>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This state of the filesystem OK but most likely needs the user/administrator "
"to take an action and finish the interrupted tasks. This cannot be easily "
"done automatically, also the user knows the expected final profiles."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In the example above, the filesystem started as a single device and "
"I<single> block group profile. Then another device was added, followed by "
"balance with I<convert=raid1> but for some reason hasn\\(aqt finished. "
"Restarting the balance with I<convert=raid1> will continue and end up with "
"filesystem with all block group profiles I<RAID1>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If you\\(aqre familiar with balance filters, you can use I<convert=raid1,"
"profiles=single,soft>, which will take only the unconverted I<single> "
"profiles and convert them to I<raid1>\\&. This may speed up the conversion "
"as it would not try to rewrite the already convert I<raid1> profiles."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Having just one profile is desired as this also clearly defines the profile "
"of newly allocated block groups, otherwise this depends on internal "
"allocation policy. When there are multiple profiles present, the order of "
"selection is RAID56, RAID10, RAID1, RAID0 as long as the device number "
"constraints are satisfied."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Commands that print the warning were chosen so they\\(aqre brought to user "
"attention when the filesystem state is being changed in that regard. This "
"is: B<device add>, B<device delete>, B<balance cancel>, B<balance pause>\\&. "
"Commands that report space usage: B<filesystem df>, B<device usage>\\&. The "
"command B<filesystem usage> provides a line in the overall summary:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "Multiple profiles:                 yes (data, metadata)\n"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SEEDING DEVICE"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"The COW mechanism and multiple devices under one hood enable an interesting "
"concept, called a seeding device: extending a read-only filesystem on a "
"device with another device that captures all writes. For example imagine an "
"immutable golden image of an operating system enhanced with another device "
"that allows to use the data from the golden image and normal operation.  "
"This idea originated on CD-ROMs with base OS and allowing to use them for "
"live systems, but this became obsolete. There are technologies providing "
"similar functionality, like \\X'tty: link https://en.wikipedia.org/wiki/"
"Union_mount'I<\\%unionmount>\\X'tty: link', \\X'tty: link https://en."
"wikipedia.org/wiki/OverlayFS'I<\\%overlayfs>\\X'tty: link' or \\X'tty: link "
"https://en.wikipedia.org/wiki/Qcow#qcow2'I<\\%qcow2>\\X'tty: link' image "
"snapshot."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The seeding device starts as a normal filesystem, once the contents is "
"ready, B<btrfstune -S 1> is used to flag it as a seeding device. Mounting "
"such device will not allow any writes, except adding a new device by B<btrfs "
"device add>\\&.  Then the filesystem can be remounted as read-write."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Given that the filesystem on the seeding device is always recognized as read-"
"only, it can be used to seed multiple filesystems from one device at the "
"same time. The UUID that is normally attached to a device is automatically "
"changed to a random UUID on each mount."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Once the seeding device is mounted, it needs the writable device. After "
"adding it, unmounting and mounting with B<umount /path; mount /dev/writable /"
"path> or remounting read-write with B<remount -o remount,rw> makes the "
"filesystem at B</path> ready for use."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There is a known bug with using remount to make the mount writeable: remount "
"will leave the filesystem in a state where it is unable to clean deleted "
"snapshots, so it will leak space until it is unmounted and mounted properly."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Furthermore, deleting the seeding device from the filesystem can turn it "
"into a normal filesystem, provided that the writable device can also contain "
"all the data from the seeding device."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The seeding device flag can be cleared again by B<btrfstune -f -S 0>, e.g.  "
"allowing to update with newer data but please note that this will invalidate "
"all existing filesystems that use this particular seeding device. This works "
"for some use cases, not for others, and the forcing flag to the command is "
"mandatory to avoid accidental mistakes."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Example how to create and use one seeding device:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# mkfs.btrfs /dev/sda\n"
"# mount /dev/sda /mnt/mnt1\n"
"\\&... fill mnt1 with data\n"
"# umount /mnt/mnt1\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "# btrfstune -S 1 /dev/sda\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# mount /dev/sda /mnt/mnt1\n"
"# btrfs device add /dev/sdb /mnt/mnt1\n"
"# umount /mnt/mnt1\n"
"# mount /dev/sdb /mnt/mnt1\n"
"\\&... /mnt/mnt1 is now writable\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Now B</mnt/mnt1> can be used normally. The device B</dev/sda> can be mounted "
"again with a another writable device:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# mount /dev/sda /mnt/mnt2\n"
"# btrfs device add /dev/sdc /mnt/mnt2\n"
"# umount /mnt/mnt2\n"
"# mount /dev/sdc /mnt/mnt2\n"
"\\&... /mnt/mnt2 is now writable\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The writable device (file:I</dev/sdb>) can be decoupled from the seeding "
"device and used independently:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid "# btrfs device delete /dev/sda /mnt/mnt1\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"As the contents originated in the seeding device, it\\(aqs possible to turn "
"B</dev/sdb> to a seeding device again and repeat the whole process."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "A few things to note:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"it\\(aqs recommended to use only single device for the seeding device, it "
"works for multiple devices but the I<single> profile must be used in order "
"to make the seeding device deletion work"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "block group profiles I<single> and I<dup> support the use cases above"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"the label is copied from the seeding device and can be changed by B<btrfs "
"filesystem label>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "each new mount of the seeding device gets a new random UUID"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<umount /path; mount /dev/writable /path> can be replaced with B<mount -o "
"remount,rw /path> but it won\\(aqt reclaim space of deleted subvolumes until "
"the seeding device is mounted read-write again before making it seeding again"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Chained seeding devices"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Though it\\(aqs not recommended and is rather an obscure and untested use "
"case, chaining seeding devices is possible. In the first example, the "
"writable device B</dev/sdb> can be turned onto another seeding device again, "
"depending on the unchanged seeding device B</dev/sda>\\&. Then using B</dev/"
"sdb> as the primary seeding device it can be extended with another writable "
"device, say B</dev/sdd>, and it continues as before as a simple tree "
"structure on devices."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"# mount /dev/sda /mnt/mnt1\n"
"# btrfs device add /dev/sdb /mnt/mnt1\n"
"# mount -o remount,rw /mnt/mnt1\n"
"\\&... /mnt/mnt1 is now writable\n"
"# umount /mnt/mnt1\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "# btrfstune -S 1 /dev/sdb\n"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable
#, no-wrap
msgid ""
"# mount /dev/sdb /mnt/mnt1\n"
"# btrfs device add /dev/sdc /mnt\n"
"# mount -o remount,rw /mnt/mnt1\n"
"\\&... /mnt/mnt1 is now writable\n"
"# umount /mnt/mnt1\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "As a result we have:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<sda> is a single seeding device, with its initial contents"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<sdb> is a seeding device but requires I<sda>, the contents are from the "
"time when I<sdb> is made seeding, i.e. contents of I<sda> with any later "
"changes"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<sdc> last writable, can be made a seeding one the same way as was I<sdb>, "
"preserving its contents and depending on I<sda> and I<sdb>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"As long as the seeding devices are unmodified and available, they can be "
"used to start another branch."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "RAID56 STATUS AND RECOMMENDED PRACTICES"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The RAID56 feature provides striping and parity over several devices, same "
"as the traditional RAID5/6. There are some implementation and design "
"deficiencies that make it unreliable for some corner cases and the feature "
"B<should not be used in production, only for evaluation or testing>\\&.  The "
"power failure safety for metadata with RAID56 is not 100%."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Metadata"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Do not use I<raid5> nor I<raid6> for metadata. Use I<raid1> or I<raid1c3> "
"respectively."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The substitute profiles provide the same guarantees against loss of 1 or 2 "
"devices, and in some respect can be an improvement.  Recovering from one "
"missing device will only need to access the remaining 1st or 2nd copy, that "
"in general may be stored on some other devices due to the way RAID1 works on "
"btrfs, unlike on a striped profile (similar to I<raid0>) that would need all "
"devices all the time."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The space allocation pattern and consumption is different (e.g. on N "
"devices): for I<raid5> as an example, a 1GiB chunk is reserved on each "
"device, while with I<raid1> there\\(aqs each 1GiB chunk stored on 2 devices. "
"The consumption of each 1GiB of used metadata is then I<N * 1GiB> for vs I<2 "
"* 1GiB>\\&. Using I<raid1> is also more convenient for balancing/converting "
"to other profile due to lower requirement on the available chunk space."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Missing/incomplete support"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When RAID56 is on the same filesystem with different raid profiles, the "
"space reporting is inaccurate, e.g. B<df>, B<btrfs filesystem df> or B<btrfs "
"filesystem usage>\\&. When there\\(aqs only a one profile per block group "
"type (e.g. RAID5 for data) the reporting is accurate."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When scrub is started on a RAID56 filesystem, it\\(aqs started on all "
"devices that degrade the performance. The workaround is to start it on each "
"device separately. Due to that the device stats may not match the actual "
"state and some errors might get reported multiple times."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<write hole> problem. An unclean shutdown could leave a partially "
"written stripe in a state where the some stripe ranges and the parity are "
"from the old writes and some are new. The information which is which is not "
"tracked. Write journal is not implemented. Alternatively a full read-modify-"
"write would make sure that a full stripe is always written, avoiding the "
"write hole completely, but performance in that case turned out to be too bad "
"for use."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The striping happens on all available devices (at the time the chunks were "
"allocated), so in case a new device is added it may not be utilized "
"immediately and would require a rebalance. A fixed configured stripe width "
"is not implemented."
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "STORAGE MODEL, HARDWARE CONSIDERATIONS"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Storage model"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<A storage model is a model that captures key physical aspects of data "
"structure in a data store. A filesystem is the logical structure organizing "
"data on top of the storage device.>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The filesystem assumes several features or limitations of the storage device "
"and utilizes them or applies measures to guarantee reliability. BTRFS in "
"particular is based on a COW (copy on write) mode of writing, i.e. not "
"updating data in place but rather writing a new copy to a different location "
"and then atomically switching the pointers."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In an ideal world, the device does what it promises. The filesystem assumes "
"that this may not be true so additional mechanisms are applied to either "
"detect misbehaving hardware or get valid data by other means. The devices "
"may (and do)  apply their own detection and repair mechanisms but we "
"won\\(aqt assume any."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The following assumptions about storage devices are considered (sorted by "
"importance, numbers are for further reference):"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"atomicity of reads and writes of blocks/sectors (the smallest unit of data "
"the device presents to the upper layers)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"there\\(aqs a flush command that instructs the device to forcibly order "
"writes before and after the command; alternatively there\\(aqs a barrier "
"command that facilitates the ordering but may not flush the data"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"data sent to write to a given device offset will be written without further "
"changes to the data and to the offset"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"writes can be reordered by the device, unless explicitly serialized by the "
"flush command"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "reads and writes can be freely reordered and interleaved"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The consistency model of BTRFS builds on these assumptions. The logical data "
"updates are grouped, into a generation, written on the device, serialized by "
"the flush command and then the super block is written ending the "
"generation.  All logical links among metadata comprising a consistent view "
"of the data may not cross the generation boundary."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "When things go wrong"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<No or partial atomicity of block reads/writes (1)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<Problem>: a partial block contents is written (I<torn write>), e.g. due to "
"a power glitch or other electronics failure during the read/write"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<Detection>: checksum mismatch on read"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<Repair>: use another copy or rebuild from multiple blocks using some "
"encoding scheme"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<The flush command does not flush (2)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This is perhaps the most serious problem and impossible to mitigate by "
"filesystem without limitations and design restrictions. What could happen in "
"the worst case is that writes from one generation bleed to another one, "
"while still letting the filesystem consider the generations isolated. Crash "
"at any point would leave data on the device in an inconsistent state without "
"any hint what exactly got written, what is missing and leading to stale "
"metadata link information."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Devices usually honor the flush command, but for performance reasons may do "
"internal caching, where the flushed data are not yet persistently stored. A "
"power failure could lead to a similar scenario as above, although it\\(aqs "
"less likely that later writes would be written before the cached ones. This "
"is beyond what a filesystem can take into account. Devices or controllers "
"are usually equipped with batteries or capacitors to write the cache "
"contents even after power is cut. (I<Battery backed write cache>)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Data get silently changed on write (3)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Such thing should not happen frequently, but still can happen spuriously due "
"the complex internal workings of devices or physical effects of the storage "
"media itself."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<Problem>: while the data are written atomically, the contents get changed"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<Data get silently written to another offset (3)>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This would be another serious problem as the filesystem has no information "
"when it happens. For that reason the measures have to be done ahead of "
"time.  This problem is also commonly called I<ghost write>\\&."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The metadata blocks have the checksum embedded in the blocks, so a correct "
"atomic write would not corrupt the checksum. It\\(aqs likely that after "
"reading such block the data inside would not be consistent with the rest. To "
"rule that out there\\(aqs embedded block number in the metadata block. "
"It\\(aqs the logical block number because this is what the logical structure "
"expects and verifies."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The following is based on information publicly available, user feedback, "
"community discussions or bug report analyses. It\\(aqs not complete and "
"further research is encouraged when in doubt."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Main memory"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The data structures and raw data blocks are temporarily stored in computer "
"memory before they get written to the device. It is critical that memory is "
"reliable because even simple bit flips can have vast consequences and lead "
"to damaged structures, not only in the filesystem but in the whole operating "
"system."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Based on experience in the community, memory bit flips are more common than "
"one would think. When it happens, it\\(aqs reported by the tree-checker or "
"by a checksum mismatch after reading blocks. There are some very obvious "
"instances of bit flips that happen, e.g. in an ordered sequence of keys in "
"metadata blocks. We can easily infer from the other data what values get "
"damaged and how. However, fixing that is not straightforward and would "
"require cross-referencing data from the entire filesystem to see the scope."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If available, ECC memory should lower the chances of bit flips, but this "
"type of memory is not available in all cases. A memory test should be "
"performed in case there\\(aqs a visible bit flip pattern, though this may "
"not detect a faulty memory module because the actual load of the system "
"could be the factor making the problems appear. In recent years attacks on "
"how the memory modules operate have been demonstrated (I<rowhammer>) "
"achieving specific bits to be flipped.  While these were targeted, this "
"shows that a series of reads or writes can affect unrelated parts of memory."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"Block group profiles with redundancy (like RAID1) will not protect against "
"memory errors as the blocks are first stored in memory before they are "
"written to the devices from the same source."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"A filesystem mounted read-only will not affect the underlying block device "
"in almost 100% (with highly unlikely exceptions). The exception is a tree-"
"log that needs to be replayed during mount (and before the read-only mount "
"takes place), working memory is needed for that and that can be affected by "
"bit flips.  There\\(aqs a theoretical case where bit flip changes the "
"filesystem status from read-only to read-write."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Further reading:"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://en.wikipedia.org/wiki/Row_hammer'I<\\%https://en."
"wikipedia.org/wiki/Row_hammer>\\X'tty: link'"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed
msgid "memory overclocking, XMP, potential risks"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "What to do:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"run I<memtest>, note that sometimes memory errors happen only when the "
"system is under heavy load that the default memtest cannot trigger"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"memory errors may appear as filesystem going read-only due to \"pre write\" "
"check, that verify meta data before they get written but fail some basic "
"consistency checks"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"newly built systems should be tested before being put to production use, "
"ideally start a IO/CPU load that will be run on such system later; namely "
"systems that will utilize overclocking or special performance features"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Direct memory access (DMA)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Another class of errors is related to DMA (direct memory access) performed "
"by device drivers. While this could be considered a software error, the data "
"transfers that happen without CPU assistance may accidentally corrupt other "
"pages. Storage devices utilize DMA for performance reasons, the filesystem "
"structures and data pages are passed back and forth, making errors possible "
"in case page life time is not properly tracked."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are lots of quirks (device-specific workarounds) in Linux kernel "
"drivers (regarding not only DMA) that are added when found. The quirks may "
"avoid specific errors or disable some features to avoid worse problems."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"use up-to-date kernel (recent releases or maintained long term support "
"versions)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "as this may be caused by faulty drivers, keep the systems up-to-date"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Rotational disks (HDD)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Rotational HDDs typically fail at the level of individual sectors or small "
"clusters.  Read failures are caught on the levels below the filesystem and "
"are returned to the user as I<EIO - Input/output error>\\&. Reading the "
"blocks repeatedly may return the data eventually, but this is better done by "
"specialized tools and filesystem takes the result of the lower layers. "
"Rewriting the sectors may trigger internal remapping but this inevitably "
"leads to data loss."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Disk firmware is technically software but from the filesystem perspective is "
"part of the hardware. IO requests are processed, and caching or various "
"other optimizations are performed, which may lead to bugs under high load or "
"unexpected physical conditions or unsupported use cases."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Disks are connected by cables with two ends, both of which can cause "
"problems when not attached properly. Data transfers are protected by "
"checksums and the lower layers try hard to transfer the data correctly or "
"not at all. The errors from badly-connecting cables may manifest as large "
"amount of failed read or write requests, or as short error bursts depending "
"on physical conditions."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "check B<smartctl> for potential issues"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Solid state drives (SSD)"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"The mechanism of information storage is different from HDDs and this affects "
"the failure mode as well. The data are stored in cells grouped in large "
"blocks with limited number of resets and other write constraints. The "
"firmware tries to avoid unnecessary resets and performs optimizations to "
"maximize the storage media lifetime. The known techniques are deduplication "
"(blocks with same fingerprint/hash are mapped to same physical block), "
"compression or internal remapping and garbage collection of used memory "
"cells. Due to the additional processing there are measures to verify the "
"data e.g. by ECC codes."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The observations of failing SSDs show that the whole electronic fails at "
"once or affects a lot of data (e.g. stored on one chip). Recovering such "
"data may need specialized equipment and reading data repeatedly does not "
"help as it\\(aqs possible with HDDs."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are several technologies of the memory cells with different "
"characteristics and price. The lifetime is directly affected by the type and "
"frequency of data written.  Writing \"too much\" distinct data (e.g. "
"encrypted)  may render the internal deduplication ineffective and lead to a "
"lot of rewrites and increased wear of the memory cells."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are several technologies and manufacturers so it\\(aqs hard to "
"describe them but there are some that exhibit similar behaviour:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"expensive SSD will use more durable memory cells and is optimized for "
"reliability and high load"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"cheap SSD is projected for a lower load (\"desktop user\") and is optimized "
"for cost, it may employ the optimizations and/or extended error reporting "
"partially or not at all"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"It\\(aqs not possible to reliably determine the expected lifetime of an SSD "
"due to lack of information about how it works or due to lack of reliable "
"stats provided by the device."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Metadata writes tend to be the biggest component of lifetime writes to a "
"SSD, so there is some value in reducing them. Depending on the device class "
"(high end/low end) the features like DUP block group profiles may affect the "
"reliability in both ways:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<high end> are typically more reliable and using I<single> for data and "
"metadata could be suitable to reduce device wear"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<low end> could lack ability to identify errors so an additional redundancy "
"at the filesystem level (checksums, I<DUP>) could help"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Only users who consume 50 to 100% of the SSD\\(aqs actual lifetime writes "
"need to be concerned by the write amplification of btrfs DUP metadata. Most "
"users will be far below 50% of the actual lifetime, or will write the drive "
"to death and discover how many writes 100% of the actual lifetime was. SSD "
"firmware often adds its own write multipliers that can be arbitrary and "
"unpredictable and dependent on application behavior, and these will "
"typically have far greater effect on SSD lifespan than DUP metadata. "
"It\\(aqs more or less impossible to predict when a SSD will run out of "
"lifetime writes to within a factor of two, so it\\(aqs hard to justify wear "
"reduction as a benefit."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://www.snia.org/educational-library/ssd-and-deduplication-"
"end-spinning-disk-2012'I<\\%https://www.snia.org/educational-library/ssd-and-"
"deduplication-end-spinning-disk-2012>\\X'tty: link'"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://www.snia.org/educational-library/realities-solid-state-"
"storage-2013-2013'I<\\%https://www.snia.org/educational-library/realities-"
"solid-state-storage-2013-2013>\\X'tty: link'"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://www.snia.org/educational-library/ssd-performance-"
"primer-2013'I<\\%https://www.snia.org/educational-library/ssd-performance-"
"primer-2013>\\X'tty: link'"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://www.snia.org/educational-library/how-controllers-"
"maximize-ssd-life-2013'I<\\%https://www.snia.org/educational-library/how-"
"controllers-maximize-ssd-life-2013>\\X'tty: link'"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "run B<smartctl> or self-tests to look for potential issues"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "keep the firmware up-to-date"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "NVM express, non-volatile memory (NVMe)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"NVMe is a type of persistent memory usually connected over a system bus "
"(PCIe)  or similar interface and the speeds are an order of magnitude faster "
"than SSD.  It is also a non-rotating type of storage, and is not typically "
"connected by a cable. It\\(aqs not a SCSI type device either but rather a "
"complete specification for logical device interface."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In a way the errors could be compared to a combination of SSD class and "
"regular memory. Errors may exhibit as random bit flips or IO failures. There "
"are tools to access the internal log (B<nvme log> and B<nvme-cli>) for a "
"more detailed analysis."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are separate error detection and correction steps performed e.g. on "
"the bus level and in most cases never making in to the filesystem level. "
"Once this happens it could mean there\\(aqs some systematic error like "
"overheating or bad physical connection of the device. You may want to run "
"self-tests (using B<smartctl>)."
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://en.wikipedia.org/wiki/NVM_Express'I<\\%https://en."
"wikipedia.org/wiki/NVM_Express>\\X'tty: link'"
msgstr ""

#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://www.smartmontools.org/wiki/NVMe_Support'I<\\%https://"
"www.smartmontools.org/wiki/NVMe_Support>\\X'tty: link'"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Drive firmware"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Firmware is technically still software but embedded into the hardware. As "
"all software has bugs, so does firmware. Storage devices can update the "
"firmware and fix known bugs. In some cases the it\\(aqs possible to avoid "
"certain bugs by quirks (device-specific workarounds) in Linux kernel."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A faulty firmware can cause wide range of corruptions from small and "
"localized to large affecting lots of data. Self-repair capabilities may not "
"be sufficient."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"check for firmware updates in case there are known problems, note that "
"updating firmware can be risky on itself"
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SD flash cards"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"There are a lot of devices with low power consumption and thus using storage "
"media based on low power consumption too, typically flash memory stored on a "
"chip enclosed in a detachable card package. An improperly inserted card may "
"be damaged by electrical spikes when the device is turned on or off. The "
"chips storing data in turn may be damaged permanently. All types of flash "
"memory have a limited number of rewrites, so the data are internally "
"translated by FTL (flash translation layer). This is implemented in firmware "
"(technically a software) and prone to bugs that manifest as hardware errors."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Adding redundancy like using DUP profiles for both data and metadata can "
"help in some cases but a full backup might be the best option once problems "
"appear and replacing the card could be required as well."
msgstr ""

#. type: SS
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "Hardware as the main source of filesystem corruptions"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<If you use unreliable hardware and don\\(aqt know about that, don\\(aqt "
"blame the filesystem when it tells you.>"
msgstr ""

#. type: SH
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#.  Generated by docutils manpage writer.
#. type: Plain text
#: archlinux
msgid ""
"\\X'tty: link https://man7.org/linux/man-pages/man5/acl.5.html'I<\\"
"%acl(5)>\\X'tty: link', I<\\%btrfs(8)>, \\X'tty: link https://man7.org/linux/"
"man-pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: link', \\X'tty: link "
"https://man7.org/linux/man-pages/man8/fstrim.8.html'I<\\%fstrim(8)>\\X'tty: "
"link', \\X'tty: link https://man7.org/linux/man-pages/man2/ioctl.2.html'I<\\"
"%ioctl(2)>\\X'tty: link', I<\\%mkfs.btrfs(8)>, \\X'tty: link https://man7."
"org/linux/man-pages/man8/mount.8.html'I<\\%mount(8)>\\X'tty: link', \\X'tty: "
"link https://man7.org/linux/man-pages/man8/swapon.8.html'I<\\"
"%swapon(8)>\\X'tty: link'"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "Feb 28, 2023"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "6.2"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"This section describes mount options specific to BTRFS.  For the generic "
"mount options please refer to B<mount(8)> manual page. The options are "
"sorted alphabetically (discarding the I<no> prefix)."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"Enable/disable support for POSIX Access Control Lists (ACLs).  See the "
"B<acl(5)> manual page for more information about ACLs."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Enable automatic file defragmentation.  When enabled, small random writes "
"into files (in a range of tens of kilobytes, currently it\\(aqs 64KiB) are "
"detected and queued up for the defragmentation process.  Not well suited for "
"large database workloads."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Force clearing and rebuilding of the disk space cache if something has gone "
"wrong. See also: I<space_cache>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"Enable data copy-on-write for newly created files.  I<Nodatacow> implies "
"I<nodatasum>, and disables I<compression>\\&. All files created under "
"I<nodatacow> are also set the NOCOW file attribute (see B<chattr(1)>)."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"Enable data checksumming for newly created files.  I<Datasum> implies "
"I<datacow>, i.e. the normal mode of operation. All files created under "
"I<nodatasum> inherit the \"no checksums\" property, however there\\(aqs no "
"corresponding file attribute (see B<chattr(1)>)."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Allow mounts with less devices than the RAID profile constraints require.  A "
"read-write mount (or remount) may fail when there are too many devices "
"missing, for example if a stripe member is completely missing from RAID0."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Example: metadata -- raid1, data -- single, devices -- /dev/sda, /dev/sdb"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "(default: off, async support since: 5.6)"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "(depends on compile-time option BTRFS_DEBUG, since: 4.4, default: off)"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"A debugging helper to intentionally fragment given I<type> of block groups. "
"The type can be I<data>, I<metadata> or I<all>\\&. This mount option should "
"not be used outside of debugging environments and is not recognized if the "
"kernel config option I<BTRFS_DEBUG> is not enabled."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Specify the maximum amount of space, that can be inlined in a metadata b-"
"tree leaf.  The value is specified in bytes, optionally with a K suffix "
"(case insensitive).  In practice, this value is limited by the filesystem "
"block size (named I<sectorsize> at mkfs time), and memory page size of the "
"system. In case of sectorsize limit, there\\(aqs some space unavailable due "
"to leaf headers.  For example, a 4KiB sectorsize, maximum size of inline "
"data is about 3900 bytes."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"(I<nospace_cache> since: 3.2, I<space_cache=v1> and I<space_cache=v2> since "
"4.5, default: I<space_cache=v1>)"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"There are two implementations of the free space cache. The original one, "
"referred to as I<v1>, is the safe default. The I<v1> space cache can be "
"disabled at mount time with I<nospace_cache> without clearing."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"On very large filesystems (many terabytes) and certain workloads, the "
"performance of the I<v1> space cache may degrade drastically. The I<v2> "
"implementation, which adds a new b-tree called the free space tree, "
"addresses this issue. Once enabled, the I<v2> space cache will always be "
"used and cannot be disabled unless it is cleared. Use I<clear_cache,"
"space_cache=v1> or I<clear_cache,nospace_cache> to do so. If I<v2> is "
"enabled, kernels without I<v2> support will only be able to mount the "
"filesystem in read-only mode."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The I<\\%btrfs-check(8)> and I<:doc:\\(gamkfs.btrfs(8)E<lt>mkfs.btrfsE<gt>> "
"commands have full I<v2> free space cache support since v4.19."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"If a version is not explicitly specified, the default implementation will be "
"chosen, which is I<v1>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"Historically, any user could create a snapshot even if he was not owner of "
"the source subvolume, the subvolume deletion has been restricted for that "
"reason. The subvolume creation has been restricted but this mount option is "
"still required. This is a usability issue.  Since 4.18, the B<rmdir(2)> "
"syscall can delete an empty subvolume just like an ordinary directory. "
"Whether this is possible can be detected at runtime, see I<rmdir_subvol> "
"feature in I<FILESYSTEM FEATURES>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
msgid ""
"The functionality has been removed in 5.11, any stale data created by "
"previous use of the I<inode_cache> option can be removed by B<btrfs check --"
"clear-ino-cache>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"Some of the general mount options from B<mount(8)> that affect BTRFS and are "
"worth mentioning."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"under read intensive work-loads, specifying I<noatime> significantly "
"improves performance because no new access time information needs to be "
"written. Without this option, the default is I<relatime>, which only reduces "
"the number of inode atime updates in comparison to the traditional "
"I<strictatime>\\&. The worst case for atime updates under I<relatime> occurs "
"when many files are read whose atime is older than 24 h and which are "
"freshly snapshotted. In that case the atime is updated and COW happens - for "
"each file - in bulk. See also I<\\%https://lwn.net/Articles/499293/> - "
"I<Atime and btrfs: a bad combination? (LWN, 2012-05-31)>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The features of a filesystem (with a given UUID) are listed in I</sys/fs/"
"btrfs/UUID/features/>, one file per feature. The status is stored inside the "
"file. The value I<1> is for enabled and active, while I<0> means the feature "
"was enabled at mount time but turned off afterwards."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Whether a particular feature can be turned on a mounted filesystem can be "
"found in the directory I</sys/fs/btrfs/features/>, one file per feature. The "
"value I<1> means the feature can be enabled."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"List of features (see also I<\\%mkfs.btrfs(8)> section I<FILESYSTEM "
"FEATURES>):"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"indicate that B<rmdir(2)> syscall can delete an empty subvolume just like an "
"ordinary directory. Note that this feature only depends on the kernel "
"version."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"list of checksum algorithms supported by the kernel module, the respective "
"modules or built-in implementing the algorithms need to be present to mount "
"the filesystem, see I<CHECKSUM ALGORITHMS>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"zoned mode is allocation/write friendly to host-managed zoned devices, "
"allocation space is partitioned into fixed-size zones that must be updated "
"sequentially, see I<ZONED MODE>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"A swapfile is file-backed memory that the system uses to temporarily offload "
"the RAM.  It is supported since kernel 5.0. Use B<swapon(8)> to activate the "
"swapfile. There are some limitations of the implementation in BTRFS and "
"Linux swap subsystem:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "swapfile - the containing subvolume cannot be snapshotted"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"balance - block groups with swapfile extents are skipped and reported, the "
"rest will be processed normally"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"resize shrink - works as long as the extents are outside of the shrunk range"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"device add - a new device does not interfere with existing swapfile and this "
"operation will work, though no new swapfile can be activated afterwards"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# truncate -s 0 swapfile\n"
"# chattr +C swapfile\n"
"# fallocate -l 2G swapfile\n"
"# chmod 0600 swapfile\n"
"# mkswap swapfile\n"
"# swapon swapfile\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
#, no-wrap
msgid ""
"^\".ft C$\n"
"# btrfs filesystem mkswapfile swapfile\n"
"# swapon swapfile\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "The file will appear in I</proc/swaps>:"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# cat /proc/swaps\n"
"Filename          Type          Size           Used      Priority\n"
"/path/swapfile    file          2097152        0         -2\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"/path/swapfile        none        swap        defaults      0 0\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Since version 6.1 there\\(aqs a command B<btrfs inspect-internal map-"
"swapfile> that will print the device physical offset and the adjusted value "
"for I</sys/power/resume_offset>\\&.  Note that the value is divided by page "
"size, i.e. it\\(aqs not the offset itself."
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# btrfs filesystem mkswapfile swapfile\n"
"# btrfs inspect-internal map-swapfile swapfile\n"
"Physical start: 811511726080\n"
"Resume offset:     198122980\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# btrfs inspect-internal map-swapfile -r swapfile\n"
"198122980\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The command I<map-swapfile> also verifies all the requirements, i.e. no "
"holes, single device, etc."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Notably, the I<swapon> utility exits with a message that does not say what "
"failed:"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# swapon /path/swapfile\n"
"swapon: /path/swapfile: swapon failed: Invalid argument\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# journalctl -t kernel | grep swapfile\n"
"kernel: BTRFS warning (device sda): swapfile must have single data profile\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6
msgid ""
"Approximate relative performance of the algorithms, measured against CRC32C "
"using reference software implementations on a 3.5GHz intel CPU:"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "1700"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "CPU instruction"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "2500"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "1.44"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "105000"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "61"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "36000"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "libgcrypt/AVX2"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "63000"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "37"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "libsodium/AVX2"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "22000"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "13"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "19000"
msgstr ""

#. type: tbl table
#: debian-bookworm debian-unstable opensuse-leap-15-6
#, no-wrap
msgid "11"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Many kernels are configured with SHA256 as built-in and not as a module.  "
"The accelerated versions are however provided by the modules and must be "
"loaded explicitly (B<modprobe sha256>) before mounting the filesystem to "
"make use of them. You can check in I</sys/fs/btrfs/FSID/checksum> which one "
"is used. If you see I<sha256-generic>, then you may want to unmount and "
"mount the filesystem again, changing that on a mounted filesystem is not "
"possible.  Check the file I</proc/crypto>, when the implementation is built-"
"in, you\\(aqd find"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"name         : sha256\n"
"driver       : sha256-generic\n"
"module       : kernel\n"
"priority     : 100\n"
"\\&...\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"name         : sha256\n"
"driver       : sha256-avx2\n"
"module       : sha256_ssse3\n"
"priority     : 170\n"
"\\&...\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Typically the compression can be enabled on the whole filesystem, specified "
"for the mount point. Note that the compression mount options are shared "
"among all mounts of the same filesystem, either bind mounts or subvolume "
"mounts.  Please refer to section I<MOUNT OPTIONS>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"$ mount -o compress=zstd /dev/sdx /mnt\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"$ btrfs filesystem defrag -czstd file\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"$ chattr +c file\n"
"$ btrfs property set file compression zstd\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"$ lsattr file\n"
"---------------------m file\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"Compression is done using the COW mechanism so it\\(aqs incompatible with "
"I<nodatacow>\\&. Direct IO works on compressed files but will fall back to "
"buffered writes and leads to recompression. Currently I<nodatasum> and "
"compression don\\(aqt work together."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The top level path is I</sys/fs/btrfs/>, and the main directory layout is "
"the following:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"For I</sys/fs/btrfs/features/> directory, each file means a supported "
"feature for the current kernel."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"For I</sys/fs/btrfs/E<lt>UUIDE<gt>/features/> directory, each file means an "
"enabled feature for the mounted filesystem."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "The features shares the same name in section I<FILESYSTEM FEATURES>\\&."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Files in I</sys/fs/btrfs/E<lt>UUIDE<gt>/> directory are:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The checksum used for the mounted filesystem.  This includes both the "
"checksum type (see section I<CHECKSUM ALGORITHMS>)  and the implemented "
"driver (mostly shows if it\\(aqs hardware accelerated)."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Shows the running exclusive operation.  Check section I<FILESYSTEM EXCLUSIVE "
"OPERATIONS> for details."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Files and directories in I</sys/fs/btrfs/E<lt>UUIDE<gt>/allocations> "
"directory are:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Files in I</sys/fs/btrfs/E<lt>UUIDE<gt>/allocations/{data,metadata,system}> "
"directory are:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Files in I</sys/fs/btrfs/E<lt>UUIDE<gt>/devinfo/E<lt>DEVIDE<gt>> directory "
"are:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "Files in I</sys/fs/btrfs/E<lt>UUIDE<gt>/qgroups/> directory are:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Files in I</sys/fs/btrfs/E<lt>UUIDE<gt>/E<lt>LEVELE<gt>_E<lt>IDE<gt>/> "
"directory are:"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Since kernel 5.10 the currently running operation can be obtained from I</"
"sys/fs/UUID/exclusive_operation> with following values and operations:"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"The symlink target may not be a valid path, i.e. the path name components "
"can exceed the limits (NAME_MAX), there\\(aqs no content validation at "
"B<symlink(3)> creation."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"minimum number: 256 (for subvolumes), regular files and directories: 257, "
"maximum number: (2:sup:I<64> - 256)"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"65536 when the I<extref> feature is turned on during mkfs (default), roughly "
"100 otherwise"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"GRUB2 (I<\\%https://www.gnu.org/software/grub>) has the most advanced "
"support of booting from BTRFS with respect to features."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"U-boot (I<\\%https://www.denx.de/wiki/U-Boot/>) has decent support for "
"booting but not all BTRFS features are implemented, check the documentation."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"EXTLINUX (from the I<\\%https://syslinux.org> project) has limited support "
"for BTRFS boot and hasn\\(aqt been updated for for a long time so is not "
"recommended as bootloader."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"I<attributes>: B<chattr(1)> or B<lsattr(1)> utilities (the ioctls are "
"FS_IOC_GETFLAGS and FS_IOC_SETFLAGS), due to the ioctl names the attributes "
"are also called flags"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"I<xflags>: to distinguish from the previous, it\\(aqs extended flags, with "
"tunable bits similar to the attributes but extensible and new bits will be "
"added in the future (the ioctls are FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR "
"but they are not related to extended attributes that are also called "
"xattrs), there\\(aqs no standard tool to change the bits, there\\(aqs "
"support in B<xfs_io(8)> as command B<xfs_io -c chattr>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"I<no dump>, makes sense with 3rd party tools like B<dump(8)>, on BTRFS the "
"attribute can be set/unset but no other special handling is done"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"I<synchronous directory updates>, for more details search B<open(2)> for "
"I<O_SYNC> and I<O_DSYNC>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"I<no compression>, permanently turn off compression on the given file. Any "
"compression mount options will not affect this file. (B<chattr> support "
"added in 1.46.2)"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"I<synchronous updates>, for more details search B<open(2)> for I<O_SYNC> and "
"I<O_DSYNC>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"No other attributes are supported.  For the complete list please refer to "
"the B<chattr(1)> manual page."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"There\\(aqs overlap of letters assigned to the bits with the attributes, "
"this list refers to what B<xfs_io(8)> provides:"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Since version 5.12 btrfs supports so called I<zoned mode>\\&. This is a "
"special on-disk format and allocation/write strategy that\\(aqs friendly to "
"zoned devices.  In short, a device is partitioned into fixed-size zones and "
"each zone can be updated by append-only manner, or reset. As btrfs has no "
"fixed data structures, except the super blocks, the zoned mode only requires "
"block placement that follows the device constraints. You can learn about the "
"whole architecture at I<\\%https://zonedstorage.io> ."
msgstr ""

#. type: TP
#: debian-bookworm
#, no-wrap
msgid "B<the super block is handled in a special way and is at different locations than on a non-zoned filesystem:>"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "only single profile is supported"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"There\\(aqs a character special device I</dev/btrfs-control> with major and "
"minor numbers 10 and 234 (the device can be found under the \\(aqmisc\\(aq "
"category)."
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"$ ls -l /dev/btrfs-control\n"
"crw------- 1 root root 10, 234 Jan  1 12:00 /dev/btrfs-control\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"get the supported features (can be also found under I</sys/fs/btrfs/"
"features>)"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# mknod --mode=600 /dev/btrfs-control c 10 234\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# btrfs rescue create-control-device\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"WARNING: Multiple block group profiles detected, see \\(aqman btrfs(5)\\(aq.\n"
"WARNING:   Data: single, raid1\n"
"WARNING:   Metadata: single, raid1\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"WARNING: Multiple block group profiles detected, see \\(aqman btrfs(5)\\(aq.\n"
"WARNING:   Data: single, raid1\n"
"WARNING:   Metadata: single, raid1\n"
"Data, RAID1: total=832.00MiB, used=0.00B\n"
"Data, single: total=1.63GiB, used=0.00B\n"
"System, single: total=4.00MiB, used=16.00KiB\n"
"Metadata, single: total=8.00MiB, used=112.00KiB\n"
"Metadata, RAID1: total=64.00MiB, used=32.00KiB\n"
"GlobalReserve, single: total=16.25MiB, used=0.00B\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"Multiple profiles:                 yes (data, metadata)\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The COW mechanism and multiple devices under one hood enable an interesting "
"concept, called a seeding device: extending a read-only filesystem on a "
"device with another device that captures all writes. For example imagine an "
"immutable golden image of an operating system enhanced with another device "
"that allows to use the data from the golden image and normal operation.  "
"This idea originated on CD-ROMs with base OS and allowing to use them for "
"live systems, but this became obsolete. There are technologies providing "
"similar functionality, like I<unionmount>, I<overlayfs> or I<qcow2> image "
"snapshot."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Once the seeding device is mounted, it needs the writable device. After "
"adding it, something like B<remount -o remount,rw /path> makes the "
"filesystem at I</path> ready for use. The simplest use case is to throw away "
"all changes by unmounting the filesystem when convenient."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Alternatively, deleting the seeding device from the filesystem can turn it "
"into a normal filesystem, provided that the writable device can also contain "
"all the data from the seeding device."
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# mkfs.btrfs /dev/sda\n"
"# mount /dev/sda /mnt/mnt1\n"
"\\&... fill mnt1 with data\n"
"# umount /mnt/mnt1\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
#, no-wrap
msgid ""
"# mount /dev/sda /mnt/mnt1\n"
"# btrfs device add /dev/sdb /mnt/mnt1\n"
"# mount -o remount,rw /mnt/mnt1\n"
"\\&... /mnt/mnt1 is now writable\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Now I</mnt/mnt1> can be used normally. The device I</dev/sda> can be mounted "
"again with a another writable device:"
msgstr ""

#. type: Plain text
#: debian-bookworm
#, no-wrap
msgid ""
"^\".ft C$\n"
"# mount /dev/sda /mnt/mnt2\n"
"# btrfs device add /dev/sdc /mnt/mnt2\n"
"# mount -o remount,rw /mnt/mnt2\n"
"\\&... /mnt/mnt2 is now writable\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The writable device (I</dev/sdb>) can be decoupled from the seeding device "
"and used independently:"
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# btrfs device delete /dev/sda /mnt/mnt1\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"As the contents originated in the seeding device, it\\(aqs possible to turn "
"I</dev/sdb> to a seeding device again and repeat the whole process."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"Though it\\(aqs not recommended and is rather an obscure and untested use "
"case, chaining seeding devices is possible. In the first example, the "
"writable device I</dev/sdb> can be turned onto another seeding device again, "
"depending on the unchanged seeding device I</dev/sda>\\&. Then using I</dev/"
"sdb> as the primary seeding device it can be extended with another writable "
"device, say I</dev/sdd>, and it continues as before as a simple tree "
"structure on devices."
msgstr ""

#. type: Plain text
#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"# mount /dev/sdb /mnt/mnt1\n"
"# btrfs device add /dev/sdc /mnt\n"
"# mount -o remount,rw /mnt/mnt1\n"
"\\&... /mnt/mnt1 is now writable\n"
"# umount /mnt/mnt1\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"When RAID56 is on the same filesystem with different raid profiles, the "
"space reporting is inaccurate, e.g. B<df>, B<btrfs filesystem df> or B<btrfs "
"filesystem usage>\\&. When there\\(aqs only a one profile per block group "
"type (e.g. RAID5 for data)  the reporting is accurate."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<\\%https://en.wikipedia.org/wiki/Row_hammer>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"The mechanism of information storage is different from HDDs and this affects "
"the failure mode as well. The data are stored in cells grouped in large "
"blocks with limited number of resets and other write constraints. The "
"firmware tries to avoid unnecessary resets and performs optimizations to "
"maximize the storage media lifetime. The known techniques are deduplication "
"(blocks with same fingerprint/hash are mapped to same physical block), "
"compression or internal remapping and garbage collection of used memory "
"cells. Due to the additional processing there are measures to verity the "
"data e.g. by ECC codes."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<\\%https://www.snia.org/educational-library/ssd-and-deduplication-end-"
"spinning-disk-2012>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<\\%https://www.snia.org/educational-library/realities-solid-state-"
"storage-2013-2013>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<\\%https://www.snia.org/educational-library/ssd-performance-primer-2013>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<\\%https://www.snia.org/educational-library/how-controllers-maximize-ssd-"
"life-2013>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<\\%https://en.wikipedia.org/wiki/NVM_Express>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<\\%https://www.smartmontools.org/wiki/NVMe_Support>"
msgstr ""

#.  Generated by docutils manpage writer.
#. type: Plain text
#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"B<acl(5)>, I<\\%btrfs(8)>, B<chattr(1)>, B<fstrim(8)>, B<ioctl(2)>, I<\\"
"%mkfs.btrfs(8)>, B<mount(8)>, B<swapon(8)>"
msgstr ""

#. type: TH
#: debian-unstable
#, no-wrap
msgid "Mar 24, 2024"
msgstr ""

#. type: TH
#: debian-unstable
#, no-wrap
msgid "6.6.3"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed
msgid ""
"The functionality has been removed in 5.11, any stale data created by "
"previous use of the I<inode_cache> option can be removed by I<\\%btrfs "
"rescue clear-ino-cache>\\&."
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"List of features (see also I<\\%mkfs.btrfs(8)> section I<\\%FILESYSTEM "
"FEATURES>):"
msgstr ""

#. type: Plain text
#: debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"A swapfile, when active, is a file-backed swap area.  It is supported since "
"kernel 5.0.  Use B<swapon(8)> to activate it, until then (respectively again "
"after deactivating it with B<swapoff(8)>) it\\(aqs just a normal file (with "
"NODATACOW set), for which the special restrictions for active swapfiles "
"don\\(aqt apply."
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"Since version 6.1 there\\(aqs a command I<\\%btrfs inspect-internal map-"
"swapfile> that will print the device physical offset and the adjusted value "
"for B</sys/power/resume_offset>\\&.  Note that the value is divided by page "
"size, i.e.  it\\(aqs not the offset itself."
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"U-Boot (I<\\%https://www.denx.de/wiki/U-Boot/>) has decent support for "
"booting but not all BTRFS features are implemented, check the documentation."
msgstr ""

#. type: Plain text
#: debian-unstable mageia-cauldron opensuse-leap-15-6
msgid ""
"There\\(aqs an overlap of letters assigned to the bits with the attributes, "
"this list refers to what B<xfs_io(8)> provides:"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid "Ultrastar® DC ZN540 NVMe ZNS SSD (I<\\%product brief>)"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"For convenience, there\\(aqs a script wrapping the basic null_blk management "
"operations I<\\%https://github.com/kdave/nullb.git>, the above commands "
"become:"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"TCMU is a framework to emulate SCSI devices in userspace, providing various "
"backends for the storage, with zoned support as well. A file-backed zoned "
"device can provide more options for larger storage and zone size. Please "
"follow the instructions at I<\\%https://zonedstorage.io/projects/tcmu-runner/"
"> ."
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"The zoned mode has been released in 5.12 and there are still some rough "
"edges and corner cases one can hit during testing. Please report bugs to I<\\"
"%https://github.com/naota/linux/issues/> ."
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid "I<\\%https://zonedstorage.io>"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"I<\\%https://zonedstorage.io/projects/libzbc/> -- I<libzbc> is library and "
"set of tools to directly manipulate devices with ZBC/ZAC support"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"I<\\%https://zonedstorage.io/projects/libzbd/> -- I<libzbd> uses the kernel "
"provided zoned block device interface based on the ioctl() system calls"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"I<\\%https://hddscan.com/blog/2020/hdd-wd-smr.html> -- some details about "
"exact device types"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"I<\\%https://lwn.net/Articles/853308/> -- I<Btrfs on zoned block devices>"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"I<\\%https://www.usenix.org/conference/vault20/presentation/bjorling> -- "
"Zone Append: A New Way of Writing to Zoned Storage"
msgstr ""

#. type: Plain text
#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
msgid ""
"The COW mechanism and multiple devices under one hood enable an interesting "
"concept, called a seeding device: extending a read-only filesystem on a "
"device with another device that captures all writes. For example imagine an "
"immutable golden image of an operating system enhanced with another device "
"that allows to use the data from the golden image and normal operation.  "
"This idea originated on CD-ROMs with base OS and allowing to use them for "
"live systems, but this became obsolete. There are technologies providing "
"similar functionality, like I<\\%unionmount>, I<\\%overlayfs> or I<\\%qcow2> "
"image snapshot."
msgstr ""

#. type: TH
#: fedora-40 fedora-rawhide
#, no-wrap
msgid "Mar 26, 2024"
msgstr ""

#. type: TH
#: fedora-40
#, no-wrap
msgid "6.8"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"This section describes mount options specific to BTRFS.  For the generic "
"mount options please refer to I<\\%mount(8)> manual page. The options are "
"sorted alphabetically (discarding the I<no> prefix)."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"Enable/disable support for POSIX Access Control Lists (ACLs).  See the I<\\"
"%acl(5)> manual page for more information about ACLs."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"Enable data copy-on-write for newly created files.  I<Nodatacow> implies "
"I<nodatasum>, and disables I<compression>\\&. All files created under "
"I<nodatacow> are also set the NOCOW file attribute (see I<\\%chattr(1)>)."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"Enable data checksumming for newly created files.  I<Datasum> implies "
"I<datacow>, i.e. the normal mode of operation. All files created under "
"I<nodatasum> inherit the \"no checksums\" property, however there\\(aqs no "
"corresponding file attribute (see I<\\%chattr(1)>)."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"Historically, any user could create a snapshot even if he was not owner of "
"the source subvolume, the subvolume deletion has been restricted for that "
"reason. The subvolume creation has been restricted but this mount option is "
"still required. This is a usability issue.  Since 4.18, the I<\\%rmdir(2)> "
"syscall can delete an empty subvolume just like an ordinary directory. "
"Whether this is possible can be detected at runtime, see I<rmdir_subvol> "
"feature in I<FILESYSTEM FEATURES>\\&."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"Some of the general mount options from I<\\%mount(8)> that affect BTRFS and "
"are worth mentioning."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"indicate that I<\\%rmdir(2)> syscall can delete an empty subvolume just like "
"an ordinary directory. Note that this feature only depends on the kernel "
"version."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"A swapfile, when active, is a file-backed swap area.  It is supported since "
"kernel 5.0.  Use I<\\%swapon(8)> to activate it, until then (respectively "
"again after deactivating it with I<\\%swapoff(8)>) it\\(aqs just a normal "
"file (with NODATACOW set), for which the special restrictions for active "
"swapfiles don\\(aqt apply."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# btrfs filesystem mkswapfile --size 2G swapfile\n"
"# swapon swapfile\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"The symlink target may not be a valid path, i.e. the path name components "
"can exceed the limits (NAME_MAX), there\\(aqs no content validation at I<\\"
"%symlink(3)> creation."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"I<attributes>: I<\\%chattr(1)> or I<\\%lsattr(1)> utilities (the ioctls are "
"FS_IOC_GETFLAGS and FS_IOC_SETFLAGS), due to the ioctl names the attributes "
"are also called flags"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"I<xflags>: to distinguish from the previous, it\\(aqs extended flags, with "
"tunable bits similar to the attributes but extensible and new bits will be "
"added in the future (the ioctls are FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR "
"but they are not related to extended attributes that are also called "
"xattrs), there\\(aqs no standard tool to change the bits, there\\(aqs "
"support in I<\\%xfs_io(8)> as command B<xfs_io -c chattr>"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"I<no dump>, makes sense with 3rd party tools like I<\\%dump(8)>, on BTRFS "
"the attribute can be set/unset but no other special handling is done"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"I<synchronous directory updates>, for more details search I<\\%open(2)> for "
"I<O_SYNC> and I<O_DSYNC>"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"I<no compression>, permanently turn off compression on the given file. Any "
"compression mount options will not affect this file. (I<\\%chattr(1)> "
"support added in 1.46.2)"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"I<synchronous updates>, for more details search I<\\%open(2)> for I<O_SYNC> "
"and I<O_DSYNC>"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"No other attributes are supported.  For the complete list please refer to "
"the I<\\%chattr(1)> manual page."
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"There\\(aqs an overlap of letters assigned to the bits with the attributes, "
"this list refers to what I<\\%xfs_io(8)> provides:"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"modprobe\\ configfs\n"
"modprobe\\ null_blk\\ nr_devices=0\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"cd\\ /sys/kernel/config/nullb/\n"
"mkdir\\ mydev\n"
"cd\\ mydev\n"
"echo\\ 2048\\ E<gt>\\ size\n"
"echo\\ 1\\ E<gt>\\ zoned\n"
"echo\\ 1\\ E<gt>\\ memory_backed\n"
"echo\\ 256\\ E<gt>\\ zone_size\n"
"echo\\ 1\\ E<gt>\\ power\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"rmdir\\ /sys/kernel/config/nullb/mydev\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"nullb setup\n"
"nullb create -s 2g -z 256\n"
"mkfs.btrfs /dev/nullb0\n"
"\\&...\n"
"nullb rm nullb0\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"# mount /dev/sda /mnt/mnt1\n"
"# btrfs device add /dev/sdb /mnt/mnt1\n"
"# umount /mnt/mnt1\n"
"# mount /dev/sdb /mnt/mnt1\n"
"\\&... /mnt/mnt1 is now writable\n"
"^\".ft P$\n"
msgstr ""

#. type: Plain text
#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"^\".ft C$\n"
"# mount /dev/sda /mnt/mnt2\n"
"# btrfs device add /dev/sdc /mnt/mnt2\n"
"# umount /mnt/mnt2\n"
"# mount /dev/sdc /mnt/mnt2\n"
"\\&... /mnt/mnt2 is now writable\n"
"^\".ft P$\n"
msgstr ""

#.  Generated by docutils manpage writer.
#. type: Plain text
#: fedora-40 fedora-rawhide opensuse-tumbleweed
msgid ""
"I<\\%acl(5)>, I<\\%btrfs(8)>, I<\\%chattr(1)>, I<\\%fstrim(8)>, I<\\"
"%ioctl(2)>, I<\\%mkfs.btrfs(8)>, I<\\%mount(8)>, I<\\%swapon(8)>"
msgstr ""

#. type: TH
#: mageia-cauldron
#, no-wrap
msgid "Mar 10, 2024"
msgstr ""

#. type: TH
#: mageia-cauldron
#, no-wrap
msgid "6.7.1"
msgstr ""

#. type: TH
#: opensuse-leap-15-6
#, no-wrap
msgid "Sep 13, 2023"
msgstr ""

#. type: TH
#: opensuse-leap-15-6
#, no-wrap
msgid "6.5.1"
msgstr ""

#. type: TH
#: opensuse-tumbleweed
#, no-wrap
msgid "May 02, 2024"
msgstr ""