table of contents
IONICE(1) | User Commands | IONICE(1) |
NAME¶
ionice - set or get process I/O scheduling class and priority
SYNOPSIS¶
ionice [-c class] [-n level] [-t] -p PID
ionice [-c class] [-n level] [-t] -P PGID
ionice [-c class] [-n level] [-t] -u UID
ionice [-c class] [-n level] [-t] command [argument] ...
DESCRIPTION¶
This program sets or gets the I/O scheduling class and priority for a program. If no arguments or just -p is given, ionice will query the current I/O scheduling class and priority for that process.
When command is given, ionice will run this command with the given arguments. If no class is specified, then command will be executed with the "best-effort" scheduling class. The default priority level is 4.
As of this writing, a process can be in one of three scheduling classes:
Idle
Best-effort
Note that before kernel 2.6.26 a process that has not asked for an I/O priority formally uses "none" as scheduling class, but the I/O scheduler will treat such processes as if it were in the best-effort class. The priority within the best-effort class will be dynamically derived from the CPU nice level of the process: io_priority = (cpu_nice + 20) / 5.
For kernels after 2.6.26 with the CFQ I/O scheduler, a process that has not asked for an I/O priority inherits its CPU scheduling class. The I/O priority is derived from the CPU nice level of the process (same as before kernel 2.6.26).
Realtime
OPTIONS¶
-c, --class class
-n, --classdata level
-p, --pid PID...
-P, --pgid PGID...
-t, --ignore
-u, --uid UID...
-h, --help
-V, --version
NOTES¶
Linux supports I/O scheduling priorities and classes since 2.6.13 with the CFQ I/O scheduler.
EXAMPLES¶
Sets process with PID 89 as an idle I/O process.
Runs 'bash' as a best-effort program with highest priority.
Prints the class and priority of the processes with PID 89 and 91.
AUTHORS¶
Jens Axboe <jens@axboe.dk>, Karel Zak <kzak@redhat.com>
SEE ALSO¶
REPORTING BUGS¶
For bug reports, use the issue tracker at <https://github.com/util-linux/util-linux/issues>.
AVAILABILITY¶
The ionice command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.
2022-05-11 | util-linux 2.38.1 |