aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2024-05-28 14:18:52 +0200
committerAlejandro Colomar <alx@kernel.org>2024-05-31 01:37:51 +0200
commit5c749ab3a12657696da8f8a35d18111a8e7ac533 (patch)
treeb3c29537d0cb9d6de68af10722186064a9d972a2
parent14f527f85699a820ab43c7a6d4fdb7f12fcc0fdf (diff)
downloadman-pages-5c749ab3a12657696da8f8a35d18111a8e7ac533.tar.gz
PR_SET_IO_FLUSHER.2const: Tweak after split
Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man/man2const/PR_SET_IO_FLUSHER.2const43
1 files changed, 20 insertions, 23 deletions
diff --git a/man/man2const/PR_SET_IO_FLUSHER.2const b/man/man2const/PR_SET_IO_FLUSHER.2const
index a00de279f1..1026943744 100644
--- a/man/man2const/PR_SET_IO_FLUSHER.2const
+++ b/man/man2const/PR_SET_IO_FLUSHER.2const
@@ -1,5 +1,6 @@
.\" Copyright 2020, Mike Christie <mchristi@redhat.com>
.\" Copyright 2020, Michael Kerrisk <mtk.manpages@gmail.com>
+.\" Copyright 2024, Alejandro Colomar <alx@kernel.org>
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
@@ -15,39 +16,35 @@ Standard C library
.nf
.B #include <sys/prctl.h>
.P
-.BI "int prctl(int " op ", ..."
-.BI " \fR/*\fP unsigned long " arg2 ", unsigned long " arg3 ,
-.BI " unsigned long " arg4 ", unsigned long " arg5 " \fR*/\fP );"
+.BI "int prctl(PR_SET_IO_FLUSHER, long " state ", 0L, 0L, 0L);"
.fi
.SH DESCRIPTION
-.TP
-.BR PR_SET_IO_FLUSHER " (since Linux 5.6)"
If a user process is involved in the block layer or filesystem I/O path,
and can allocate memory while processing I/O requests it must set
-\fIarg2\fP to 1.
+.I state
+to 1.
This will put the process in the IO_FLUSHER state,
which allows it special treatment to make progress when allocating memory.
-If \fIarg2\fP is 0, the process will clear the IO_FLUSHER state, and
-the default behavior will be used.
-.IP
+If
+.I state
+is 0,
+the process will clear the IO_FLUSHER state,
+and the default behavior will be used.
+.P
The calling process must have the
.B CAP_SYS_RESOURCE
capability.
-.IP
-.IR arg3 ,
-.IR arg4 ,
-and
-.I arg5
-must be zero.
-.IP
+.P
The IO_FLUSHER state is inherited by a child process created via
.BR fork (2)
and is preserved across
.BR execve (2).
-.IP
-Examples of IO_FLUSHER applications are FUSE daemons, SCSI device
-emulation daemons, and daemons that perform error handling like multipath
-path recovery applications.
+.P
+Examples of IO_FLUSHER applications are
+FUSE daemons,
+SCSI device emulation daemons,
+and daemons that perform error handling
+like multipath path recovery applications.
.SH RETURN VALUE
On success,
0 is returned.
@@ -57,12 +54,12 @@ is set to indicate the error.
.SH ERRORS
.TP
.B EINVAL
-.I arg2
-is not a valid value for this
-.IR op .
+.I state
+is not a valid value.
.SH STANDARDS
Linux.
.SH HISTORY
+Linux 5.6.
.SH SEE ALSO
.BR prctl (2),
.BR PR_GET_IO_FLUSHER (2const)