НАИМЕНОВАНИЕ

       io_cancel - отменяет невыполненную асинхронную операцию ввода-вывода

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

       Alternatively, Asynchronous I/O library (libaio, -laio); see VERSIONS.

ОБЗОР

       #include <linux/aio_abi.h>    /* Definition of needed types */
       #include <sys/syscall.h>      /* Definition of SYS_* constants */
       #include <unistd.h>

       int syscall(SYS_io_cancel, aio_context_t ctx_id, struct iocb *iocb,
                   struct io_event *result);

ОПИСАНИЕ

       Note:  this  page describes the raw Linux system call interface.  The wrapper function provided by libaio
       uses a different type for the ctx_id argument.  See VERSIONS.

       Системный вызов io_cancel() пытается  отменить  асинхронную  операцию  ввода-вывода,  ранее  отправленную
       системным  вызовом io_submit(2). В В параметре iocb указывается отменяемая операция, а в параметре ctx_id
       задаётся идентификатор контекста AIO отправленной операции. Если операция успешно  отменена,  то  событие
       будет скопировано в память, куда указывает result, без помещения в очередь выполнения.

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

       On success, io_cancel()  returns 0.  For the failure return, see VERSIONS.

ОШИБКИ

       EAGAIN Указанный iocb не был отменен.

       EFAULT Одна из структур данных указывает на некорректные данные.

       EINVAL Некорректен контекст AIO, указанный ctx_id.

       ENOSYS Вызов io_cancel() не реализован для этой архитектуры.

ВЕРСИИ

       You probably want to use the io_cancel()  wrapper function provided by libaio.

       Заметим,  что  в обёрточной функции libaio используется другой тип (io_context_t) аргумента ctx_id. Также
       заметим, что libaio не следует соглашениям обычной библиотеки C  для  возврата  ошибок:  при  ошибке  она
       возвращает  отрицательный  номер  ошибки  (из списка в разделе ОШИБКИ). Если системный вызов вызывается с
       помощью syscall(2), то  возвращаемое  значение  следует  обычным  соглашениям  для  указания  на  ошибку:
       возвращается -1 и в errno записывается (положительное) значение возникшей ошибки.

СТАНДАРТЫ

       Linux.

ИСТОРИЯ

       Linux 2.5.

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

       io_destroy(2), io_getevents(2), io_setup(2), io_submit(2), aio(7)

ПЕРЕВОД

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

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

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

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                     io_cancel(2)