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

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

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

#. type: TH
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "Linux man-pages 6.06"
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 ""
"ioctl_userfaultfd - create a file descriptor for handling page faults in "
"user space"
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/userfaultfd.hE<gt>>  /* Definition of B<UFFD*> constants */\n"
"B<#include E<lt>sys/ioctl.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 ioctl(int >I<fd>B<, int >I<cmd>B<, ...);>\n"
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 ""
"Various B<ioctl>(2)  operations can be performed on a userfaultfd object "
"(created by a call to B<userfaultfd>(2))  using calls of the 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 "ioctl(fd, cmd, argp);\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"In the above, I<fd> is a file descriptor referring to a userfaultfd object, "
"I<cmd> is one of the commands listed below, and I<argp> is a pointer to a "
"data structure that is specific to I<cmd>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The various B<ioctl>(2)  operations are described below.  The B<UFFDIO_API>, "
"B<UFFDIO_REGISTER>, and B<UFFDIO_UNREGISTER> operations are used to "
"I<configure> userfaultfd behavior.  These operations allow the caller to "
"choose what features will be enabled and what kinds of events will be "
"delivered to the application.  The remaining operations are I<range> "
"operations.  These operations enable the calling application to resolve page-"
"fault events."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(Since Linux 4.3.)  Enable operation of the userfaultfd and perform API "
"handshake."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<argp> argument is a pointer to a I<uffdio_api> structure, defined as:"
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 uffdio_api {\n"
"    __u64 api;        /* Requested API version (input) */\n"
"    __u64 features;   /* Requested features (input/output) */\n"
"    __u64 ioctls;     /* Available ioctl() operations (output) */\n"
"};\n"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The I<api> field denotes the API version requested by the application.  The "
"kernel verifies that it can support the requested API version, and sets the "
"I<features> and I<ioctls> fields to bit masks representing all the available "
"features and the generic B<ioctl>(2)  operations available."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Since Linux 4.11, applications should use the I<features> field to perform a "
"two-step handshake.  First, B<UFFDIO_API> is called with the I<features> "
"field set to zero.  The kernel responds by setting all supported feature "
"bits."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"Applications which do not require any specific features can begin using the "
"userfaultfd immediately.  Applications which do need specific features "
"should call B<UFFDIO_API> again with a subset of the reported feature bits "
"set to enable those features."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Before Linux 4.11, the I<features> field must be initialized to zero before "
"the call to B<UFFDIO_API>, and zero (i.e., no feature bits) is placed in the "
"I<features> field by the kernel upon return from B<ioctl>(2)."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If the application sets unsupported feature bits, the kernel will zero out "
"the returned I<uffdio_api> structure and return 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 following feature bits may be set:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When this feature is enabled, the userfaultfd objects associated with a "
"parent process are duplicated into the child process during B<fork>(2)  and "
"a B<UFFD_EVENT_FORK> event is delivered to the userfaultfd monitor"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature is enabled, when the faulting process invokes B<mremap>(2), "
"the userfaultfd monitor will receive an event of type B<UFFD_EVENT_REMAP>."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature is enabled, when the faulting process calls B<madvise>(2)  "
"with the B<MADV_DONTNEED> or B<MADV_REMOVE> advice value to free a virtual "
"memory area the userfaultfd monitor will receive an event of type "
"B<UFFD_EVENT_REMOVE>."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature is enabled, when the faulting process unmaps virtual memory "
"either explicitly with B<munmap>(2), or implicitly during either B<mmap>(2)  "
"or B<mremap>(2), the userfaultfd monitor will receive an event of type "
"B<UFFD_EVENT_UNMAP>."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature bit is set, the kernel supports registering userfaultfd "
"ranges on hugetlbfs virtual memory areas"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature bit is set, the kernel supports registering userfaultfd "
"ranges on shared memory areas.  This includes all kernel shared memory APIs: "
"System V shared memory, B<tmpfs>(5), shared mappings of I</dev/zero>, "
"B<mmap>(2)  with the B<MAP_SHARED> flag set, B<memfd_create>(2), and so on."
msgstr ""

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

#.  commit 2d6d6f5a09a96cc1fec7ed992b825e05f64cb50e
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature bit is set, no page-fault events (B<UFFD_EVENT_PAGEFAULT>)  "
"will be delivered.  Instead, a B<SIGBUS> signal will be sent to the faulting "
"process.  Applications using this feature will not require the use of a "
"userfaultfd monitor for processing memory accesses to the regions registered "
"with userfaultfd."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature bit is set, I<uffd_msg.pagefault.feat.ptid> will be set to "
"the faulted thread ID for each page-fault message."
msgstr ""

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<UFFD_FEATURE_PAGEFAULT_FLAG_WP> (since Linux 5.10)"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If this feature bit is set, userfaultfd supports write-protect faults for "
"anonymous memory.  (Note that shmem / hugetlbfs support is indicated by a "
"separate feature.)"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature bit is set, the kernel supports registering userfaultfd "
"ranges in minor mode on hugetlbfs-backed memory areas."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If this feature bit is set, the kernel supports registering userfaultfd "
"ranges in minor mode on shmem-backed memory areas."
msgstr ""

#. type: TP
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-tumbleweed
#, no-wrap
msgid "B<UFFD_FEATURE_EXACT_ADDRESS> (since Linux 5.18)"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-tumbleweed
msgid ""
"If this feature bit is set, I<uffd_msg.pagefault.address> will be set to the "
"exact page-fault address that was reported by the hardware, and will not "
"mask the offset within the page.  Note that old Linux versions might "
"indicate the exact address as well, even though the feature bit is not set."
msgstr ""

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<UFFD_FEATURE_WP_HUGETLBFS_SHMEM> (since Linux 5.19)"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If this feature bit is set, userfaultfd supports write-protect faults for "
"hugetlbfs and shmem / tmpfs memory."
msgstr ""

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<UFFD_FEATURE_WP_UNPOPULATED> (since Linux 6.4)"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If this feature bit is set, the kernel will handle anonymous memory the same "
"way as file memory, by allowing the user to write-protect unpopulated page "
"table entries."
msgstr ""

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<UFFD_FEATURE_POISON> (since Linux 6.6)"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If this feature bit is set, the kernel supports resolving faults with the "
"B<UFFDIO_POISON> ioctl."
msgstr ""

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<UFFD_FEATURE_WP_ASYNC> (since Linux 6.7)"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"If this feature bit is set, the write protection faults would be "
"asynchronously resolved by the kernel."
msgstr ""

#.  FIXME This user-space API seems not fully polished. Why are there
#.  not constants defined for each of the bit-mask values listed below?
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The returned I<ioctls> field can contain the following bits:"
msgstr ""

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

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

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

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

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

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

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"This B<ioctl>(2)  operation returns 0 on success.  On error, -1 is returned "
"and I<errno> is set to indicate the error.  If an error occurs, the kernel "
"may zero the provided I<uffdio_api> structure.  The caller should treat its "
"contents as unspecified, and reinitialize it before re-attempting another "
"B<UFFDIO_API> call.  Possible errors include:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<argp> refers to an address that is outside the calling process's "
"accessible address space."
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 ""

# #-#-#-#-#  debian-bookworm: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#
# #-#-#-#-#  debian-unstable: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#
# #-#-#-#-#  opensuse-leap-15-6: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#
# #-#-#-#-#  opensuse-tumbleweed: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#
#. #-#-#-#-#  archlinux: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#. type: Plain text
#. #-#-#-#-#  debian-bookworm: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#.  FIXME In the above error case, the returned 'uffdio_api' structure is
#.  zeroed out. Why is this done? This should be explained in the manual page.
#.  Mike Rapoport:
#.      In my understanding the uffdio_api
#.      structure is zeroed to allow the caller
#.      to distinguish the reasons for -EINVAL.
#. type: Plain text
#. #-#-#-#-#  debian-unstable: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#.  FIXME In the above error case, the returned 'uffdio_api' structure is
#.  zeroed out. Why is this done? This should be explained in the manual page.
#.  Mike Rapoport:
#.      In my understanding the uffdio_api
#.      structure is zeroed to allow the caller
#.      to distinguish the reasons for -EINVAL.
#. type: Plain text
#. #-#-#-#-#  fedora-40: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#. type: Plain text
#. #-#-#-#-#  fedora-rawhide: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#. type: Plain text
#. #-#-#-#-#  mageia-cauldron: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#. type: Plain text
#. #-#-#-#-#  opensuse-leap-15-6: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#.  FIXME In the above error case, the returned 'uffdio_api' structure is
#.  zeroed out. Why is this done? This should be explained in the manual page.
#.  Mike Rapoport:
#.      In my understanding the uffdio_api
#.      structure is zeroed to allow the caller
#.      to distinguish the reasons for -EINVAL.
#. type: Plain text
#. #-#-#-#-#  opensuse-tumbleweed: ioctl_userfaultfd.2.pot (PACKAGE VERSION)  #-#-#-#-#
#.  FIXME In the above error case, the returned 'uffdio_api' structure is
#.  zeroed out. Why is this done? This should be explained in the manual page.
#.  Mike Rapoport:
#.      In my understanding the uffdio_api
#.      structure is zeroed to allow the caller
#.      to distinguish the reasons for -EINVAL.
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The API version requested in the I<api> field is not supported by this "
"kernel, or the I<features> field passed to the kernel includes feature bits "
"that are not supported by the current kernel version."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"A previous B<UFFDIO_API> call already enabled one or more features for this "
"userfaultfd.  Calling B<UFFDIO_API> twice, the first time with no features "
"set, is explicitly allowed as per the two-step feature detection handshake."
msgstr ""

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<EPERM>"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The B<UFFD_FEATURE_EVENT_FORK> feature was enabled, but the calling process "
"doesn't have the B<CAP_SYS_PTRACE> capability."
msgstr ""

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

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"(Since Linux 4.3.)  Register a memory address range with the userfaultfd "
"object.  The pages in the range must be \\[lq]compatible\\[rq].  Please "
"refer to the list of register modes below for the compatible memory backends "
"for each mode."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<argp> argument is a pointer to a I<uffdio_register> structure, defined "
"as:"
msgstr ""

#. type: Plain text
#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
#: opensuse-tumbleweed
#, no-wrap
msgid ""
"struct uffdio_range {\n"
"    __u64 start;    /* Start of range */\n"
"    __u64 len;      /* Length of range (bytes) */\n"
"};\n"
"\\&\n"
"struct uffdio_register {\n"
"    struct uffdio_range range;\n"
"    __u64 mode;     /* Desired mode of operation (input) */\n"
"    __u64 ioctls;   /* Available ioctl() operations (output) */\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<range> field defines a memory range starting at I<start> and "
"continuing for I<len> bytes that should be handled by the userfaultfd."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<mode> field defines the mode of operation desired for this memory "
"region.  The following values may be bitwise ORed to set the userfaultfd "
"mode for the specified range:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Track page faults on missing pages.  Since Linux 4.3, only private anonymous "
"ranges are compatible.  Since Linux 4.11, hugetlbfs and shared memory ranges "
"are also compatible."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Track page faults on write-protected pages.  Since Linux 5.7, only private "
"anonymous ranges are compatible."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Track minor page faults.  Since Linux 5.13, only hugetlbfs ranges are "
"compatible.  Since Linux 5.14, compatibility with shmem ranges was added."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"If the operation is successful, the kernel modifies the I<ioctls> bit-mask "
"field to indicate which B<ioctl>(2)  operations are available for the "
"specified range.  This returned bit mask can contain the following bits:"
msgstr ""

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

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

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

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

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

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid "The B<UFFDIO_WRITEPROTECT> operation is supported."
msgstr ""

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

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

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

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

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<1 E<lt>E<lt> _UFFDIO_POISON>"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid "The B<UFFDIO_POISON> operation is supported."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This B<ioctl>(2)  operation returns 0 on success.  On error, -1 is returned "
"and I<errno> is set to indicate the error.  Possible errors include:"
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 ""
"A mapping in the specified range is registered with another userfaultfd "
"object."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"An invalid or unsupported bit was specified in the I<mode> field; or the "
"I<mode> field was zero."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "There is no mapping in the specified address range."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<range.start> or I<range.len> is not a multiple of the system page size; "
"or, I<range.len> is zero; or these fields are otherwise invalid."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "There as an incompatible mapping in the specified address range."
msgstr ""

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

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"(Since Linux 4.3.)  Unregister a memory address range from userfaultfd.  The "
"pages in the range must be \\[lq]compatible\\[rq] (see the description of "
"B<UFFDIO_REGISTER>.)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The address range to unregister is specified in the I<uffdio_range> "
"structure pointed to by I<argp>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Either the I<start> or the I<len> field of the I<ufdio_range> structure was "
"not a multiple of the system page size; or the I<len> field was zero; or "
"these fields were otherwise invalid."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "There was no mapping in the specified address range."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(Since Linux 4.3.)  Atomically copy a continuous memory chunk into the "
"userfault registered range and optionally wake up the blocked thread.  The "
"source and destination addresses and the number of bytes to copy are "
"specified by the I<src>, I<dst>, and I<len> fields of the I<uffdio_copy> "
"structure pointed to by I<argp>:"
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 uffdio_copy {\n"
"    __u64 dst;    /* Destination of copy */\n"
"    __u64 src;    /* Source of copy */\n"
"    __u64 len;    /* Number of bytes to copy */\n"
"    __u64 mode;   /* Flags controlling behavior of copy */\n"
"    __s64 copy;   /* Number of bytes copied, or negated error */\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 following value may be bitwise ORed in I<mode> to change the behavior of "
"the B<UFFDIO_COPY> operation:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Do not wake up the thread that waits for page-fault resolution"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Copy the page with read-only permission.  This allows the user to trap the "
"next write to the page, which will block and generate another write-protect "
"userfault message.  This is used only when both "
"B<UFFDIO_REGISTER_MODE_MISSING> and B<UFFDIO_REGISTER_MODE_WP> modes are "
"enabled for the registered range."
msgstr ""

#.  FIXME Above: Why is the 'copy' field used to return error values?
#.  This should be explained in the manual page.
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<copy> field is used by the kernel to return the number of bytes that "
"was actually copied, or an error (a negated I<errno>-style value).  If the "
"value returned in I<copy> doesn't match the value that was specified in "
"I<len>, the operation fails with the error B<EAGAIN>.  The I<copy> field is "
"output-only; it is not read by the B<UFFDIO_COPY> operation."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This B<ioctl>(2)  operation returns 0 on success.  In this case, the entire "
"area was copied.  On error, -1 is returned and I<errno> is set to indicate "
"the error.  Possible errors include:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The number of bytes copied (i.e., the value returned in the I<copy> field)  "
"does not equal the value that was specified in the I<len> field."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Either I<dst> or I<len> was not a multiple of the system page size, or the "
"range specified by I<src> and I<len> or I<dst> and I<len> was invalid."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "An invalid bit was specified in the I<mode> 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<ENOENT> (since Linux 4.11)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The faulting process has changed its virtual memory layout simultaneously "
"with an outstanding B<UFFDIO_COPY> operation."
msgstr ""

#. type: TP
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "B<ENOSPC> (from Linux 4.11 until Linux 4.13)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The faulting process has exited at the time of a B<UFFDIO_COPY> operation."
msgstr ""

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

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(Since Linux 4.3.)  Zero out a memory range registered with userfaultfd."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The requested range is specified by the I<range> field of the "
"I<uffdio_zeropage> structure pointed to by I<argp>:"
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 uffdio_zeropage {\n"
"    struct uffdio_range range;\n"
"    __u64 mode;     /* Flags controlling behavior of copy */\n"
"    __s64 zeropage; /* Number of bytes zeroed, or negated error */\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 following value may be bitwise ORed in I<mode> to change the behavior of "
"the B<UFFDIO_ZEROPAGE> operation:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Do not wake up the thread that waits for page-fault resolution."
msgstr ""

#.  FIXME Why is the 'zeropage' field used to return error values?
#.  This should be explained in the manual page.
#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<zeropage> field is used by the kernel to return the number of bytes "
"that was actually zeroed, or an error in the same manner as B<UFFDIO_COPY>.  "
"If the value returned in the I<zeropage> field doesn't match the value that "
"was specified in I<range.len>, the operation fails with the error "
"B<EAGAIN>.  The I<zeropage> field is output-only; it is not read by the "
"B<UFFDIO_ZEROPAGE> operation."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This B<ioctl>(2)  operation returns 0 on success.  In this case, the entire "
"area was zeroed.  On error, -1 is returned and I<errno> is set to indicate "
"the error.  Possible errors include:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The number of bytes zeroed (i.e., the value returned in the I<zeropage> "
"field)  does not equal the value that was specified in the I<range.len> "
"field."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Either I<range.start> or I<range.len> was not a multiple of the system page "
"size; or I<range.len> was zero; or the range specified was invalid."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The faulting process has exited at the time of a B<UFFDIO_ZEROPAGE> "
"operation."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(Since Linux 4.3.)  Wake up the thread waiting for page-fault resolution on "
"a specified memory address range."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The B<UFFDIO_WAKE> operation is used in conjunction with B<UFFDIO_COPY> and "
"B<UFFDIO_ZEROPAGE> operations that have the B<UFFDIO_COPY_MODE_DONTWAKE> or "
"B<UFFDIO_ZEROPAGE_MODE_DONTWAKE> bit set in the I<mode> field.  The "
"userfault monitor can perform several B<UFFDIO_COPY> and B<UFFDIO_ZEROPAGE> "
"operations in a batch and then explicitly wake up the faulting thread using "
"B<UFFDIO_WAKE>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<argp> argument is a pointer to a I<uffdio_range> structure (shown "
"above) that specifies the address range."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<start> or the I<len> field of the I<ufdio_range> structure was not a "
"multiple of the system page size; or I<len> was zero; or the specified range "
"was otherwise invalid."
msgstr ""

#. type: SS
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "UFFDIO_WRITEPROTECT"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"(Since Linux 5.7.)  Write-protect or write-unprotect a userfaultfd-"
"registered memory range registered with mode B<UFFDIO_REGISTER_MODE_WP>."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<argp> argument is a pointer to a I<uffdio_range> structure as shown "
"below:"
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 uffdio_writeprotect {\n"
"    struct uffdio_range range; /* Range to change write permission*/\n"
"    __u64 mode;                /* Mode to change write permission */\n"
"};\n"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "There are two mode bits that are supported in this structure:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When this mode bit is set, the ioctl will be a write-protect operation upon "
"the memory range specified by I<range>.  Otherwise it will be a write-"
"unprotect operation upon the specified range, which can be used to resolve a "
"userfaultfd write-protect page fault."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"When this mode bit is set, do not wake up any thread that waits for page-"
"fault resolution after the operation.  This can be specified only if "
"B<UFFDIO_WRITEPROTECT_MODE_WP> is not specified."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "The process was interrupted; retry this call."
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 ""
"The range specified in I<range> is not valid.  For example, the virtual "
"address does not exist, or not registered with userfaultfd write-protect "
"mode."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Encountered a generic fault during processing."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(Since Linux 5.13.)  Resolve a minor page fault by installing page table "
"entries for existing pages in the page cache."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<argp> argument is a pointer to a I<uffdio_continue> structure as shown "
"below:"
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 uffdio_continue {\n"
"    struct uffdio_range range;\n"
"                   /* Range to install PTEs for and continue */\n"
"    __u64 mode;    /* Flags controlling the behavior of continue */\n"
"    __s64 mapped;  /* Number of bytes mapped, or negated error */\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 following value may be bitwise ORed in I<mode> to change the behavior of "
"the B<UFFDIO_CONTINUE> operation:"
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The I<mapped> field is used by the kernel to return the number of bytes that "
"were actually mapped, or an error in the same manner as B<UFFDIO_COPY>.  If "
"the value returned in the I<mapped> field doesn't match the value that was "
"specified in I<range.len>, the operation fails with the error B<EAGAIN>.  "
"The I<mapped> field is output-only; it is not read by the B<UFFDIO_CONTINUE> "
"operation."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"This B<ioctl>(2)  operation returns 0 on success.  In this case, the entire "
"area was mapped.  On error, -1 is returned and I<errno> is set to indicate "
"the error.  Possible errors include:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The number of bytes mapped (i.e., the value returned in the I<mapped> "
"field)  does not equal the value that was specified in the I<range.len> "
"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<EEXIST>"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "One or more pages were already mapped in the given range."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "No existing page could be found in the page cache for the given range."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The faulting process has changed its virtual memory layout simultaneously "
"with an outstanding B<UFFDIO_CONTINUE> operation."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "Allocating memory needed to setup the page table mappings failed."
msgstr ""

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The faulting process has exited at the time of a B<UFFDIO_CONTINUE> "
"operation."
msgstr ""

#. type: SS
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "UFFDIO_POISON"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"(Since Linux 6.6.)  Mark an address range as \"poisoned\".  Future accesses "
"to these addresses will raise a B<SIGBUS> signal.  Unlike B<MADV_HWPOISON> "
"this works by installing page table entries, rather than \"really\" "
"poisoning the underlying physical pages.  This means it only affects this "
"particular address space."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The I<argp> argument is a pointer to a I<uffdio_poison> structure as shown "
"below:"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid ""
"struct uffdio_poison {\n"
"\tstruct uffdio_range range;\n"
"\t                /* Range to install poison PTE markers in */\n"
"\t__u64 mode;     /* Flags controlling the behavior of poison */\n"
"\t__s64 updated;  /* Number of bytes poisoned, or negated error */\n"
"};\n"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The following value may be bitwise ORed in I<mode> to change the behavior of "
"the B<UFFDIO_POISON> operation:"
msgstr ""

#. type: TP
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
#, no-wrap
msgid "B<UFFDIO_POISON_MODE_DONTWAKE>"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The I<updated> field is used by the kernel to return the number of bytes "
"that were actually poisoned, or an error in the same manner as "
"B<UFFDIO_COPY>.  If the value returned in the I<updated> field doesn't match "
"the value that was specified in I<range.len>, the operation fails with the "
"error B<EAGAIN>.  The I<updated> field is output-only; it is not read by the "
"B<UFFDIO_POISON> operation."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"This B<ioctl>(2)  operation returns 0 on success.  In this case, the entire "
"area was poisoned.  On error, -1 is returned and I<errno> is set to indicate "
"the error.  Possible errors include:"
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The number of bytes mapped (i.e., the value returned in the I<updated> "
"field)  does not equal the value that was specified in the I<range.len> "
"field."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The faulting process has changed its virtual memory layout simultaneously "
"with an outstanding B<UFFDIO_POISON> operation."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid "Allocating memory for page table entries failed."
msgstr ""

#. type: Plain text
#: archlinux fedora-40 fedora-rawhide mageia-cauldron
msgid ""
"The faulting process has exited at the time of a B<UFFDIO_POISON> operation."
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 "See descriptions of the individual operations, above."
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: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"See descriptions of the individual operations, above.  In addition, the "
"following general errors can occur for all of the operations described above:"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "I<argp> does not point to a valid memory address."
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(For all operations except B<UFFDIO_API>.)  The userfaultfd object has not "
"yet been enabled (via the B<UFFDIO_API> operation)."
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-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "BUGS"
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 detect available userfault features and enable some subset of "
"those features the userfaultfd file descriptor must be closed after the "
"first B<UFFDIO_API> operation that queries features availability and "
"reopened before the second B<UFFDIO_API> operation that actually enables the "
"desired features."
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 ""

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

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

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid "B<ioctl>(2), B<mmap>(2), B<userfaultfd>(2)"
msgstr ""

#. type: Plain text
#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"I<Documentation/admin-guide/mm/userfaultfd.rst> in the Linux kernel source "
"tree"
msgstr ""

#. type: TH
#: debian-bookworm
#, no-wrap
msgid "2022-12-15"
msgstr ""

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

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid "The I<api> field denotes the API version requested by the application."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The kernel verifies that it can support the requested API version, and sets "
"the I<features> and I<ioctls> fields to bit masks representing all the "
"available features and the generic B<ioctl>(2)  operations available."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Starting from Linux 4.11, the I<features> field can be used to ask whether "
"particular features are supported and explicitly enable userfaultfd features "
"that are disabled by default.  The kernel always reports all the available "
"features in the I<features> field."
msgstr ""

#.  FIXME add more details about feature negotiation and enablement
#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"To enable userfaultfd features the application should set a bit "
"corresponding to each feature it wants to enable in the I<features> field.  "
"If the kernel supports all the requested features it will enable them.  "
"Otherwise it will zero out the returned I<uffdio_api> structure and return "
"B<EINVAL>."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"The userfaultfd has already been enabled by a previous B<UFFDIO_API> "
"operation."
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(Since Linux 4.3.)  Register a memory address range with the userfaultfd "
"object.  The pages in the range must be \"compatible\".  Please refer to the "
"list of register modes below for the compatible memory backends for each "
"mode."
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"struct uffdio_range {\n"
"    __u64 start;    /* Start of range */\n"
"    __u64 len;      /* Length of range (bytes) */\n"
"};\n"
msgstr ""

#. type: Plain text
#: debian-bookworm opensuse-leap-15-6
#, no-wrap
msgid ""
"struct uffdio_register {\n"
"    struct uffdio_range range;\n"
"    __u64 mode;     /* Desired mode of operation (input) */\n"
"    __u64 ioctls;   /* Available ioctl() operations (output) */\n"
"};\n"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid "The B<UFFDIO_WRITEPROTECT>"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"(Since Linux 4.3.)  Unregister a memory address range from userfaultfd.  The "
"pages in the range must be \"compatible\" (see the description of "
"B<UFFDIO_REGISTER>.)"
msgstr ""

#. type: SS
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
#, no-wrap
msgid "UFFDIO_WRITEPROTECT (Since Linux 5.7)"
msgstr ""

#. type: Plain text
#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed
msgid ""
"Write-protect or write-unprotect a userfaultfd-registered memory range "
"registered with mode B<UFFDIO_REGISTER_MODE_WP>."
msgstr ""

#. type: Plain text
#: debian-bookworm
msgid "These B<ioctl>(2)  operations are Linux-specific."
msgstr ""

#. type: TH
#: debian-unstable opensuse-tumbleweed
#, no-wrap
msgid "2023-05-03"
msgstr ""

#. type: TH
#: debian-unstable opensuse-tumbleweed
#, no-wrap
msgid "Linux man-pages 6.05.01"
msgstr ""

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

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