path: root/templates/man2/mount_setattr.2.pot

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

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

#. type: TH
#: archlinux debian-unstable opensuse-tumbleweed
#, no-wrap
msgid "2024-05-02"
msgstr ""

#. type: TH
#: archlinux debian-unstable
#, no-wrap
msgid "Linux man-pages 6.8"
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 "mount_setattr - change properties of a mount or mount tree"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Standard C library (I<libc>, I<-lc>)"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"B<#include E<lt>linux/fcntl.hE<gt>> /* Definition of B<AT_*> constants */\n"
"B<#include E<lt>linux/mount.hE<gt>> /* Definition of B<MOUNT_ATTR_*> constants */\n"
"B<#include E<lt>sys/syscall.hE<gt>> /* Definition of B<SYS_*> constants */\n"
"B<#include E<lt>unistd.hE<gt>>\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 ""
"B<int syscall(SYS_mount_setattr, int >I<dirfd>B<, const char *>I<pathname>B<,>\n"
"B<            unsigned int >I<flags>B<, struct mount_attr *>I<attr>B<, size_t >I<size>B<);>\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<Note>: glibc provides no wrapper for B<mount_setattr>(), necessitating the "
"use of B<syscall>(2)."
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 ""
"The B<mount_setattr>()  system call changes the mount properties of a mount "
"or an entire mount tree.  If I<pathname> is a relative pathname, then it is "
"interpreted relative to the directory referred to by the file descriptor "
"I<dirfd>.  If I<dirfd> is the special value B<AT_FDCWD>, then I<pathname> is "
"interpreted relative to the current working directory of the calling "
"process.  If I<pathname> is the empty string and B<AT_EMPTY_PATH> is "
"specified in I<flags>, then the mount properties of the mount identified by "
"I<dirfd> are changed.  (See B<openat>(2)  for an explanation of why the "
"I<dirfd> argument is useful.)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The B<mount_setattr>()  system call uses an extensible structure (I<struct "
"mount_attr>)  to allow for future extensions.  Any non-flag extensions to "
"B<mount_setattr>()  will be implemented as new fields appended to the this "
"structure, with a zero value in a new field resulting in the kernel behaving "
"as though that extension field was not present.  Therefore, the caller "
"I<must> zero-fill this structure on initialization.  See the "
"\"Extensibility\" subsection under B<NOTES> for more details."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<size> argument should usually be specified as I<sizeof(struct "
"mount_attr)>.  However, if the caller is using a kernel that supports an "
"extended I<struct mount_attr>, but the caller does not intend to make use of "
"these features, it is possible to pass the size of an earlier version of the "
"structure together with the extended structure.  This allows the kernel to "
"not copy later parts of the structure that aren't used anyway.  With each "
"extension that changes the size of I<struct mount_attr>, the kernel will "
"expose a definition of the form B<MOUNT_ATTR_SIZE_VER>I<number>\\&.  For "
"example, the macro for the size of the initial version of I<struct "
"mount_attr> is B<MOUNT_ATTR_SIZE_VER0>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<flags> argument can be used to alter the pathname resolution "
"behavior.  The supported values 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<AT_EMPTY_PATH>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If I<pathname> is the empty string, change the mount properties on I<dirfd> "
"itself."
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_RECURSIVE>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Change the mount properties of the entire mount tree."
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_SYMLINK_NOFOLLOW>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Don't follow trailing symbolic links."
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_NO_AUTOMOUNT>"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<attr> argument of B<mount_setattr>()  is a structure of the following "
"form:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"struct mount_attr {\n"
"    __u64 attr_set;     /* Mount properties to set */\n"
"    __u64 attr_clr;     /* Mount properties to clear */\n"
"    __u64 propagation;  /* Mount propagation type */\n"
"    __u64 userns_fd;    /* User namespace file descriptor */\n"
"};\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<attr_set> and I<attr_clr> members are used to specify the mount "
"properties that are supposed to be set or cleared for a mount or mount "
"tree.  Flags set in I<attr_set> enable a property on a mount or mount tree, "
"and flags set in I<attr_clr> remove a property from a mount or mount tree."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When changing mount properties, the kernel will first clear the flags "
"specified in the I<attr_clr> field, and then set the flags specified in the "
"I<attr_set> field.  For example, these settings:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"struct mount_attr attr = {\n"
"    .attr_clr = MOUNT_ATTR_NOEXEC | MOUNT_ATTR_NODEV,\n"
"    .attr_set = MOUNT_ATTR_RDONLY | MOUNT_ATTR_NOSUID,\n"
"};\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "are equivalent to the following steps:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"unsigned int current_mnt_flags = mnt-E<gt>mnt_flags;\n"
"\\&\n"
"/*\n"
" * Clear all flags set in .attr_clr,\n"
" * clearing MOUNT_ATTR_NOEXEC and MOUNT_ATTR_NODEV.\n"
" */\n"
"current_mnt_flags &= \\(tiattr-E<gt>attr_clr;\n"
"\\&\n"
"/*\n"
" * Now set all flags set in .attr_set,\n"
" * applying MOUNT_ATTR_RDONLY and MOUNT_ATTR_NOSUID.\n"
" */\n"
"current_mnt_flags |= attr-E<gt>attr_set;\n"
"\\&\n"
"mnt-E<gt>mnt_flags = current_mnt_flags;\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 of this change, the mount or mount tree (a) is read-only; (b) "
"blocks the execution of set-user-ID and set-group-ID programs; (c) allows "
"execution of programs; and (d) allows access to devices."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Multiple changes with the same set of flags requested in I<attr_clr> and "
"I<attr_set> are guaranteed to be idempotent after the changes have been "
"applied."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The following mount attributes can be specified in the I<attr_set> or "
"I<attr_clr> fields:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If set in I<attr_set>, makes the mount read-only.  If set in I<attr_clr>, "
"removes the read-only setting if set on the mount."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If set in I<attr_set>, causes the mount not to honor the set-user-ID and set-"
"group-ID mode bits and file capabilities when executing programs.  If set in "
"I<attr_clr>, clears the set-user-ID, set-group-ID, and file capability "
"restriction if set on this mount."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If set in I<attr_set>, prevents access to devices on this mount.  If set in "
"I<attr_clr>, removes the restriction that prevented accessing devices on "
"this mount."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If set in I<attr_set>, prevents executing programs on this mount.  If set in "
"I<attr_clr>, removes the restriction that prevented executing programs on "
"this mount."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If set in I<attr_set>, prevents following symbolic links on this mount.  If "
"set in I<attr_clr>, removes the restriction that prevented following "
"symbolic links on this mount."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If set in I<attr_set>, prevents updating access time for directories on this "
"mount.  If set in I<attr_clr>, removes the restriction that prevented "
"updating access time for directories.  Note that B<MOUNT_ATTR_NODIRATIME> "
"can be combined with other access-time settings and is implied by the "
"noatime setting.  All other access-time settings are mutually exclusive."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The access-time values listed below are an enumeration that includes the "
"value zero, expressed in the bits defined by the mask B<MOUNT_ATTR__ATIME>.  "
"Even though these bits are an enumeration (in contrast to the other mount "
"flags such as B<MOUNT_ATTR_NOEXEC>), they are nonetheless passed in "
"I<attr_set> and I<attr_clr> for consistency with B<fsmount>(2), which "
"introduced this behavior."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Note that, since the access-time values are an enumeration rather than bit "
"values, a caller wanting to transition to a different access-time setting "
"cannot simply specify the access-time setting in I<attr_set>, but must also "
"include B<MOUNT_ATTR__ATIME> in the I<attr_clr> field.  The kernel will "
"verify that B<MOUNT_ATTR__ATIME> isn't partially set in I<attr_clr> (i.e., "
"either all bits in the B<MOUNT_ATTR__ATIME> bit field are either set or "
"clear), and that I<attr_set> doesn't have any access-time bits set if "
"B<MOUNT_ATTR__ATIME> isn't set in I<attr_clr>."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When a file is accessed via this mount, update the file's last access time "
"(atime)  only if the current value of atime is less than or equal to the "
"file's last modification time (mtime) or last status change time (ctime)."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"To enable this access-time setting on a mount or mount tree, "
"B<MOUNT_ATTR_RELATIME> must be set in I<attr_set> and B<MOUNT_ATTR__ATIME> "
"must be set in the I<attr_clr> field."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Do not update access times for (all types of) files on this mount."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"To enable this access-time setting on a mount or mount tree, "
"B<MOUNT_ATTR_NOATIME> must be set in I<attr_set> and B<MOUNT_ATTR__ATIME> "
"must be set in the I<attr_clr> field."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Always update the last access time (atime)  when files are accessed on this "
"mount."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"To enable this access-time setting on a mount or mount tree, "
"B<MOUNT_ATTR_STRICTATIME> must be set in I<attr_set> and "
"B<MOUNT_ATTR__ATIME> must be set in the I<attr_clr> field."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If set in I<attr_set>, creates an ID-mapped mount.  The ID mapping is taken "
"from the user namespace specified in I<userns_fd> and attached to the mount."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Since it is not supported to change the ID mapping of a mount after it has "
"been ID mapped, it is invalid to specify B<MOUNT_ATTR_IDMAP> in I<attr_clr>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"For further details, see the subsection \"ID-mapped mounts\" under NOTES."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<propagation> field is used to specify the propagation type of the "
"mount or mount tree.  This field either has the value zero, meaning leave "
"the propagation type unchanged, or it has one of the following values:"
msgstr ""

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

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

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

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

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

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

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

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"For further details on the above propagation types, see "
"B<mount_namespaces>(7)."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"On success, B<mount_setattr>()  returns zero.  On error, -1 is returned and "
"I<errno> is set to indicate the cause of the error."
msgstr ""

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

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<pathname> is relative but I<dirfd> is neither B<AT_FDCWD> nor a valid file "
"descriptor."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<userns_fd> is not a valid file descriptor."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The caller tried to change the mount to B<MOUNT_ATTR_RDONLY>, but the mount "
"still holds files open for writing."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The caller tried to create an ID-mapped mount raising B<MOUNT_ATTR_IDMAP> "
"and specifying I<userns_fd> but the mount still holds files open for writing."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The pathname specified via the I<dirfd> and I<pathname> arguments to "
"B<mount_setattr>()  isn't a mount point."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "An unsupported value was set in I<flags>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"An unsupported value was specified in the I<attr_set> field of I<mount_attr>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"An unsupported value was specified in the I<attr_clr> field of I<mount_attr>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"An unsupported value was specified in the I<propagation> field of "
"I<mount_attr>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"More than one of B<MS_SHARED>, B<MS_SLAVE>, B<MS_PRIVATE>, or "
"B<MS_UNBINDABLE> was set in the I<propagation> field of I<mount_attr>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"An access-time setting was specified in the I<attr_set> field without "
"B<MOUNT_ATTR__ATIME> being set in the I<attr_clr> field."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<MOUNT_ATTR_IDMAP> was specified in I<attr_clr>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A file descriptor value was specified in I<userns_fd> which exceeds "
"B<INT_MAX>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A valid file descriptor value was specified in I<userns_fd>, but the file "
"descriptor did not refer to a user namespace."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The underlying filesystem does not support ID-mapped mounts."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The mount that is to be ID mapped is not a detached mount; that is, the "
"mount has not previously been visible in a mount namespace."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A partial access-time setting was specified in I<attr_clr> instead of "
"B<MOUNT_ATTR__ATIME> being set."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The mount is located outside the caller's mount namespace."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The underlying filesystem has been mounted in a mount namespace that is "
"owned by a noninitial user namespace"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "A pathname was empty or had a nonexistent component."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When changing mount propagation to B<MS_SHARED>, a new peer group ID needs "
"to be allocated for all mounts without a peer group ID set.  This allocation "
"failed because there was not enough memory to allocate the relevant internal "
"structures."
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>"
msgstr ""

#.  Christian Brauner: i.e. someone has somehow managed to
#.  allocate so many peer groups and managed to keep the kernel running
#.  (???) that the ida has ran out of ids
#.  Note that technically further error codes are possible that are
#.  specific to the ID allocation implementation used.
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When changing mount propagation to B<MS_SHARED>, a new peer group ID needs "
"to be allocated for all mounts without a peer group ID set.  This allocation "
"failed because the kernel has run out of IDs."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"One of the mounts had at least one of B<MOUNT_ATTR_NOATIME>, "
"B<MOUNT_ATTR_NODEV>, B<MOUNT_ATTR_NODIRATIME>, B<MOUNT_ATTR_NOEXEC>, "
"B<MOUNT_ATTR_NOSUID>, or B<MOUNT_ATTR_RDONLY> set and the flag is locked.  "
"Mount attributes become locked on a mount if:"
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 ""
"A new mount or mount tree is created causing mount propagation across user "
"namespaces (i.e., propagation to a mount namespace owned by a different user "
"namespace).  The kernel will lock the aforementioned flags to prevent these "
"sensitive properties from being altered."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A new mount and user namespace pair is created.  This happens for example "
"when specifying B<CLONE_NEWUSER | CLONE_NEWNS> in B<unshare>(2), "
"B<clone>(2), or B<clone3>(2).  The aforementioned flags become locked in the "
"new mount namespace to prevent sensitive mount properties from being "
"altered.  Since the newly created mount namespace will be owned by the newly "
"created user namespace, a calling process that is privileged in the new user "
"namespace would\\[em]in the absence of such locking\\[em]be able to alter "
"sensitive mount properties (e.g., to remount a mount that was marked read-"
"only as read-write in the new mount namespace)."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A valid file descriptor value was specified in I<userns_fd>, but the file "
"descriptor refers to the initial user namespace."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"An attempt was made to add an ID mapping to a mount that is already ID "
"mapped."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The caller does not have B<CAP_SYS_ADMIN> in the initial user namespace."
msgstr ""

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

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

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

#.  commit 7d6beb71da3cc033649d641e1e608713b8220290
#.  commit 2a1867219c7b27f928e2545782b86daaf9ad50bd
#.  commit 9caccd41541a6f7d6279928d9f971f6642c361af
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "Linux 5.12."
msgstr ""

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

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Creating an ID-mapped mount makes it possible to change the ownership of all "
"files located under a mount.  Thus, ID-mapped mounts make it possible to "
"change ownership in a temporary and localized way.  It is a localized change "
"because the ownership changes are visible only via a specific mount.  All "
"other users and locations where the filesystem is exposed are unaffected.  "
"It is a temporary change because the ownership changes are tied to the "
"lifetime of the mount."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Whenever callers interact with the filesystem through an ID-mapped mount, "
"the ID mapping of the mount will be applied to user and group IDs associated "
"with filesystem objects.  This encompasses the user and group IDs associated "
"with inodes and also the following B<xattr>(7)  keys:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<security.capability>, whenever filesystem capabilities are stored or "
"returned in the B<VFS_CAP_REVISION_3> format, which stores a root user ID "
"alongside the capabilities (see B<capabilities>(7))."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<system.posix_acl_access> and I<system.posix_acl_default>, whenever user "
"IDs or group IDs are stored in B<ACL_USER> or B<ACL_GROUP> entries."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The following conditions must be met in order to create an ID-mapped mount:"
msgstr ""

#.  commit bd303368b776eead1c29e6cdda82bde7128b82a7
#.  Christian Brauner
#.      Note, currently no filesystems mountable in non-initial user namespaces
#.      support ID-mapped mounts.
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The caller must have the B<CAP_SYS_ADMIN> capability in the user namespace "
"the filesystem was mounted in."
msgstr ""

#.  fs_flags = FS_ALLOW_IDMAP in kernel sources
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The underlying filesystem must support ID-mapped mounts.  Currently, the "
"following filesystems support ID-mapped mounts:"
msgstr ""

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

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

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

#.  commit 5b9b26f5d0b88b74001dcfe4ab8a8f2f4e744112
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<btrfs>(5)  (since Linux 5.15)"
msgstr ""

#.  commit 82cae269cfa953032fbb8980a7d554d60fb00b17
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<ntfs3> (since Linux 5.15)"
msgstr ""

#.  commit 984fc4e76d63345499f01c0c198a4b44860cf027
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<f2fs> (since Linux 5.18)"
msgstr ""

#.  commit 6c459b78d4793afbba6d864c466cc5cd2932459d
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<erofs> (since Linux 5.19)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<overlayfs> (ID-mapped lower and upper layers supported since Linux 5.19)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable opensuse-tumbleweed
msgid "B<squashfs> (since Linux 6.2)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable opensuse-tumbleweed
msgid "B<tmpfs> (since Linux 6.3)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable opensuse-tumbleweed
msgid "B<cephfs> (since Linux 6.7)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable opensuse-tumbleweed
msgid "B<hugetlbfs> (since Linux 6.9)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The mount must not already be ID-mapped.  This also implies that the ID "
"mapping of a mount cannot be altered."
msgstr ""

#.  commit 1bbcd277a53e08d619ffeec56c5c9287f2bf42f
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid "The mount must not have any writers."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The mount must be a detached mount; that is, it must have been created by "
"calling B<open_tree>(2)  with the B<OPEN_TREE_CLONE> flag and it must not "
"already have been visible in a mount namespace.  (To put things another way: "
"the mount must not have been attached to the filesystem hierarchy with a "
"system call such as B<move_mount>(2).)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"ID mappings can be created for user IDs, group IDs, and project IDs.  An ID "
"mapping is essentially a mapping of a range of user or group IDs into "
"another or the same range of user or group IDs.  ID mappings are written to "
"map files as three numbers separated by white space.  The first two numbers "
"specify the starting user or group ID in each of the two user namespaces.  "
"The third number specifies the range of the ID mapping.  For example, a "
"mapping for user IDs such as \"1000\\ 1001\\ 1\" would indicate that user ID "
"1000 in the caller's user namespace is mapped to user ID 1001 in its "
"ancestor user namespace.  Since the map range is 1, only user ID 1000 is "
"mapped."
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 to specify up to 340 ID mappings for each ID mapping type.  "
"If any user IDs or group IDs are not mapped, all files owned by that "
"unmapped user or group ID will appear as being owned by the overflow user ID "
"or overflow group ID respectively."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Further details on setting up ID mappings can be found in "
"B<user_namespaces>(7)."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In the common case, the user namespace passed in I<userns_fd> (together with "
"B<MOUNT_ATTR_IDMAP> in I<attr_set>)  to create an ID-mapped mount will be "
"the user namespace of a container.  In other scenarios it will be a "
"dedicated user namespace associated with a user's login session as is the "
"case for portable home directories in B<systemd-homed.service>(8)).  It is "
"also perfectly fine to create a dedicated user namespace for the sake of ID "
"mapping a mount."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"ID-mapped mounts can be useful in the following and a variety of other "
"scenarios:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Sharing files or filesystems between multiple users or multiple machines, "
"especially in complex scenarios.  For example, ID-mapped mounts are used to "
"implement portable home directories in B<systemd-homed.service>(8), where "
"they allow users to move their home directory to an external storage device "
"and use it on multiple computers where they are assigned different user IDs "
"and group IDs.  This effectively makes it possible to assign random user IDs "
"and group IDs at login time."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Sharing files or filesystems from the host with unprivileged containers.  "
"This allows a user to avoid having to change ownership permanently through "
"B<chown>(2)."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"ID mapping a container's root filesystem.  Users don't need to change "
"ownership permanently through B<chown>(2).  Especially for large root "
"filesystems, using B<chown>(2)  can be prohibitively expensive."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Sharing files or filesystems between containers with non-overlapping ID "
"mappings."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Implementing discretionary access (DAC) permission checking for filesystems "
"lacking a concept of ownership."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Efficiently changing ownership on a per-mount basis.  In contrast to "
"B<chown>(2), changing ownership of large sets of files is instantaneous with "
"ID-mapped mounts.  This is especially useful when ownership of an entire "
"root filesystem of a virtual machine or container is to be changed as "
"mentioned above.  With ID-mapped mounts, a single B<mount_setattr>()  system "
"call will be sufficient to change the ownership of all files."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Taking the current ownership into account.  ID mappings specify precisely "
"what a user or group ID is supposed to be mapped to.  This contrasts with "
"the B<chown>(2)  system call which cannot by itself take the current "
"ownership of the files it changes into account.  It simply changes the "
"ownership to the specified user ID and group ID."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Locally and temporarily restricted ownership changes.  ID-mapped mounts make "
"it possible to change ownership locally, restricting the ownership changes "
"to specific mounts, and temporarily as the ownership changes only apply as "
"long as the mount exists.  By contrast, changing ownership via the "
"B<chown>(2)  system call changes the ownership globally and permanently."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In order to allow for future extensibility, B<mount_setattr>()  requires the "
"user-space application to specify the size of the I<mount_attr> structure "
"that it is passing.  By providing this information, it is possible for "
"B<mount_setattr>()  to provide both forwards- and backwards-compatibility, "
"with I<size> acting as an implicit version number.  (Because new extension "
"fields will always be appended, the structure size will always increase.)  "
"This extensibility design is very similar to other system calls such as "
"B<perf_setattr>(2), B<perf_event_open>(2), B<clone3>(2)  and B<openat2>(2)."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Let I<usize> be the size of the structure as specified by the user-space "
"application, and let I<ksize> be the size of the structure which the kernel "
"supports, then there are three cases to consider:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If I<ksize> equals I<usize>, then there is no version mismatch and I<attr> "
"can be used verbatim."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If I<ksize> is larger than I<usize>, then there are some extension fields "
"that the kernel supports which the user-space application is unaware of.  "
"Because a zero value in any added extension field signifies a no-op, the "
"kernel treats all of the extension fields not provided by the user-space "
"application as having zero values.  This provides backwards-compatibility."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If I<ksize> is smaller than I<usize>, then there are some extension fields "
"which the user-space application is aware of but which the kernel does not "
"support.  Because any extension field must have its zero values signify a no-"
"op, the kernel can safely ignore the unsupported extension fields if they "
"are all zero.  If any unsupported extension fields are non-zero, then -1 is "
"returned and I<errno> is set to B<E2BIG>.  This provides forwards-"
"compatibility."
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-tumbleweed
msgid ""
"Because the definition of I<struct mount_attr> may change in the future "
"(with new fields being added when system headers are updated), user-space "
"applications should zero-fill I<struct mount_attr> to ensure that "
"recompiling the program with new headers will not result in spurious errors "
"at run time.  The simplest way is to use a designated initializer:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"struct mount_attr attr = {\n"
"    .attr_set = MOUNT_ATTR_RDONLY,\n"
"    .attr_clr = MOUNT_ATTR_NODEV\n"
"};\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Alternatively, the structure can be zero-filled using B<memset>(3)  or "
"similar functions:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid ""
"struct mount_attr attr;\n"
"memset(&attr, 0, sizeof(attr));\n"
"attr.attr_set = MOUNT_ATTR_RDONLY;\n"
"attr.attr_clr = MOUNT_ATTR_NODEV;\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"A user-space application that wishes to determine which extensions the "
"running kernel supports can do so by conducting a binary search on I<size> "
"with a structure which has every byte nonzero (to find the largest value "
"which doesn't produce an error of B<E2BIG>)."
msgstr ""

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

#.  Christian Brauner
#.      When writing programs I like to never use relative paths with AT_FDCWD
#.      because. Because making assumptions about the current working directory
#.      of the calling process is just too easy to get wrong; especially when
#.      pivot_root() or chroot() are in play.
#.      My absolut preference (joke intended) is to open a well-known starting
#.      point with an absolute path to get a dirfd and then scope all future
#.      operations beneath that dirfd. This already works with old-style
#.      openat() and _very_ cautious programming but openat2() and its
#.      resolve-flag space have made this **chef's kiss**.
#.      If I can't operate based on a well-known dirfd I use absolute paths
#.      with a -EBADF dirfd passed to *at() functions.
#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"/*\n"
" * This program allows the caller to create a new detached mount\n"
" * and set various properties on it.\n"
" */\n"
"#define _GNU_SOURCE\n"
"#include E<lt>err.hE<gt>\n"
"#include E<lt>fcntl.hE<gt>\n"
"#include E<lt>getopt.hE<gt>\n"
"#include E<lt>linux/mount.hE<gt>\n"
"#include E<lt>linux/types.hE<gt>\n"
"#include E<lt>stdbool.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>string.hE<gt>\n"
"#include E<lt>sys/syscall.hE<gt>\n"
"#include E<lt>unistd.hE<gt>\n"
"\\&\n"
"static inline int\n"
"mount_setattr(int dirfd, const char *pathname, unsigned int flags,\n"
"              struct mount_attr *attr, size_t size)\n"
"{\n"
"    return syscall(SYS_mount_setattr, dirfd, pathname, flags,\n"
"                   attr, size);\n"
"}\n"
"\\&\n"
"static inline int\n"
"open_tree(int dirfd, const char *filename, unsigned int flags)\n"
"{\n"
"    return syscall(SYS_open_tree, dirfd, filename, flags);\n"
"}\n"
"\\&\n"
"static inline int\n"
"move_mount(int from_dirfd, const char *from_pathname,\n"
"           int to_dirfd, const char *to_pathname, unsigned int flags)\n"
"{\n"
"    return syscall(SYS_move_mount, from_dirfd, from_pathname,\n"
"                   to_dirfd, to_pathname, flags);\n"
"}\n"
"\\&\n"
"static const struct option longopts[] = {\n"
"    {\"map-mount\",       required_argument,  NULL,  \\[aq]a\\[aq]},\n"
"    {\"recursive\",       no_argument,        NULL,  \\[aq]b\\[aq]},\n"
"    {\"read-only\",       no_argument,        NULL,  \\[aq]c\\[aq]},\n"
"    {\"block-setid\",     no_argument,        NULL,  \\[aq]d\\[aq]},\n"
"    {\"block-devices\",   no_argument,        NULL,  \\[aq]e\\[aq]},\n"
"    {\"block-exec\",      no_argument,        NULL,  \\[aq]f\\[aq]},\n"
"    {\"no-access-time\",  no_argument,        NULL,  \\[aq]g\\[aq]},\n"
"    { NULL,             0,                  NULL,   0 },\n"
"};\n"
"\\&\n"
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    int                fd_userns = -1;\n"
"    int                fd_tree;\n"
"    int                index = 0;\n"
"    int                ret;\n"
"    bool               recursive = false;\n"
"    const char         *source;\n"
"    const char         *target;\n"
"    struct mount_attr  *attr = &(struct mount_attr){};\n"
"\\&\n"
"    while ((ret = getopt_long_only(argc, argv, \"\",\n"
"                                   longopts, &index)) != -1) {\n"
"        switch (ret) {\n"
"        case \\[aq]a\\[aq]:\n"
"            fd_userns = open(optarg, O_RDONLY | O_CLOEXEC);\n"
"            if (fd_userns == -1)\n"
"                err(EXIT_FAILURE, \"open(%s)\", optarg);\n"
"            break;\n"
"        case \\[aq]b\\[aq]:\n"
"            recursive = true;\n"
"            break;\n"
"        case \\[aq]c\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_RDONLY;\n"
"            break;\n"
"        case \\[aq]d\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NOSUID;\n"
"            break;\n"
"        case \\[aq]e\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NODEV;\n"
"            break;\n"
"        case \\[aq]f\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NOEXEC;\n"
"            break;\n"
"        case \\[aq]g\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NOATIME;\n"
"            attr-E<gt>attr_clr |= MOUNT_ATTR__ATIME;\n"
"            break;\n"
"        default:\n"
"            errx(EXIT_FAILURE, \"Invalid argument specified\");\n"
"        }\n"
"    }\n"
"\\&\n"
"    if ((argc - optind) E<lt> 2)\n"
"        errx(EXIT_FAILURE, \"Missing source or target mount point\");\n"
"\\&\n"
"    source = argv[optind];\n"
"    target = argv[optind + 1];\n"
"\\&\n"
"    /* In the following, -1 as the \\[aq]dirfd\\[aq] argument ensures that\n"
"       open_tree() fails if \\[aq]source\\[aq] is not an absolute pathname. */\n"
"\\&\n"
"    fd_tree = open_tree(-1, source,\n"
"                        OPEN_TREE_CLONE | OPEN_TREE_CLOEXEC |\n"
"                        AT_EMPTY_PATH | (recursive ? AT_RECURSIVE : 0));\n"
"    if (fd_tree == -1)\n"
"        err(EXIT_FAILURE, \"open(%s)\", source);\n"
"\\&\n"
"    if (fd_userns E<gt>= 0) {\n"
"        attr-E<gt>attr_set  |= MOUNT_ATTR_IDMAP;\n"
"        attr-E<gt>userns_fd = fd_userns;\n"
"    }\n"
"\\&\n"
"    ret = mount_setattr(fd_tree, \"\",\n"
"                        AT_EMPTY_PATH | (recursive ? AT_RECURSIVE : 0),\n"
"                        attr, sizeof(struct mount_attr));\n"
"    if (ret == -1)\n"
"        err(EXIT_FAILURE, \"mount_setattr\");\n"
"\\&\n"
"    close(fd_userns);\n"
"\\&\n"
"    /* In the following, -1 as the \\[aq]to_dirfd\\[aq] argument ensures that\n"
"       open_tree() fails if \\[aq]target\\[aq] is not an absolute pathname. */\n"
"\\&\n"
"    ret = move_mount(fd_tree, \"\", -1, target,\n"
"                     MOVE_MOUNT_F_EMPTY_PATH);\n"
"    if (ret == -1)\n"
"        err(EXIT_FAILURE, \"move_mount() to %s\", target);\n"
"\\&\n"
"    close(fd_tree);\n"
"\\&\n"
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#.  SRC END
#. 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 ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"B<newgidmap>(1), B<newuidmap>(1), B<clone>(2), B<mount>(2), B<unshare>(2), "
"B<proc>(5), B<capabilities>(7), B<mount_namespaces>(7), "
"B<user_namespaces>(7), B<xattr>(7)"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "2023-02-10"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "Linux man-pages 6.03"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid "unsigned int current_mnt_flags = mnt-E<gt>mnt_flags;\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"/*\n"
" * Clear all flags set in .attr_clr,\n"
" * clearing MOUNT_ATTR_NOEXEC and MOUNT_ATTR_NODEV.\n"
" */\n"
"current_mnt_flags &= \\(tiattr-E<gt>attr_clr;\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"/*\n"
" * Now set all flags set in .attr_set,\n"
" * applying MOUNT_ATTR_RDONLY and MOUNT_ATTR_NOSUID.\n"
" */\n"
"current_mnt_flags |= attr-E<gt>attr_set;\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid "mnt-E<gt>mnt_flags = current_mnt_flags;\n"
msgstr ""

#. type: SH
#: debian-bookworm
#, no-wrap
msgid "VERSIONS"
msgstr ""

#.  commit 7d6beb71da3cc033649d641e1e608713b8220290
#.  commit 2a1867219c7b27f928e2545782b86daaf9ad50bd
#.  commit 9caccd41541a6f7d6279928d9f971f6642c361af
#. type: Plain text
#: debian-bookworm
msgid "B<mount_setattr>()  first appeared in Linux 5.12."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "B<mount_setattr>()  is Linux-specific."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid ""
"The mount must be a detached mount; that is, it must have been created by "
"calling"
msgstr ""

#.  commit 1bbcd277a53e08d619ffeec56c5c9287f2bf42f
#. type: Plain text
#: debian-bookworm
msgid ""
"The mount must not have any writers.  B<open_tree>(2)  with the "
"B<OPEN_TREE_CLONE> flag and it must not already have been visible in a mount "
"namespace.  (To put things another way: the mount must not have been "
"attached to the filesystem hierarchy with a system call such as "
"B<move_mount>(2).)"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
msgid ""
"Because the definition of I<struct mount_attr> may change in the future "
"(with new fields being added when system headers are updated), user-space "
"applications should zero-fill I<struct mount_attr> to ensure that "
"recompiling the program with new headers will not result in spurious errors "
"at runtime.  The simplest way is to use a designated initializer:"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"/*\n"
" * This program allows the caller to create a new detached mount\n"
" * and set various properties on it.\n"
" */\n"
"#define _GNU_SOURCE\n"
"#include E<lt>err.hE<gt>\n"
"#include E<lt>fcntl.hE<gt>\n"
"#include E<lt>getopt.hE<gt>\n"
"#include E<lt>linux/mount.hE<gt>\n"
"#include E<lt>linux/types.hE<gt>\n"
"#include E<lt>stdbool.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>string.hE<gt>\n"
"#include E<lt>sys/syscall.hE<gt>\n"
"#include E<lt>unistd.hE<gt>\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"static inline int\n"
"mount_setattr(int dirfd, const char *pathname, unsigned int flags,\n"
"              struct mount_attr *attr, size_t size)\n"
"{\n"
"    return syscall(SYS_mount_setattr, dirfd, pathname, flags,\n"
"                   attr, size);\n"
"}\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"static inline int\n"
"open_tree(int dirfd, const char *filename, unsigned int flags)\n"
"{\n"
"    return syscall(SYS_open_tree, dirfd, filename, flags);\n"
"}\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"static inline int\n"
"move_mount(int from_dirfd, const char *from_pathname,\n"
"           int to_dirfd, const char *to_pathname, unsigned int flags)\n"
"{\n"
"    return syscall(SYS_move_mount, from_dirfd, from_pathname,\n"
"                   to_dirfd, to_pathname, flags);\n"
"}\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"static const struct option longopts[] = {\n"
"    {\"map-mount\",       required_argument,  NULL,  \\[aq]a\\[aq]},\n"
"    {\"recursive\",       no_argument,        NULL,  \\[aq]b\\[aq]},\n"
"    {\"read-only\",       no_argument,        NULL,  \\[aq]c\\[aq]},\n"
"    {\"block-setid\",     no_argument,        NULL,  \\[aq]d\\[aq]},\n"
"    {\"block-devices\",   no_argument,        NULL,  \\[aq]e\\[aq]},\n"
"    {\"block-exec\",      no_argument,        NULL,  \\[aq]f\\[aq]},\n"
"    {\"no-access-time\",  no_argument,        NULL,  \\[aq]g\\[aq]},\n"
"    { NULL,             0,                  NULL,   0 },\n"
"};\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    int                fd_userns = -1;\n"
"    int                fd_tree;\n"
"    int                index = 0;\n"
"    int                ret;\n"
"    bool               recursive = false;\n"
"    const char         *source;\n"
"    const char         *target;\n"
"    struct mount_attr  *attr = &(struct mount_attr){};\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    while ((ret = getopt_long_only(argc, argv, \"\",\n"
"                                   longopts, &index)) != -1) {\n"
"        switch (ret) {\n"
"        case \\[aq]a\\[aq]:\n"
"            fd_userns = open(optarg, O_RDONLY | O_CLOEXEC);\n"
"            if (fd_userns == -1)\n"
"                err(EXIT_FAILURE, \"open(%s)\", optarg);\n"
"            break;\n"
"        case \\[aq]b\\[aq]:\n"
"            recursive = true;\n"
"            break;\n"
"        case \\[aq]c\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_RDONLY;\n"
"            break;\n"
"        case \\[aq]d\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NOSUID;\n"
"            break;\n"
"        case \\[aq]e\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NODEV;\n"
"            break;\n"
"        case \\[aq]f\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NOEXEC;\n"
"            break;\n"
"        case \\[aq]g\\[aq]:\n"
"            attr-E<gt>attr_set |= MOUNT_ATTR_NOATIME;\n"
"            attr-E<gt>attr_clr |= MOUNT_ATTR__ATIME;\n"
"            break;\n"
"        default:\n"
"            errx(EXIT_FAILURE, \"Invalid argument specified\");\n"
"        }\n"
"    }\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    if ((argc - optind) E<lt> 2)\n"
"        errx(EXIT_FAILURE, \"Missing source or target mount point\");\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    source = argv[optind];\n"
"    target = argv[optind + 1];\n"
msgstr ""

#.  Christian Brauner
#.      When writing programs I like to never use relative paths with AT_FDCWD
#.      because. Because making assumptions about the current working directory
#.      of the calling process is just too easy to get wrong; especially when
#.      pivot_root() or chroot() are in play.
#.      My absolut preference (joke intended) is to open a well-known starting
#.      point with an absolute path to get a dirfd and then scope all future
#.      operations beneath that dirfd. This already works with old-style
#.      openat() and _very_ cautious programming but openat2() and its
#.      resolve-flag space have made this **chef's kiss**.
#.      If I can't operate based on a well-known dirfd I use absolute paths
#.      with a -EBADF dirfd passed to *at() functions.
#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    /* In the following, -1 as the \\[aq]dirfd\\[aq] argument ensures that\n"
"       open_tree() fails if \\[aq]source\\[aq] is not an absolute pathname. */\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    fd_tree = open_tree(-1, source,\n"
"                        OPEN_TREE_CLONE | OPEN_TREE_CLOEXEC |\n"
"                        AT_EMPTY_PATH | (recursive ? AT_RECURSIVE : 0));\n"
"    if (fd_tree == -1)\n"
"        err(EXIT_FAILURE, \"open(%s)\", source);\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    if (fd_userns E<gt>= 0) {\n"
"        attr-E<gt>attr_set  |= MOUNT_ATTR_IDMAP;\n"
"        attr-E<gt>userns_fd = fd_userns;\n"
"    }\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    ret = mount_setattr(fd_tree, \"\",\n"
"                        AT_EMPTY_PATH | (recursive ? AT_RECURSIVE : 0),\n"
"                        attr, sizeof(struct mount_attr));\n"
"    if (ret == -1)\n"
"        err(EXIT_FAILURE, \"mount_setattr\");\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid "    close(fd_userns);\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    /* In the following, -1 as the \\[aq]to_dirfd\\[aq] argument ensures that\n"
"       open_tree() fails if \\[aq]target\\[aq] is not an absolute pathname. */\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    ret = move_mount(fd_tree, \"\", -1, target,\n"
"                     MOVE_MOUNT_F_EMPTY_PATH);\n"
"    if (ret == -1)\n"
"        err(EXIT_FAILURE, \"move_mount() to %s\", target);\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid "    close(fd_tree);\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: TH
#: fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "2023-10-31"
msgstr ""

#. type: TH
#: fedora-40 mageia-cauldron
#, no-wrap
msgid "Linux man-pages 6.06"
msgstr ""

#. type: TH
#: fedora-rawhide
#, no-wrap
msgid "Linux man-pages 6.7"
msgstr ""

#. type: TH
#: opensuse-leap-15-6
#, no-wrap
msgid "2023-04-01"
msgstr ""

#. type: TH
#: opensuse-leap-15-6
#, no-wrap
msgid "Linux man-pages 6.04"
msgstr ""

#. type: TH
#: opensuse-tumbleweed
#, no-wrap
msgid "Linux man-pages (unreleased)"
msgstr ""