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>
This commit is contained in:
Michael Kerrisk 2017-04-21 11:06:42 +02:00
parent d726ff4f8b
commit be7979d754
1 changed files with 20 additions and 1 deletions

View File

@ -487,12 +487,31 @@ field.
Wake up the thread waiting for page-fault resolution on
a specified memory address range.
The
.B UFFDIO_WAKE
operation is used in conjunction with
.BR UFFDIO_COPY
and
.BR UFFDIO_ZEROPAGE
operations that have the
.BR UFFDIO_COPY_MODE_DONTWAKE
or
.BR UFFDIO_ZEROPAGE_MODE_DONTWAKE
bit set in the
.I mode
field.
The userfault monitor can perform several
.BR UFFDIO_COPY
and
.BR UFFDIO_ZEROPAGE
operations in a batch and then explicitly wake up the faulting thread using
.BR UFFDIO_WAKE .
The
.I argp
argument is a pointer to a
.I uffdio_range
structure (shown above) that specifies the address range.
.\" FIXME: Need more detail here. How is the UFFDIO_WAKE operation used?
This
.BR ioctl (2)