diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /templates/man5/btrfs.5.pot | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'templates/man5/btrfs.5.pot')
-rw-r--r-- | templates/man5/btrfs.5.pot | 7517 |
1 files changed, 7517 insertions, 0 deletions
diff --git a/templates/man5/btrfs.5.pot b/templates/man5/btrfs.5.pot new file mode 100644 index 00000000..84f318fe --- /dev/null +++ b/templates/man5/btrfs.5.pot @@ -0,0 +1,7517 @@ +# 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-03-01 16:53+0100\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 fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "Feb 14, 2024" +msgstr "" + +#. type: TH +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "6.7.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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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 +#: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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 +#: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 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 B<chattr(1)>)." +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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 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 B<chattr(1)>)." +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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 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 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: 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 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: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Some of the general mount options from B<mount(8)> 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 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 +#: 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 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: 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 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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: 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 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 debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +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 +#: 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-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 +#: 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 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 +#: 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-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 +#: 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-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 +#: 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 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 +#: archlinux 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 +#: 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-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 +#: 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-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 +#: 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-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: 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 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 "_" +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 "CRC32C" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide 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 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 opensuse-tumbleweed +#, no-wrap +msgid "870" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide 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 opensuse-tumbleweed +#, no-wrap +msgid "7600" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "16" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "libgcrypt" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "8500" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "18" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "openssl" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "8700" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "botan" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "32000" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "68" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "builtin, CPU instruction" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "37000" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "78" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "libsodium" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "78000" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "166" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide 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 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 opensuse-tumbleweed +#, no-wrap +msgid "builtin/AVX2" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "10900" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "23" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "13500" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "29" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "builtin/SSE41" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "13700" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "14100" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "30" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "14500" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "31" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "kcapi" +msgstr "" + +#. type: tbl table +#: archlinux fedora-40 fedora-rawhide 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-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 +#: 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-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: 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-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 +#: 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-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 +#: 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-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 +#: 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-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 +#: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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 +#: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 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 " +"B<symlink(3)> 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 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 +#: archlinux 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 +#: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 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 B<xfs_io(8)> 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<synchronous directory updates>, for more details search B<open(2)> 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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 +#: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<synchronous updates>, for more details search B<open(2)> for I<O_SYNC> and " +"I<O_DSYNC>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"No other attributes are supported. For the complete list please refer to " +"the B<chattr(1)> 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 debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +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 +#: 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 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: 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 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: 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 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 +#: 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 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 +#: 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 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 +#: 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 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 +#: archlinux 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: 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 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: 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 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: 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 debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<\\%https://zonedstorage.io>" +msgstr "" + +#. type: Plain text +#: archlinux 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 +#: archlinux 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 +#: archlinux 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 +#: archlinux 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 +#: archlinux 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: 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-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 +#: 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-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 +#: 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-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 +#: 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-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 +#: 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-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 +#: 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-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: 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 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: 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-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 +#: 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 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 +#: 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 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 "" + +#. 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-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 +#: 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-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 +#: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Further reading:" +msgstr "" + +#. type: Plain text +#: archlinux 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 +#: 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: 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 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 verity 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 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 +#: archlinux 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 +#: archlinux 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 +#: archlinux 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 +#: 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 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 +#: archlinux 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 "" + +#. 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 debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +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-bookworm +#, no-wrap +msgid "Feb 28, 2023" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "6.2" +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 +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 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 +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 +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 +#, 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 +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 +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 debian-unstable mageia-cauldron 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 mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "1700" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "CPU instruction" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "2500" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "1.44" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "105000" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "61" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "36000" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "libgcrypt/AVX2" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "63000" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "37" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "libsodium/AVX2" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "22000" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "13" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#, no-wrap +msgid "19000" +msgstr "" + +#. type: tbl table +#: debian-bookworm debian-unstable mageia-cauldron 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 +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 +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 +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 +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 +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: 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 +msgid "" +"get the supported features (can be also found under I</sys/fs/btrfs/" +"features>)" +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 +#, 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 +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 +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: TH +#: debian-unstable +#, no-wrap +msgid "Feb 28, 2024" +msgstr "" + +#. type: TH +#: debian-unstable mageia-cauldron +#, no-wrap +msgid "6.6.3" +msgstr "" + +#. type: Plain text +#: 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 +#: debian-unstable +#, no-wrap +msgid "" +"# btrfs filesystem mkswapfile --size 2G swapfile\n" +"# swapon swapfile\n" +msgstr "" + +#. type: Plain text +#: 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 +#: debian-unstable +#, no-wrap +msgid "/path/swapfile none swap defaults 0 0\n" +msgstr "" + +#. type: Plain text +#: 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 +#: debian-unstable +#, no-wrap +msgid "" +"# btrfs inspect-internal map-swapfile -r swapfile\n" +"198122980\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "" +"# swapon /path/swapfile\n" +"swapon: /path/swapfile: swapon failed: Invalid argument\n" +msgstr "" + +#. type: Plain text +#: 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: Plain text +#: debian-unstable +#, no-wrap +msgid "" +"name : sha256\n" +"driver : sha256-generic\n" +"module : kernel\n" +"priority : 100\n" +"\\&...\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "" +"name : sha256\n" +"driver : sha256-avx2\n" +"module : sha256_ssse3\n" +"priority : 170\n" +"\\&...\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "$ mount -o compress=zstd /dev/sdx /mnt\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "$ btrfs filesystem defrag -czstd file\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "" +"$ chattr +c file\n" +"$ btrfs property set file compression zstd\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "" +"$ lsattr file\n" +"---------------------m file\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "" +"modprobe\\ configfs\n" +"modprobe\\ null_blk\\ nr_devices=0\n" +msgstr "" + +#. type: Plain text +#: 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 +#: debian-unstable +#, no-wrap +msgid "rmdir\\ /sys/kernel/config/nullb/mydev\n" +msgstr "" + +#. type: Plain text +#: 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: Plain text +#: 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 +#: debian-unstable +#, no-wrap +msgid "# mknod --mode=600 /dev/btrfs-control c 10 234\n" +msgstr "" + +#. type: Plain text +#: debian-unstable +#, no-wrap +msgid "# btrfs rescue create-control-device\n" +msgstr "" + +#. type: Plain text +#: 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 +#: 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 +#: debian-unstable +#, no-wrap +msgid "Multiple profiles: yes (data, metadata)\n" +msgstr "" + +#. type: Plain text +#: 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 +#: 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 +#: 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 +#: debian-unstable +#, no-wrap +msgid "# btrfs device delete /dev/sda /mnt/mnt1\n" +msgstr "" + +#. type: Plain text +#: 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: TH +#: mageia-cauldron +#, no-wrap +msgid "Jan 09, 2024" +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 "" |