ИМЯ

ioprio_get, ioprio_set - получает/устанавливает класс и приоритет планирования ввода-вывода

LIBRARY

Standard C library (libc, -lc)

СИНТАКСИС

#include <linux/ioprio.h>    /* определения констант IOPRIO_* */
#include <sys/syscall.h>     /* определения констант SYS_* */
#include <unistd.h>

int syscall(SYS_ioprio_get, int which, int who);
int syscall(SYS_ioprio_set, int which, int who, int ioprio);

Note: glibc provides no wrappers for these system calls, necessitating the use of syscall(2).

ОПИСАНИЕ

Системные вызовы ioprio_get() и ioprio_set() получают и устанавливают класс и приоритет планирования ввода-вывода одной или более нитей.

В аргументах which и who указывается нить(и), над которой выполняются системные вызовы. В аргументе which указывается как будет рассматриваться who; он может иметь одно из следующих значений:

IOPRIO_WHO_PROCESS

Значением who является идентификатор процесса или нити, определяющий один процесс или нить. Если who равно 0, то операции выполняются над вызвавшей нитью.

IOPRIO_WHO_PGRP

Значением who является идентификатор группы, определяющий всех членов группы процесса. Если who равно 0, то операции выполняются над группой процессов, членом которой является вызвавший.

IOPRIO_WHO_USER

Значением who является идентификатор пользователя, определяющий все процессы, которые имеют этот реальный идентификатор.

Если при вызове ioprio_get() в which указано IOPRIO_WHO_PGRP или IOPRIO_WHO_USER, и под шаблон who подходит более одного процесса, то возвращаемый приоритет будет равен самому высокому значению среди процессов этой группы. Считается, что один приоритет больше другого, если он принадлежит более высокому классу процессов (IOPRIO_CLASS_RT является самым высоким классом приоритетов; IOPRIO_CLASS_IDLE — самым низким), или если оба процесса принадлежат одному классу, то тогда самым высоким будет приоритет с большим уровнем (меньший номер приоритета, означает более высокий уровень).

Аргумент ioprio, задаваемый в ioprio_set(), является битовой маской, в которой указываются класс планирования и приоритет, назначаемый заданному процессу(ам). Для компоновки и разделения значений ioprio используются следующие макросы:

IOPRIO_PRIO_VALUE(class, data)

Объединяет заданный класс планирования class и приоритет (data) в значение ioprio, которое возвращается как результат макроса.

IOPRIO_PRIO_CLASS(mask)

Из указанной маски mask (значение ioprio) возвращает значение класса ввода-вывода, то есть одно из значений: IOPRIO_CLASS_RT, IOPRIO_CLASS_BE или IOPRIO_CLASS_IDLE.

IOPRIO_PRIO_DATA(mask)

Из указанной маски mask (значение ioprio) возвращает значение приоритета (data).

Подробней о классах планирования и приоритетах, а также о значении 0 в ioprio смотрите в разделе ЗАМЕЧАНИЯ.

Приоритеты ввода-вывода поддерживаются при операциях чтения и синхронной (O_DIRECT, O_SYNC) записи. Приоритеты ввода-вывода не поддерживаются при асинхронной записи, так как они вызываются вне контекста программы засоряющей память, и поэтому приоритеты программы не применяются.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении ioprio_get() возвращается значение ioprio процесса с самым высоким приоритетом ввода-вывода из всех процессов, подходящих под критерий, указанный в which и who. При ошибке возвращается -1, а в errno содержится код ошибки.

При успешном выполнении ioprio_set() возвращается 0. При ошибке возвращается -1, а в errno содержится код ошибки.

ОШИБКИ

EINVAL

Неправильное значение which или ioprio. Обратитесь к разделу ЗАМЕЧАНИЯ, в нём приведены доступные классы планировщика и уровни приоритета ioprio.

EPERM

У вызывающего процесса нет прав, необходимых для назначения данного ioprio указанному процессу(ам). Более подробную информацию о необходимых правах ioprio_set() можно найти в разделе ЗАМЕЧАНИЯ.

ESRCH

Не найдено процессов, которые бы соответствовали заданным в which и who критериям.

СТАНДАРТЫ

Linux.

ИСТОРИЯ

Linux 2.6.13.

ПРИМЕЧАНИЯ

Два или более процесса или нити могут использовать общий контекст ввода-вывода. Это может происходить в случае, если вызывается clone(2) с флагом CLONE_IO. Однако по умолчанию разные нити процесса не будут использовать общий контекст ввода-вывода. Это означает, что если вы хотите изменить приоритет ввода-вывода всех нитей процесса, то вам может потребоваться вызвать ioprio_set() для каждой нити. Идентификатор нити, требуемый для этой операции, можно получить с помощью gettid(2) или clone(2).

Данные системные вызовы действительно работают только, если используется планировщик ввода-вывода, поддерживающий приоритеты ввода-вывода. В ядре 2.6.17 такой планировщик только один: Completely Fair Queuing (CFQ).

If no I/O scheduler has been set for a thread, then by default the I/O priority will follow the CPU nice value (setpriority(2)). Before Linux 2.6.24, once an I/O priority had been set using ioprio_set(), there was no way to reset the I/O scheduling behavior to the default. Since Linux 2.6.24, specifying ioprio as 0 can be used to reset to the default I/O scheduling behavior.

$ cat /sys/block/sda/queue/scheduler
noop anticipatory deadline [cfq]

$ su
Password:
# echo cfq > /sys/block/sda/queue/scheduler

ОШИБКИ

glibc does not yet provide a suitable header file defining the function prototypes and macros described on this page. Suitable definitions can be found in linux/ioprio.h.

СМОТРИТЕ ТАКЖЕ

ionice(1), getpriority(2), open(2), capabilities(7), cgroups(7)

Файл Documentation/block/ioprio.txt в дереве исходного кода ядра Linux

ПЕРЕВОД

Русский перевод этой страницы руководства разработал Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.