Commit Graph

17743 Commits

Author SHA1 Message Date
Michael Kerrisk 20c8cd9a65 statx.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 13:05:15 +02:00
Michael Kerrisk 50c74bdb4e statx.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 13:03:27 +02:00
Michael Kerrisk a18cc179a7 ioctl_userfaultfd.2: Drop some unneeded text
From a conversation with Mike Rapoport:

What does "consistent" mean?
    Actually, I though I've copied this text from Andrea's docs,
    but now I've found out it was my wording and I really don't
    remember now what was my intention for "consistent" :) My
    guess is that I was thinking about atomicity of UFFDIO_COPY,
    or the fact that from the faulting thread perspective the
    page fault handling is the same whether it's done in kernel
    or via userfaultfd...  That said, maybe it'd be better just
    to drop "in a consistent way".

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk a0f04ef10e ioctl_userfaultfd.2: srcfix: remove obsolete FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk be7979d754 ioctl_userfaultfd.2: Explain the use case for UFFDIO_WAKE
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk d726ff4f8b ioctl_userfaultfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk 1c63cefda2 ioctl_userfaultfd.2: Note that UFFDIO_UNREGISTER address range must be compatible
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk d87f377e4e ioctl_userfaultfd.2: Explain concept of "compatible" mapping for UFFDIO_REGISTER
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk ef443f0771 ioctl_userfaultfd.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk 9428d7caed ioctl_userfaultfd.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk b38f1fa225 ioctl_userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk a440cc336a ioctl_userfaultfd.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk cd8389ff87 ioctl_userfaultfd.2: Add EFAULT errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk b4e9ab9131 ioctl_userfaultfd.2: srcfix: Remove FIXME
According to Mike Rapoport the description of the 'ioctls'
field is accurate.

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk d33fa469cc ioctl_userfaultfd.2: Clarify the 'features' field usage for UFFDIO_API
Mike Rapoport notes that changes are coming in Linux 4.11.

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:40 +02:00
Michael Kerrisk 7b8695f29c userfaultfd.2: Describe close() semantics for userfaultfd
Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 1bf00323f5 userfaultfd.2: Note that O_NONBLOCK flag is required for poll() etc.
And better word the associated FIXME.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 4f03f0cc36 userfaultfd.2: srcfix: remove a FIXME
According to Mike Rapoport, the details are correct,
"at least for the current upstream version. 4.11 will
have quite a few updates to userfaultfd."

Reported-by: Mike Rapoport <rppt@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 53b95540ac ioctl_userfaultfd.2: srcfix: Improve FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk b4023444af userfaultfd.2: srcfix: improve FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 00f4853c43 userfaultfd.2: wsfix
Signed-off-by: Michael Kerrisk <mtk@man7.org>
2017-04-25 12:56:39 +02:00
Michael Kerrisk de6943fab3 userfaultfd.2: Mention some use cases
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 6d3e02a507 userfaultfd.2: SEE ALSO: add madvise(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 7cb4a3d66e ioctl_userfaultfd.2: Add comments to structure definitions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk b8838c257f ioctl_userfaultfd.2: Add pointer to EXAMPLE in userfaultfd(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk b07243abe1 userfaultfd.2: Add an example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 3f894561c0 userfaultfd.2: Add a header file to the SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 0289632060 userfaultfd.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 058b32ac70 userfaultfd.2: Describe errors for read() on userfaultfd
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 68a9e23c1f userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 242c2b6b43 ioctl_userfaultfd.2: Add a few more EINVAL error cases/details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 66e11c1f8f ioctl_userfaultfd.2: Improve UFFDIO_WAKE description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 611ec3a39b ioctl_userfaultfd.2: Improve UFFDIO_ZEROPAGE description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 1dca8e3dc3 ioctl_userfaultfd.2: Improve UFFDIO_COPY description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk e8a846ae66 ioctl_userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 7b28502f1e ioctl_userfaultfd.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 264a0a30ce ioctl_userfaultfd.2: Improve UFFDIO_REGISTER description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 1b945386ca ioctl_userfaultfd.2: Add kernel versions where each ioctl() first appeared
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk 52b794f147 ioctl_userfaultfd.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:39 +02:00
Michael Kerrisk a23c93d83c ioctl_userfaultfd.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 9a3c219414 ioctl_userfaultfd.2: Improve the UFFDIO_API description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 405513d327 ioctl_userfaultfd.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk ffbc7efcc2 ioctl_userfaultfd.2: Add another EINVAL error for UFFDIO_API
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 24fa87ffa1 ioctl_userfaultfd.2: Add some generic errors common to most/all of the ioctl() operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 637512edfa ioctl_userfaultfd.2: Rework list of ioctl() operations as subsections
Mainly, this means that we drop one level of indentation, which is
useful, since the error lists also add a level of indentation,
and the text overall becomes a little overindented.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk fe905357af ioctl_userfaultfd.2: Rework intro text on type of ioctl() operations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 74bd6e931a ioctl_userfaultfd.2: Rework formatting of structures for each ioctl() operation
Trying to place structure names on the same line as the ioctl()
operation names makes the lines two busy. And, conventionally,
the space after a hanging-list constant name is optionally used
to indicate the kernel version number where the constant was
introduced..

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 54e031a158 userfaultfd.2: Add information on reading userfaultfd events
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 95f1d14991 userfaultfd.2: Add some overview notes on usage
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00
Michael Kerrisk 89bfeedfe9 syscalls.2: Fix kernel version for userfaultfd(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:38 +02:00