.\" This is _*_ nroff _*_ source. Emacs, gimme all those colors :)
.\"
-.\" Copyright (c) International Business Machines Corp., 2006
+.\" Copyright (c) International Business Machines orp., 2006
.\"
-.\" This program is free software; you can redistribute it and/or
+.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
.\" the GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
-.\" along with this program; if not, write to the Free Software
+.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston,
.\" MA 02111-1307 USA
.\"
.\" HISTORY:
.\" 2006-04-27, created by Eduardo M. Fleury <efleury@br.ibm.com>
-.\" with various additions by Michael Kerrisk <mtk-manpages@gmx.net>
+.\" with various additions by Michael Kerrisk <mtk-manpages@gmx.net>
.\"
-.\" FIXME Documentation/block/ioprio.txt says:
-.\" With the introduction of cfq v3 (aka cfq-ts or time sliced
-.\" cfq), basic io priorities is supported for reads on files.
-.\" Does some of this text need to be worked into the man page?
-.\" Especially "supported for reads on files".
-.\"
-.\" FIXME
-.\" We have some general problems:
-.\" These calls aren't in glibc yet. Why aren't they there yet?
-.\" Ask Jens Axboe about this. Perhaps something needs to be pushed
-.\" to Ulrich Drepper so that suitable stuff ends up in the glibc
-.\" tree.
.\"
.TH IOPRIO_GET 2 2006-04-27 "2.6.13" "Linux Programmer's Manual"
.SH NAME
.B IOPRIO_CLASS_IDLE
is the lowest)
or if it belongs to the same priority class as the other process but
-has a lower priority number (a lower priority number means a
+has a higher priority level (a lower priority number means a
higher priority level).
The
.PP
See the NOTES section for more
information on scheduling classes and priorities.
+
+I/O priorities are supported for reads and for synchronous (O_DIRECT,
+O_SYNC) writes. I/O priorities are not supported for asynchronous
+writes because they are issued outside the context of the program
+dirtying the memory, and thus program-specific priorities do not apply.
+
.SH "RETURN VALUE"
On success,
.BR ioprio_get ()
.SH NOTES
These system calls only have an effect when used
in conjunction with an I/O scheduler that supports I/O priorities.
-As at kernel 2.6.16 the only such scheduler is the Completely Fair Queuing
+As at kernel 2.6.17 the only such scheduler is the Completely Fair Queuing
(CFQ) I/O scheduler.
.SS "Selecting an I/O Scheduler"
I/O Schedulers are selected on a per-device basis via the special
These system calls have been available on Linux since
kernel 2.6.13.
.SH "SEE ALSO"
-.BR getpriority "(2), " capabilities (7)
+.BR getpriority "(2), " open "(2), " capabilities (7)
.sp
Documentation/block/ioprio.txt in the kernel source tree.