diff options
Diffstat (limited to 'templates/man5/btrfs.5.pot')
| -rw-r--r-- | templates/man5/btrfs.5.pot | 1613 |
1 files changed, 1121 insertions, 492 deletions
diff --git a/templates/man5/btrfs.5.pot b/templates/man5/btrfs.5.pot index 84f318fe..75ef2073 100644 --- a/templates/man5/btrfs.5.pot +++ b/templates/man5/btrfs.5.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2024-03-01 16:53+0100\n" +"POT-Creation-Date: 2024-06-01 05:43+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -24,15 +24,15 @@ msgid "BTRFS" msgstr "" #. type: TH -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux #, no-wrap -msgid "Feb 14, 2024" +msgid "May 03, 2024" msgstr "" #. type: TH -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-rawhide opensuse-tumbleweed #, no-wrap -msgid "6.7.1" +msgid "6.8.1" msgstr "" #. type: SH @@ -275,11 +275,11 @@ 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 +#: archlinux 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 " +"mount options please refer to \\X'tty: link https://man7.org/linux/man-pages/" +"man8/mount.8.html'I<\\%mount(8)>\\X'tty: link' manual page. The options are " "sorted alphabetically (discarding the I<no> prefix)." msgstr "" @@ -325,11 +325,11 @@ msgid "(default: on)" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "Enable/disable support for POSIX Access Control Lists (ACLs). See the " -"B<acl(5)> manual page for more information about ACLs." +"\\X'tty: link https://man7.org/linux/man-pages/man5/acl.5.html'I<\\" +"%acl(5)>\\X'tty: link' manual page for more information about ACLs." msgstr "" #. type: Plain text @@ -605,12 +605,13 @@ 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 +#: archlinux msgid "" "Enable data copy-on-write for newly created files. I<Nodatacow> implies " "I<nodatasum>, and disables I<compression>\\&. All files created under " -"I<nodatacow> are also set the NOCOW file attribute (see B<chattr(1)>)." +"I<nodatacow> are also set the NOCOW file attribute (see \\X'tty: link " +"https://man7.org/linux/man-pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: " +"link')." msgstr "" #. type: Plain text @@ -636,13 +637,13 @@ 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 +#: archlinux msgid "" "Enable data checksumming for newly created files. I<Datasum> implies " "I<datacow>, i.e. the normal mode of operation. All files created under " "I<nodatasum> inherit the \"no checksums\" property, however there\\(aqs no " -"corresponding file attribute (see B<chattr(1)>)." +"corresponding file attribute (see \\X'tty: link https://man7.org/linux/man-" +"pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: link')." msgstr "" #. type: Plain text @@ -1407,14 +1408,14 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "Historically, any user could create a snapshot even if he was not owner of " "the source subvolume, the subvolume deletion has been restricted for that " "reason. The subvolume creation has been restricted but this mount option is " -"still required. This is a usability issue. Since 4.18, the B<rmdir(2)> " -"syscall can delete an empty subvolume just like an ordinary directory. " +"still required. This is a usability issue. Since 4.18, the \\X'tty: link " +"https://man7.org/linux/man-pages/man2/rmdir.2.html'I<\\%rmdir(2)>\\X'tty: " +"link' syscall can delete an empty subvolume just like an ordinary directory. " "Whether this is possible can be detected at runtime, see I<rmdir_subvol> " "feature in I<FILESYSTEM FEATURES>\\&." msgstr "" @@ -1469,12 +1470,12 @@ 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 +#: archlinux msgid "" "The functionality has been removed in 5.11, any stale data created by " -"previous use of the I<inode_cache> option can be removed by I<\\%btrfs " -"rescue clear-ino-cache>\\&." +"previous use of the I<inode_cache> option can be removed by \\X'tty: link " +"#man-rescue-clear-ino-cache'I<\\%btrfs rescue clear-ino-cache>\\X'tty: " +"link'\\&." msgstr "" #. type: SS @@ -1485,11 +1486,11 @@ 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 +#: archlinux msgid "" -"Some of the general mount options from B<mount(8)> that affect BTRFS and are " -"worth mentioning." +"Some of the general mount options from \\X'tty: link https://man7.org/linux/" +"man-pages/man8/mount.8.html'I<\\%mount(8)>\\X'tty: link' that affect BTRFS " +"and are worth mentioning." msgstr "" #. type: TP @@ -1500,8 +1501,7 @@ msgid "B<noatime>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "under read intensive work-loads, specifying I<noatime> significantly " "improves performance because no new access time information needs to be " @@ -1510,7 +1510,8 @@ msgid "" "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/> - " +"each file - in bulk. See also \\X'tty: link https://lwn.net/" +"Articles/499293/'I<\\%https://lwn.net/Articles/499293/>\\X'tty: link' - " "I<Atime and btrfs: a bad combination? (LWN, 2012-05-31)>\\&." msgstr "" @@ -1604,11 +1605,10 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"List of features (see also I<\\%mkfs.btrfs(8)> section I<\\%FILESYSTEM " -"FEATURES>):" +"List of features (see also I<\\%mkfs.btrfs(8)> section \\X'tty: link #man-" +"mkfs-filesystem-features'I<\\%FILESYSTEM FEATURES>\\X'tty: link'):" msgstr "" #. type: TP @@ -1871,6 +1871,22 @@ msgid "extended RAID1 mode with copies on 3 or 4 devices respectively" msgstr "" #. type: TP +#: archlinux fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<raid_stripe_tree>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-rawhide opensuse-tumbleweed +msgid "(since: 6.7)" +msgstr "" + +#. type: Plain text +#: archlinux fedora-rawhide opensuse-tumbleweed +msgid "a separate tree for tracking file extents on RAID profiles" +msgstr "" + +#. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap @@ -1903,12 +1919,12 @@ 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 +#: archlinux 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." +"indicate that \\X'tty: link https://man7.org/linux/man-pages/man2/rmdir.2." +"html'I<\\%rmdir(2)>\\X'tty: link' syscall can delete an empty subvolume just " +"like an ordinary directory. Note that this feature only depends on the " +"kernel version." msgstr "" #. type: TP @@ -1951,6 +1967,17 @@ msgid "number of the highest supported send stream version" msgstr "" #. type: TP +#: archlinux fedora-rawhide opensuse-tumbleweed +#, no-wrap +msgid "B<simple_quota>" +msgstr "" + +#. type: Plain text +#: archlinux fedora-rawhide opensuse-tumbleweed +msgid "simplified quota accounting" +msgstr "" + +#. type: TP #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap @@ -2038,14 +2065,15 @@ msgid "SWAPFILE SUPPORT" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux 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." +"kernel 5.0. Use \\X'tty: link https://man7.org/linux/man-pages/man8/" +"swapon.8.html'I<\\%swapon(8)>\\X'tty: link' to activate it, until then " +"(respectively again after deactivating it with \\X'tty: link https://man7." +"org/linux/man-pages/man8/swapoff.8.html'I<\\%swapoff(8)>\\X'tty: link') " +"it\\(aqs just a normal file (with NODATACOW set), for which the special " +"restrictions for active swapfiles don\\(aqt apply." msgstr "" #. type: Plain text @@ -2165,18 +2193,15 @@ 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 +#: archlinux debian-unstable #, 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 @@ -2188,14 +2213,11 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 -#: opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap msgid "" -"^\".ft C$\n" "# btrfs filesystem mkswapfile --size 2G swapfile\n" "# swapon swapfile\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -2215,15 +2237,12 @@ 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 +#: archlinux debian-unstable #, 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 @@ -2239,13 +2258,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"/path/swapfile none swap defaults 0 0\n" -"^\".ft P$\n" +msgid "/path/swapfile none swap defaults 0 0\n" msgstr "" #. type: Plain text @@ -2304,26 +2319,23 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux 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." +"Since version 6.1 there\\(aqs a command \\X'tty: link #man-inspect-map-" +"swapfile'I<\\%btrfs inspect-internal map-swapfile>\\X'tty: link' that will " +"print the device physical offset and the adjusted value for B</sys/power/" +"resume_offset>\\&. Note that the value is divided by page size, i.e. " +"it\\(aqs not the offset itself." msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -2334,14 +2346,11 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap msgid "" -"^\".ft C$\n" "# btrfs inspect-internal map-swapfile -r swapfile\n" "198122980\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -2377,14 +2386,11 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -2396,14 +2402,11 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -2509,7 +2512,7 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed msgid "" "Approximate relative performance of the algorithms, measured against CRC32C " "using implementations on a 11th gen 3.6GHz intel CPU:" @@ -2519,35 +2522,35 @@ msgstr "" #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed #, no-wrap -msgid "_" +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 "Digest" +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 "Cycles/4KiB" +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 "Ratio" +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 "Implementation" +msgid "_" msgstr "" #. type: tbl table @@ -2558,7 +2561,7 @@ msgid "CRC32C" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "470" msgstr "" @@ -2571,7 +2574,7 @@ msgid "1.00" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "CPU instruction, PCL combination" msgstr "" @@ -2584,13 +2587,13 @@ msgid "XXHASH" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "870" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "1.9" msgstr "" @@ -2610,103 +2613,103 @@ msgid "SHA256" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "7600" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "16" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "libgcrypt" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "8500" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "18" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "openssl" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "8700" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "botan" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "32000" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "68" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "builtin, CPU instruction" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "37000" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "78" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "libsodium" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "78000" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "166" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "builtin, reference impl." msgstr "" @@ -2719,7 +2722,7 @@ msgid "BLAKE2b" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "10000" msgstr "" @@ -2732,79 +2735,79 @@ msgid "21" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "builtin/AVX2" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "10900" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "23" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "13500" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "29" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "builtin/SSE41" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "13700" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "14100" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "30" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "14500" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "31" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "kcapi" msgstr "" #. type: tbl table -#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed #, no-wrap msgid "34" msgstr "" @@ -2824,17 +2827,14 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -2844,17 +2844,14 @@ 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 +#: archlinux debian-unstable #, 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 @@ -2996,13 +2993,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"$ mount -o compress=zstd /dev/sdx /mnt\n" -"^\".ft P$\n" +msgid "$ mount -o compress=zstd /dev/sdx /mnt\n" msgstr "" #. type: Plain text @@ -3017,13 +3010,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"$ btrfs filesystem defrag -czstd file\n" -"^\".ft P$\n" +msgid "$ btrfs filesystem defrag -czstd file\n" msgstr "" #. type: Plain text @@ -3044,14 +3033,11 @@ 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 +#: archlinux debian-unstable #, no-wrap msgid "" -"^\".ft C$\n" "$ chattr +c file\n" "$ btrfs property set file compression zstd\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -3165,14 +3151,11 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap msgid "" -"^\".ft C$\n" "$ lsattr file\n" "---------------------m file\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -3219,13 +3202,12 @@ msgid "COMPATIBILITY" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux fedora-40 fedora-rawhide 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." +"I<nodatacow>\\&. Direct IO read works on compressed files but will fall back " +"to buffered writes and leads to no compression even if force compression is " +"set. Currently I<nodatasum> and compression don\\(aqt work together." msgstr "" #. type: Plain text @@ -4368,12 +4350,12 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "The symlink target may not be a valid path, i.e. the path name components " "can exceed the limits (NAME_MAX), there\\(aqs no content validation at " -"B<symlink(3)> creation." +"\\X'tty: link https://man7.org/linux/man-pages/man3/symlink.3.html'I<\\" +"%symlink(3)>\\X'tty: link' creation." msgstr "" #. type: TP @@ -4501,19 +4483,19 @@ msgid "BOOTLOADER SUPPORT" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"GRUB2 (I<\\%https://www.gnu.org/software/grub>) has the most advanced " -"support of booting from BTRFS with respect to features." +"GRUB2 (\\X'tty: link https://www.gnu.org/software/grub'I<\\%https://www.gnu." +"org/software/grub>\\X'tty: link') has the most advanced support of booting " +"from BTRFS with respect to features." msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux 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." +"U-Boot (\\X'tty: link https://www.denx.de/wiki/U-Boot/'I<\\%https://www.denx." +"de/wiki/U-Boot/>\\X'tty: link') has decent support for booting but not all " +"BTRFS features are implemented, check the documentation." msgstr "" #. type: Plain text @@ -4543,24 +4525,25 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux 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" +"I<attributes>: \\X'tty: link https://man7.org/linux/man-pages/man1/chattr.1." +"html'I<\\%chattr(1)>\\X'tty: link' or \\X'tty: link https://man7.org/linux/" +"man-pages/man1/lsattr.1.html'I<\\%lsattr(1)>\\X'tty: link' utilities (the " +"ioctls are FS_IOC_GETFLAGS and FS_IOC_SETFLAGS), due to the ioctl names the " +"attributes are also called flags" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "I<xflags>: to distinguish from the previous, it\\(aqs extended flags, with " "tunable bits similar to the attributes but extensible and new bits will be " "added in the future (the ioctls are FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR " "but they are not related to extended attributes that are also called " "xattrs), there\\(aqs no standard tool to change the bits, there\\(aqs " -"support in B<xfs_io(8)> as command B<xfs_io -c chattr>" +"support in \\X'tty: link https://man7.org/linux/man-pages/man8/xfs_io.8." +"html'I<\\%xfs_io(8)>\\X'tty: link' as command B<xfs_io -c chattr>" msgstr "" #. type: SS @@ -4656,11 +4639,11 @@ msgid "B<d>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux 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" +"I<no dump>, makes sense with 3rd party tools like \\X'tty: link https://man7." +"org/linux/man-pages/man8/dump.8.html'I<\\%dump(8)>\\X'tty: link', on BTRFS " +"the attribute can be set/unset but no other special handling is done" msgstr "" #. type: TP @@ -4671,11 +4654,11 @@ msgid "B<D>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<synchronous directory updates>, for more details search B<open(2)> for " -"I<O_SYNC> and I<O_DSYNC>" +"I<synchronous directory updates>, for more details search \\X'tty: link " +"https://man7.org/linux/man-pages/man2/open.2.html'I<\\%open(2)>\\X'tty: " +"link' for I<O_SYNC> and I<O_DSYNC>" msgstr "" #. type: TP @@ -4702,12 +4685,12 @@ msgid "B<m>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux 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)" +"compression mount options will not affect this file. (\\X'tty: link https://" +"man7.org/linux/man-pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: link' " +"support added in 1.46.2)" msgstr "" #. type: Plain text @@ -4726,19 +4709,19 @@ msgid "B<S>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<synchronous updates>, for more details search B<open(2)> for I<O_SYNC> and " -"I<O_DSYNC>" +"I<synchronous updates>, for more details search \\X'tty: link https://man7." +"org/linux/man-pages/man2/open.2.html'I<\\%open(2)>\\X'tty: link' for " +"I<O_SYNC> and I<O_DSYNC>" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "No other attributes are supported. For the complete list please refer to " -"the B<chattr(1)> manual page." +"the \\X'tty: link https://man7.org/linux/man-pages/man1/chattr.1.html'I<\\" +"%chattr(1)>\\X'tty: link' manual page." msgstr "" #. type: SS @@ -4749,11 +4732,11 @@ msgid "XFLAGS" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "There\\(aqs an overlap of letters assigned to the bits with the attributes, " -"this list refers to what B<xfs_io(8)> provides:" +"this list refers to what \\X'tty: link https://man7.org/linux/man-pages/man8/" +"xfs_io.8.html'I<\\%xfs_io(8)>\\X'tty: link' provides:" msgstr "" #. type: Plain text @@ -4801,8 +4784,7 @@ msgid "ZONED MODE" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "Since version 5.12 btrfs supports so called I<zoned mode>\\&. This is a " "special on-disk format and allocation/write strategy that\\(aqs friendly to " @@ -4810,7 +4792,8 @@ msgid "" "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> ." +"whole architecture at \\X'tty: link https://zonedstorage.io'I<\\%https://" +"zonedstorage.io>\\X'tty: link' ." msgstr "" #. type: Plain text @@ -5023,9 +5006,12 @@ 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>)" +#: archlinux +msgid "" +"Ultrastar® DC ZN540 NVMe ZNS SSD (\\X'tty: link https://documents." +"westerndigital.com/content/dam/doc-library/en_us/assets/public/western-" +"digital/collateral/product-brief/product-brief-ultrastar-dc-zn540.pdf'I<\\" +"%product brief>\\X'tty: link')" msgstr "" #. type: SS @@ -5056,14 +5042,11 @@ msgid "Setup:" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 -#: opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap msgid "" -"^\".ft C$\n" "modprobe\\ configfs\n" "modprobe\\ null_blk\\ nr_devices=0\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -5076,11 +5059,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 -#: opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap msgid "" -"^\".ft C$\n" "cd\\ /sys/kernel/config/nullb/\n" "mkdir\\ mydev\n" "cd\\ mydev\n" @@ -5089,7 +5070,6 @@ msgid "" "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 @@ -5107,13 +5087,9 @@ msgid "Remove the device:" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 -#: opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"rmdir\\ /sys/kernel/config/nullb/mydev\n" -"^\".ft P$\n" +msgid "rmdir\\ /sys/kernel/config/nullb/mydev\n" msgstr "" #. type: Plain text @@ -5125,26 +5101,22 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux 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:" +"operations \\X'tty: link https://github.com/kdave/nullb.git'I<\\%https://" +"github.com/kdave/nullb.git>\\X'tty: link', the above commands become:" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 -#: opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -5155,14 +5127,14 @@ msgid "Emulated: TCMU runner" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "TCMU is a framework to emulate SCSI devices in userspace, providing various " "backends for the storage, with zoned support as well. A file-backed zoned " "device can provide more options for larger storage and zone size. Please " -"follow the instructions at I<\\%https://zonedstorage.io/projects/tcmu-runner/" -"> ." +"follow the instructions at \\X'tty: link https://zonedstorage.io/projects/" +"tcmu-runner/'I<\\%https://zonedstorage.io/projects/tcmu-runner/>\\X'tty: " +"link' ." msgstr "" #. type: SS @@ -5221,12 +5193,12 @@ msgid "Status, stability, reporting bugs" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "The zoned mode has been released in 5.12 and there are still some rough " -"edges and corner cases one can hit during testing. Please report bugs to I<\\" -"%https://github.com/naota/linux/issues/> ." +"edges and corner cases one can hit during testing. Please report bugs to " +"\\X'tty: link https://github.com/naota/linux/issues/'I<\\%https://github.com/" +"naota/linux/issues/>\\X'tty: link' ." msgstr "" #. type: SS @@ -5237,48 +5209,49 @@ 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>" +#: archlinux +msgid "" +"\\X'tty: link https://zonedstorage.io'I<\\%https://zonedstorage.io>\\X'tty: " +"link'" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://zonedstorage.io/projects/libzbc/> -- I<libzbc> is library and " +"\\X'tty: link https://zonedstorage.io/projects/libzbc/'I<\\%https://" +"zonedstorage.io/projects/libzbc/>\\X'tty: link' -- I<libzbc> is library and " "set of tools to directly manipulate devices with ZBC/ZAC support" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://zonedstorage.io/projects/libzbd/> -- I<libzbd> uses the kernel " +"\\X'tty: link https://zonedstorage.io/projects/libzbd/'I<\\%https://" +"zonedstorage.io/projects/libzbd/>\\X'tty: link' -- I<libzbd> uses the kernel " "provided zoned block device interface based on the ioctl() system calls" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://hddscan.com/blog/2020/hdd-wd-smr.html> -- some details about " +"\\X'tty: link https://hddscan.com/blog/2020/hdd-wd-smr.html'I<\\%https://" +"hddscan.com/blog/2020/hdd-wd-smr.html>\\X'tty: link' -- some details about " "exact device types" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://lwn.net/Articles/853308/> -- I<Btrfs on zoned block devices>" +"\\X'tty: link https://lwn.net/Articles/853308/'I<\\%https://lwn.net/" +"Articles/853308/>\\X'tty: link' -- I<Btrfs on zoned block devices>" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://www.usenix.org/conference/vault20/presentation/bjorling> -- " -"Zone Append: A New Way of Writing to Zoned Storage" +"\\X'tty: link https://www.usenix.org/conference/vault20/presentation/" +"bjorling'I<\\%https://www.usenix.org/conference/vault20/presentation/" +"bjorling>\\X'tty: link' -- Zone Append: A New Way of Writing to Zoned Storage" msgstr "" #. type: SH @@ -5298,14 +5271,11 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -5359,13 +5329,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"# mknod --mode=600 /dev/btrfs-control c 10 234\n" -"^\".ft P$\n" +msgid "# mknod --mode=600 /dev/btrfs-control c 10 234\n" msgstr "" #. type: Plain text @@ -5375,13 +5341,9 @@ 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 +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"# btrfs rescue create-control-device\n" -"^\".ft P$\n" +msgid "# btrfs rescue create-control-device\n" msgstr "" #. type: Plain text @@ -5413,15 +5375,12 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -5431,11 +5390,9 @@ 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 +#: archlinux debian-unstable #, 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" @@ -5445,7 +5402,6 @@ msgid "" "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 @@ -5509,13 +5465,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"Multiple profiles: yes (data, metadata)\n" -"^\".ft P$\n" +msgid "Multiple profiles: yes (data, metadata)\n" msgstr "" #. type: SH @@ -5526,8 +5478,7 @@ msgid "SEEDING DEVICE" msgstr "" #. type: Plain text -#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" "The COW mechanism and multiple devices under one hood enable an interesting " "concept, called a seeding device: extending a read-only filesystem on a " @@ -5536,8 +5487,11 @@ msgid "" "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." +"similar functionality, like \\X'tty: link https://en.wikipedia.org/wiki/" +"Union_mount'I<\\%unionmount>\\X'tty: link', \\X'tty: link https://en." +"wikipedia.org/wiki/OverlayFS'I<\\%overlayfs>\\X'tty: link' or \\X'tty: link " +"https://en.wikipedia.org/wiki/Qcow#qcow2'I<\\%qcow2>\\X'tty: link' image " +"snapshot." msgstr "" #. type: Plain text @@ -5606,11 +5560,9 @@ 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 +#: archlinux debian-unstable #, no-wrap msgid "" -"^\".ft C$\n" "# mkfs.btrfs /dev/sda\n" "# mount /dev/sda /mnt/mnt1\n" "\\&... fill mnt1 with data\n" @@ -5625,8 +5577,7 @@ msgid "# btrfstune -S 1 /dev/sda\n" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 -#: opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap msgid "" "# mount /dev/sda /mnt/mnt1\n" @@ -5634,7 +5585,6 @@ msgid "" "# umount /mnt/mnt1\n" "# mount /dev/sdb /mnt/mnt1\n" "\\&... /mnt/mnt1 is now writable\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -5646,17 +5596,14 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 -#: opensuse-tumbleweed +#: archlinux debian-unstable #, 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 @@ -5668,13 +5615,9 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm fedora-40 fedora-rawhide mageia-cauldron -#: opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux debian-unstable #, no-wrap -msgid "" -"^\".ft C$\n" -"# btrfs device delete /dev/sda /mnt/mnt1\n" -"^\".ft P$\n" +msgid "# btrfs device delete /dev/sda /mnt/mnt1\n" msgstr "" #. type: Plain text @@ -5769,8 +5712,7 @@ 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 +#: archlinux debian-unstable #, no-wrap msgid "" "# mount /dev/sdb /mnt/mnt1\n" @@ -5778,7 +5720,6 @@ msgid "" "# mount -o remount,rw /mnt/mnt1\n" "\\&... /mnt/mnt1 is now writable\n" "# umount /mnt/mnt1\n" -"^\".ft P$\n" msgstr "" #. type: Plain text @@ -6199,15 +6140,40 @@ msgid "" msgstr "" #. type: Plain text +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"Block group profiles with redundancy (like RAID1) will not protect against " +"memory errors as the blocks are first stored in memory before they are " +"written to the devices from the same source." +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"A filesystem mounted read-only will not affect the underlying block device " +"in almost 100% (with highly unlikely exceptions). The exception is a tree-" +"log that needs to be replayed during mount (and before the read-only mount " +"takes place), working memory is needed for that and that can be affected by " +"bit flips. There\\(aqs a theoretical case where bit flip changes the " +"filesystem status from read-only to read-write." +msgstr "" + +#. type: Plain text #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed msgid "Further reading:" msgstr "" #. type: Plain text -#: archlinux 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>" +#: archlinux +msgid "" +"\\X'tty: link https://en.wikipedia.org/wiki/Row_hammer'I<\\%https://en." +"wikipedia.org/wiki/Row_hammer>\\X'tty: link'" +msgstr "" + +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "memory overclocking, XMP, potential risks" msgstr "" #. type: Plain text @@ -6233,6 +6199,14 @@ msgid "" "consistency checks" msgstr "" +#. type: Plain text +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"newly built systems should be tested before being put to production use, " +"ideally start a IO/CPU load that will be run on such system later; namely " +"systems that will utilize overclocking or special performance features" +msgstr "" + #. type: SS #: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide #: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed @@ -6331,8 +6305,7 @@ 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 +#: archlinux fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" "The mechanism of information storage is different from HDDs and this affects " "the failure mode as well. The data are stored in cells grouped in large " @@ -6341,7 +6314,7 @@ msgid "" "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 " +"cells. Due to the additional processing there are measures to verify the " "data e.g. by ECC codes." msgstr "" @@ -6443,34 +6416,35 @@ msgid "" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://www.snia.org/educational-library/ssd-and-deduplication-end-" -"spinning-disk-2012>" +"\\X'tty: link https://www.snia.org/educational-library/ssd-and-deduplication-" +"end-spinning-disk-2012'I<\\%https://www.snia.org/educational-library/ssd-and-" +"deduplication-end-spinning-disk-2012>\\X'tty: link'" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://www.snia.org/educational-library/realities-solid-state-" -"storage-2013-2013>" +"\\X'tty: link https://www.snia.org/educational-library/realities-solid-state-" +"storage-2013-2013'I<\\%https://www.snia.org/educational-library/realities-" +"solid-state-storage-2013-2013>\\X'tty: link'" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://www.snia.org/educational-library/ssd-performance-primer-2013>" +"\\X'tty: link https://www.snia.org/educational-library/ssd-performance-" +"primer-2013'I<\\%https://www.snia.org/educational-library/ssd-performance-" +"primer-2013>\\X'tty: link'" msgstr "" #. type: Plain text -#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide -#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#: archlinux msgid "" -"I<\\%https://www.snia.org/educational-library/how-controllers-maximize-ssd-" -"life-2013>" +"\\X'tty: link https://www.snia.org/educational-library/how-controllers-" +"maximize-ssd-life-2013'I<\\%https://www.snia.org/educational-library/how-" +"controllers-maximize-ssd-life-2013>\\X'tty: link'" msgstr "" #. type: Plain text @@ -6525,15 +6499,17 @@ msgid "" 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>" +#: archlinux +msgid "" +"\\X'tty: link https://en.wikipedia.org/wiki/NVM_Express'I<\\%https://en." +"wikipedia.org/wiki/NVM_Express>\\X'tty: link'" msgstr "" #. type: Plain text -#: archlinux 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>" +#: archlinux +msgid "" +"\\X'tty: link https://www.smartmontools.org/wiki/NVMe_Support'I<\\%https://" +"www.smartmontools.org/wiki/NVMe_Support>\\X'tty: link'" msgstr "" #. type: SS @@ -6624,11 +6600,17 @@ 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 +#: archlinux 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)>" +"\\X'tty: link https://man7.org/linux/man-pages/man5/acl.5.html'I<\\" +"%acl(5)>\\X'tty: link', I<\\%btrfs(8)>, \\X'tty: link https://man7.org/linux/" +"man-pages/man1/chattr.1.html'I<\\%chattr(1)>\\X'tty: link', \\X'tty: link " +"https://man7.org/linux/man-pages/man8/fstrim.8.html'I<\\%fstrim(8)>\\X'tty: " +"link', \\X'tty: link https://man7.org/linux/man-pages/man2/ioctl.2.html'I<\\" +"%ioctl(2)>\\X'tty: link', I<\\%mkfs.btrfs(8)>, \\X'tty: link https://man7." +"org/linux/man-pages/man8/mount.8.html'I<\\%mount(8)>\\X'tty: link', \\X'tty: " +"link https://man7.org/linux/man-pages/man8/swapon.8.html'I<\\" +"%swapon(8)>\\X'tty: link'" msgstr "" #. type: TH @@ -6644,6 +6626,21 @@ msgid "6.2" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"This section describes mount options specific to BTRFS. For the generic " +"mount options please refer to B<mount(8)> manual page. The options are " +"sorted alphabetically (discarding the I<no> prefix)." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"Enable/disable support for POSIX Access Control Lists (ACLs). See the " +"B<acl(5)> manual page for more information about ACLs." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "Enable automatic file defragmentation. When enabled, small random writes " @@ -6660,6 +6657,23 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"Enable data copy-on-write for newly created files. I<Nodatacow> implies " +"I<nodatasum>, and disables I<compression>\\&. All files created under " +"I<nodatacow> are also set the NOCOW file attribute (see B<chattr(1)>)." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"Enable data checksumming for newly created files. I<Datasum> implies " +"I<datacow>, i.e. the normal mode of operation. All files created under " +"I<nodatasum> inherit the \"no checksums\" property, however there\\(aqs no " +"corresponding file attribute (see B<chattr(1)>)." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "Allow mounts with less devices than the RAID profile constraints require. A " @@ -6747,6 +6761,18 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"Historically, any user could create a snapshot even if he was not owner of " +"the source subvolume, the subvolume deletion has been restricted for that " +"reason. The subvolume creation has been restricted but this mount option is " +"still required. This is a usability issue. Since 4.18, the B<rmdir(2)> " +"syscall can delete an empty subvolume just like an ordinary directory. " +"Whether this is possible can be detected at runtime, see I<rmdir_subvol> " +"feature in I<FILESYSTEM FEATURES>\\&." +msgstr "" + +#. type: Plain text #: debian-bookworm opensuse-leap-15-6 msgid "" "The functionality has been removed in 5.11, any stale data created by " @@ -6755,6 +6781,28 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"Some of the general mount options from B<mount(8)> that affect BTRFS and are " +"worth mentioning." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"under read intensive work-loads, specifying I<noatime> significantly " +"improves performance because no new access time information needs to be " +"written. Without this option, the default is I<relatime>, which only reduces " +"the number of inode atime updates in comparison to the traditional " +"I<strictatime>\\&. The worst case for atime updates under I<relatime> occurs " +"when many files are read whose atime is older than 24 h and which are " +"freshly snapshotted. In that case the atime is updated and COW happens - for " +"each file - in bulk. See also I<\\%https://lwn.net/Articles/499293/> - " +"I<Atime and btrfs: a bad combination? (LWN, 2012-05-31)>\\&." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "The features of a filesystem (with a given UUID) are listed in I</sys/fs/" @@ -6779,6 +6827,14 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"indicate that B<rmdir(2)> syscall can delete an empty subvolume just like an " +"ordinary directory. Note that this feature only depends on the kernel " +"version." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "list of checksum algorithms supported by the kernel module, the respective " @@ -6829,6 +6885,21 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# truncate -s 0 swapfile\n" +"# chattr +C swapfile\n" +"# fallocate -l 2G swapfile\n" +"# chmod 0600 swapfile\n" +"# mkswap swapfile\n" +"# swapon swapfile\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm #, no-wrap msgid "" @@ -6844,6 +6915,28 @@ msgid "The file will appear in I</proc/swaps>:" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# cat /proc/swaps\n" +"Filename Type Size Used Priority\n" +"/path/swapfile file 2097152 0 -2\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"/path/swapfile none swap defaults 0 0\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "Since version 6.1 there\\(aqs a command B<btrfs inspect-internal map-" @@ -6853,6 +6946,30 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# btrfs filesystem mkswapfile swapfile\n" +"# btrfs inspect-internal map-swapfile swapfile\n" +"Physical start: 811511726080\n" +"Resume offset: 198122980\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# btrfs inspect-internal map-swapfile -r swapfile\n" +"198122980\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "The command I<map-swapfile> also verifies all the requirements, i.e. no " @@ -6867,98 +6984,120 @@ msgid "" msgstr "" #. type: Plain text -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# swapon /path/swapfile\n" +"swapon: /path/swapfile: swapon failed: Invalid argument\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# journalctl -t kernel | grep swapfile\n" +"kernel: BTRFS warning (device sda): swapfile must have single data profile\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable opensuse-leap-15-6 msgid "" "Approximate relative performance of the algorithms, measured against CRC32C " "using reference software implementations on a 3.5GHz intel CPU:" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "1700" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "CPU instruction" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "2500" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "1.44" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "105000" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "61" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "36000" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "libgcrypt/AVX2" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "63000" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "37" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "libsodium/AVX2" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "22000" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "13" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "19000" msgstr "" #. type: tbl table -#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: debian-bookworm debian-unstable opensuse-leap-15-6 #, no-wrap msgid "11" msgstr "" @@ -6977,6 +7116,34 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"name : sha256\n" +"driver : sha256-generic\n" +"module : kernel\n" +"priority : 100\n" +"\\&...\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"name : sha256\n" +"driver : sha256-avx2\n" +"module : sha256_ssse3\n" +"priority : 170\n" +"\\&...\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "Typically the compression can be enabled on the whole filesystem, specified " @@ -6986,6 +7153,57 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"$ mount -o compress=zstd /dev/sdx /mnt\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"$ btrfs filesystem defrag -czstd file\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"$ chattr +c file\n" +"$ btrfs property set file compression zstd\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"$ lsattr file\n" +"---------------------m file\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"Compression is done using the COW mechanism so it\\(aqs incompatible with " +"I<nodatacow>\\&. Direct IO works on compressed files but will fall back to " +"buffered writes and leads to recompression. Currently I<nodatasum> and " +"compression don\\(aqt work together." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "The top level path is I</sys/fs/btrfs/>, and the main directory layout is " @@ -7072,6 +7290,14 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"The symlink target may not be a valid path, i.e. the path name components " +"can exceed the limits (NAME_MAX), there\\(aqs no content validation at " +"B<symlink(3)> creation." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "minimum number: 256 (for subvolumes), regular files and directories: 257, " @@ -7086,6 +7312,14 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"GRUB2 (I<\\%https://www.gnu.org/software/grub>) has the most advanced " +"support of booting from BTRFS with respect to features." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "U-boot (I<\\%https://www.denx.de/wiki/U-Boot/>) has decent support for " @@ -7101,12 +7335,80 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<attributes>: B<chattr(1)> or B<lsattr(1)> utilities (the ioctls are " +"FS_IOC_GETFLAGS and FS_IOC_SETFLAGS), due to the ioctl names the attributes " +"are also called flags" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<xflags>: to distinguish from the previous, it\\(aqs extended flags, with " +"tunable bits similar to the attributes but extensible and new bits will be " +"added in the future (the ioctls are FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR " +"but they are not related to extended attributes that are also called " +"xattrs), there\\(aqs no standard tool to change the bits, there\\(aqs " +"support in B<xfs_io(8)> as command B<xfs_io -c chattr>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<no dump>, makes sense with 3rd party tools like B<dump(8)>, on BTRFS the " +"attribute can be set/unset but no other special handling is done" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<synchronous directory updates>, for more details search B<open(2)> for " +"I<O_SYNC> and I<O_DSYNC>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<no compression>, permanently turn off compression on the given file. Any " +"compression mount options will not affect this file. (B<chattr> support " +"added in 1.46.2)" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"I<synchronous updates>, for more details search B<open(2)> for I<O_SYNC> and " +"I<O_DSYNC>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"No other attributes are supported. For the complete list please refer to " +"the B<chattr(1)> manual page." +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "There\\(aqs overlap of letters assigned to the bits with the attributes, " "this list refers to what B<xfs_io(8)> provides:" msgstr "" +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Since version 5.12 btrfs supports so called I<zoned mode>\\&. This is a " +"special on-disk format and allocation/write strategy that\\(aqs friendly to " +"zoned devices. In short, a device is partitioned into fixed-size zones and " +"each zone can be updated by append-only manner, or reset. As btrfs has no " +"fixed data structures, except the super blocks, the zoned mode only requires " +"block placement that follows the device constraints. You can learn about the " +"whole architecture at I<\\%https://zonedstorage.io> ." +msgstr "" + #. type: TP #: debian-bookworm #, no-wrap @@ -7127,6 +7429,17 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"$ ls -l /dev/btrfs-control\n" +"crw------- 1 root root 10, 234 Jan 1 12:00 /dev/btrfs-control\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "get the supported features (can be also found under I</sys/fs/btrfs/" @@ -7134,6 +7447,66 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# mknod --mode=600 /dev/btrfs-control c 10 234\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# btrfs rescue create-control-device\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"WARNING: Multiple block group profiles detected, see \\(aqman btrfs(5)\\(aq.\n" +"WARNING: Data: single, raid1\n" +"WARNING: Metadata: single, raid1\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"WARNING: Multiple block group profiles detected, see \\(aqman btrfs(5)\\(aq.\n" +"WARNING: Data: single, raid1\n" +"WARNING: Metadata: single, raid1\n" +"Data, RAID1: total=832.00MiB, used=0.00B\n" +"Data, single: total=1.63GiB, used=0.00B\n" +"System, single: total=4.00MiB, used=16.00KiB\n" +"Metadata, single: total=8.00MiB, used=112.00KiB\n" +"Metadata, RAID1: total=64.00MiB, used=32.00KiB\n" +"GlobalReserve, single: total=16.25MiB, used=0.00B\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"Multiple profiles: yes (data, metadata)\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "The COW mechanism and multiple devices under one hood enable an interesting " @@ -7165,6 +7538,18 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# mkfs.btrfs /dev/sda\n" +"# mount /dev/sda /mnt/mnt1\n" +"\\&... fill mnt1 with data\n" +"# umount /mnt/mnt1\n" +msgstr "" + +#. type: Plain text #: debian-bookworm #, no-wrap msgid "" @@ -7202,6 +7587,16 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"^\".ft C$\n" +"# btrfs device delete /dev/sda /mnt/mnt1\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "As the contents originated in the seeding device, it\\(aqs possible to turn " @@ -7221,6 +7616,19 @@ msgid "" msgstr "" #. type: Plain text +#: debian-bookworm fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"# mount /dev/sdb /mnt/mnt1\n" +"# btrfs device add /dev/sdc /mnt\n" +"# mount -o remount,rw /mnt/mnt1\n" +"\\&... /mnt/mnt1 is now writable\n" +"# umount /mnt/mnt1\n" +"^\".ft P$\n" +msgstr "" + +#. type: Plain text #: debian-bookworm msgid "" "When RAID56 is on the same filesystem with different raid profiles, the " @@ -7229,238 +7637,452 @@ msgid "" "type (e.g. RAID5 for data) the reporting is accurate." msgstr "" +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<\\%https://en.wikipedia.org/wiki/Row_hammer>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"The mechanism of information storage is different from HDDs and this affects " +"the failure mode as well. The data are stored in cells grouped in large " +"blocks with limited number of resets and other write constraints. The " +"firmware tries to avoid unnecessary resets and performs optimizations to " +"maximize the storage media lifetime. The known techniques are deduplication " +"(blocks with same fingerprint/hash are mapped to same physical block), " +"compression or internal remapping and garbage collection of used memory " +"cells. Due to the additional processing there are measures to verity the " +"data e.g. by ECC codes." +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<\\%https://www.snia.org/educational-library/ssd-and-deduplication-end-" +"spinning-disk-2012>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<\\%https://www.snia.org/educational-library/realities-solid-state-" +"storage-2013-2013>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<\\%https://www.snia.org/educational-library/ssd-performance-primer-2013>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<\\%https://www.snia.org/educational-library/how-controllers-maximize-ssd-" +"life-2013>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<\\%https://en.wikipedia.org/wiki/NVM_Express>" +msgstr "" + +#. type: Plain text +#: debian-bookworm debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<\\%https://www.smartmontools.org/wiki/NVMe_Support>" +msgstr "" + +#. Generated by docutils manpage writer. +#. type: Plain text +#: debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +msgid "" +"B<acl(5)>, I<\\%btrfs(8)>, B<chattr(1)>, B<fstrim(8)>, B<ioctl(2)>, I<\\" +"%mkfs.btrfs(8)>, B<mount(8)>, B<swapon(8)>" +msgstr "" + #. type: TH #: debian-unstable #, no-wrap -msgid "Feb 28, 2024" +msgid "Mar 24, 2024" msgstr "" #. type: TH -#: debian-unstable mageia-cauldron +#: debian-unstable #, no-wrap msgid "6.6.3" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-tumbleweed 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" +"The functionality has been removed in 5.11, any stale data created by " +"previous use of the I<inode_cache> option can be removed by I<\\%btrfs " +"rescue clear-ino-cache>\\&." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"# btrfs filesystem mkswapfile --size 2G swapfile\n" -"# swapon swapfile\n" +"List of features (see also I<\\%mkfs.btrfs(8)> section I<\\%FILESYSTEM " +"FEATURES>):" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable mageia-cauldron opensuse-leap-15-6 msgid "" -"# cat /proc/swaps\n" -"Filename Type Size Used Priority\n" -"/path/swapfile file 2097152 0 -2\n" +"A swapfile, when active, is a file-backed swap area. It is supported since " +"kernel 5.0. Use B<swapon(8)> to activate it, until then (respectively again " +"after deactivating it with B<swapoff(8)>) it\\(aqs just a normal file (with " +"NODATACOW set), for which the special restrictions for active swapfiles " +"don\\(aqt apply." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap -msgid "/path/swapfile none swap defaults 0 0\n" +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"Since version 6.1 there\\(aqs a command I<\\%btrfs inspect-internal map-" +"swapfile> that will print the device physical offset and the adjusted value " +"for B</sys/power/resume_offset>\\&. Note that the value is divided by page " +"size, i.e. it\\(aqs not the offset itself." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"# btrfs filesystem mkswapfile swapfile\n" -"# btrfs inspect-internal map-swapfile swapfile\n" -"Physical start: 811511726080\n" -"Resume offset: 198122980\n" +"U-Boot (I<\\%https://www.denx.de/wiki/U-Boot/>) has decent support for " +"booting but not all BTRFS features are implemented, check the documentation." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable mageia-cauldron opensuse-leap-15-6 msgid "" -"# btrfs inspect-internal map-swapfile -r swapfile\n" -"198122980\n" +"There\\(aqs an overlap of letters assigned to the bits with the attributes, " +"this list refers to what B<xfs_io(8)> provides:" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "Ultrastar® DC ZN540 NVMe ZNS SSD (I<\\%product brief>)" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"# swapon /path/swapfile\n" -"swapon: /path/swapfile: swapon failed: Invalid argument\n" +"For convenience, there\\(aqs a script wrapping the basic null_blk management " +"operations I<\\%https://github.com/kdave/nullb.git>, the above commands " +"become:" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"# journalctl -t kernel | grep swapfile\n" -"kernel: BTRFS warning (device sda): swapfile must have single data profile\n" +"TCMU is a framework to emulate SCSI devices in userspace, providing various " +"backends for the storage, with zoned support as well. A file-backed zoned " +"device can provide more options for larger storage and zone size. Please " +"follow the instructions at I<\\%https://zonedstorage.io/projects/tcmu-runner/" +"> ." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"name : sha256\n" -"driver : sha256-generic\n" -"module : kernel\n" -"priority : 100\n" -"\\&...\n" +"The zoned mode has been released in 5.12 and there are still some rough " +"edges and corner cases one can hit during testing. Please report bugs to I<\\" +"%https://github.com/naota/linux/issues/> ." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "I<\\%https://zonedstorage.io>" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"name : sha256\n" -"driver : sha256-avx2\n" -"module : sha256_ssse3\n" -"priority : 170\n" -"\\&...\n" +"I<\\%https://zonedstorage.io/projects/libzbc/> -- I<libzbc> is library and " +"set of tools to directly manipulate devices with ZBC/ZAC support" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap -msgid "$ mount -o compress=zstd /dev/sdx /mnt\n" +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"I<\\%https://zonedstorage.io/projects/libzbd/> -- I<libzbd> uses the kernel " +"provided zoned block device interface based on the ioctl() system calls" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap -msgid "$ btrfs filesystem defrag -czstd file\n" +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"I<\\%https://hddscan.com/blog/2020/hdd-wd-smr.html> -- some details about " +"exact device types" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"$ chattr +c file\n" -"$ btrfs property set file compression zstd\n" +"I<\\%https://lwn.net/Articles/853308/> -- I<Btrfs on zoned block devices>" msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed msgid "" -"$ lsattr file\n" -"---------------------m file\n" +"I<\\%https://www.usenix.org/conference/vault20/presentation/bjorling> -- " +"Zone Append: A New Way of Writing to Zoned Storage" msgstr "" #. type: Plain text -#: debian-unstable +#: debian-unstable fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"The COW mechanism and multiple devices under one hood enable an interesting " +"concept, called a seeding device: extending a read-only filesystem on a " +"device with another device that captures all writes. For example imagine an " +"immutable golden image of an operating system enhanced with another device " +"that allows to use the data from the golden image and normal operation. " +"This idea originated on CD-ROMs with base OS and allowing to use them for " +"live systems, but this became obsolete. There are technologies providing " +"similar functionality, like I<\\%unionmount>, I<\\%overlayfs> or I<\\%qcow2> " +"image snapshot." +msgstr "" + +#. type: TH +#: fedora-40 fedora-rawhide +#, no-wrap +msgid "Mar 26, 2024" +msgstr "" + +#. type: TH +#: fedora-40 #, no-wrap +msgid "6.8" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" -"modprobe\\ configfs\n" -"modprobe\\ null_blk\\ nr_devices=0\n" +"This section describes mount options specific to BTRFS. For the generic " +"mount options please refer to I<\\%mount(8)> manual page. The options are " +"sorted alphabetically (discarding the I<no> prefix)." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: fedora-40 fedora-rawhide opensuse-tumbleweed 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" +"Enable/disable support for POSIX Access Control Lists (ACLs). See the I<\\" +"%acl(5)> manual page for more information about ACLs." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap -msgid "rmdir\\ /sys/kernel/config/nullb/mydev\n" +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"Enable data copy-on-write for newly created files. I<Nodatacow> implies " +"I<nodatasum>, and disables I<compression>\\&. All files created under " +"I<nodatacow> are also set the NOCOW file attribute (see I<\\%chattr(1)>)." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" -"nullb setup\n" -"nullb create -s 2g -z 256\n" -"mkfs.btrfs /dev/nullb0\n" -"\\&...\n" -"nullb rm nullb0\n" +"Enable data checksumming for newly created files. I<Datasum> implies " +"I<datacow>, i.e. the normal mode of operation. All files created under " +"I<nodatasum> inherit the \"no checksums\" property, however there\\(aqs no " +"corresponding file attribute (see I<\\%chattr(1)>)." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap +#: fedora-40 fedora-rawhide opensuse-tumbleweed msgid "" -"$ ls -l /dev/btrfs-control\n" -"crw------- 1 root root 10, 234 Jan 1 12:00 /dev/btrfs-control\n" +"Historically, any user could create a snapshot even if he was not owner of " +"the source subvolume, the subvolume deletion has been restricted for that " +"reason. The subvolume creation has been restricted but this mount option is " +"still required. This is a usability issue. Since 4.18, the I<\\%rmdir(2)> " +"syscall can delete an empty subvolume just like an ordinary directory. " +"Whether this is possible can be detected at runtime, see I<rmdir_subvol> " +"feature in I<FILESYSTEM FEATURES>\\&." msgstr "" #. type: Plain text -#: debian-unstable -#, no-wrap -msgid "# mknod --mode=600 /dev/btrfs-control c 10 234\n" +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"Some of the general mount options from I<\\%mount(8)> that affect BTRFS and " +"are worth mentioning." msgstr "" #. type: Plain text -#: debian-unstable +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"indicate that I<\\%rmdir(2)> syscall can delete an empty subvolume just like " +"an ordinary directory. Note that this feature only depends on the kernel " +"version." +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"A swapfile, when active, is a file-backed swap area. It is supported since " +"kernel 5.0. Use I<\\%swapon(8)> to activate it, until then (respectively " +"again after deactivating it with I<\\%swapoff(8)>) it\\(aqs just a normal " +"file (with NODATACOW set), for which the special restrictions for active " +"swapfiles don\\(aqt apply." +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed #, no-wrap -msgid "# btrfs rescue create-control-device\n" +msgid "" +"^\".ft C$\n" +"# btrfs filesystem mkswapfile --size 2G swapfile\n" +"# swapon swapfile\n" +"^\".ft P$\n" msgstr "" #. type: Plain text -#: debian-unstable +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"The symlink target may not be a valid path, i.e. the path name components " +"can exceed the limits (NAME_MAX), there\\(aqs no content validation at I<\\" +"%symlink(3)> creation." +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"I<attributes>: I<\\%chattr(1)> or I<\\%lsattr(1)> utilities (the ioctls are " +"FS_IOC_GETFLAGS and FS_IOC_SETFLAGS), due to the ioctl names the attributes " +"are also called flags" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"I<xflags>: to distinguish from the previous, it\\(aqs extended flags, with " +"tunable bits similar to the attributes but extensible and new bits will be " +"added in the future (the ioctls are FS_IOC_FSGETXATTR and FS_IOC_FSSETXATTR " +"but they are not related to extended attributes that are also called " +"xattrs), there\\(aqs no standard tool to change the bits, there\\(aqs " +"support in I<\\%xfs_io(8)> as command B<xfs_io -c chattr>" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"I<no dump>, makes sense with 3rd party tools like I<\\%dump(8)>, on BTRFS " +"the attribute can be set/unset but no other special handling is done" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"I<synchronous directory updates>, for more details search I<\\%open(2)> for " +"I<O_SYNC> and I<O_DSYNC>" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"I<no compression>, permanently turn off compression on the given file. Any " +"compression mount options will not affect this file. (I<\\%chattr(1)> " +"support added in 1.46.2)" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"I<synchronous updates>, for more details search I<\\%open(2)> for I<O_SYNC> " +"and I<O_DSYNC>" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"No other attributes are supported. For the complete list please refer to " +"the I<\\%chattr(1)> manual page." +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"There\\(aqs an overlap of letters assigned to the bits with the attributes, " +"this list refers to what I<\\%xfs_io(8)> provides:" +msgstr "" + +#. type: Plain text +#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed #, no-wrap msgid "" -"WARNING: Multiple block group profiles detected, see \\(aqman btrfs(5)\\(aq.\n" -"WARNING: Data: single, raid1\n" -"WARNING: Metadata: single, raid1\n" +"^\".ft C$\n" +"modprobe\\ configfs\n" +"modprobe\\ null_blk\\ nr_devices=0\n" +"^\".ft P$\n" msgstr "" #. type: Plain text -#: debian-unstable +#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed #, 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" +"^\".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 -#: debian-unstable +#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed #, no-wrap -msgid "Multiple profiles: yes (data, metadata)\n" +msgid "" +"^\".ft C$\n" +"rmdir\\ /sys/kernel/config/nullb/mydev\n" +"^\".ft P$\n" msgstr "" #. type: Plain text -#: debian-unstable +#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed #, no-wrap msgid "" -"# mkfs.btrfs /dev/sda\n" -"# mount /dev/sda /mnt/mnt1\n" -"\\&... fill mnt1 with data\n" -"# umount /mnt/mnt1\n" +"^\".ft C$\n" +"nullb setup\n" +"nullb create -s 2g -z 256\n" +"mkfs.btrfs /dev/nullb0\n" +"\\&...\n" +"nullb rm nullb0\n" +"^\".ft P$\n" msgstr "" #. type: Plain text -#: debian-unstable +#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed #, no-wrap msgid "" "# mount /dev/sda /mnt/mnt1\n" @@ -7468,40 +8090,41 @@ msgid "" "# umount /mnt/mnt1\n" "# mount /dev/sdb /mnt/mnt1\n" "\\&... /mnt/mnt1 is now writable\n" +"^\".ft P$\n" msgstr "" #. type: Plain text -#: debian-unstable +#: fedora-40 fedora-rawhide mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed #, no-wrap msgid "" +"^\".ft C$\n" "# mount /dev/sda /mnt/mnt2\n" "# btrfs device add /dev/sdc /mnt/mnt2\n" "# umount /mnt/mnt2\n" "# mount /dev/sdc /mnt/mnt2\n" "\\&... /mnt/mnt2 is now writable\n" +"^\".ft P$\n" msgstr "" +#. Generated by docutils manpage writer. #. type: Plain text -#: debian-unstable -#, no-wrap -msgid "# btrfs device delete /dev/sda /mnt/mnt1\n" +#: fedora-40 fedora-rawhide opensuse-tumbleweed +msgid "" +"I<\\%acl(5)>, I<\\%btrfs(8)>, I<\\%chattr(1)>, I<\\%fstrim(8)>, I<\\" +"%ioctl(2)>, I<\\%mkfs.btrfs(8)>, I<\\%mount(8)>, I<\\%swapon(8)>" msgstr "" -#. type: Plain text -#: debian-unstable +#. type: TH +#: mageia-cauldron #, 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" +msgid "Mar 10, 2024" msgstr "" #. type: TH #: mageia-cauldron #, no-wrap -msgid "Jan 09, 2024" +msgid "6.7.1" msgstr "" #. type: TH @@ -7515,3 +8138,9 @@ msgstr "" #, no-wrap msgid "6.5.1" msgstr "" + +#. type: TH +#: opensuse-tumbleweed +#, no-wrap +msgid "May 02, 2024" +msgstr "" |