> Linux Reviews > man >

io_cancel


  1. io_cancel.2.man


1. io_cancel.2.man

Manpage of IO_CANCEL

IO_CANCEL

Section: Руководство программиста Linux (2)
Updated: 2008-06-18
Index Return to Main Contents
 

ИМЯ

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

ОБЗОР

#include <libaio.h>

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

Компонуется при указании параметра -laio.
 

ОПИСАНИЕ

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

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

В случае успешного завершения io_cancel() возвращает 0. В случае ошибки смотрите ЗАМЕЧАНИЯ.  

ОШИБКИ

EAGAIN
Указанный iocb не был отменен.
EFAULT
Одна из структур данных указывает на некорректные данные.
EINVAL
Некорректен контекст AIO, указанный ctx_id.
ENOSYS
Вызов io_cancel() не реализован для этой архитектуры.
 

ВЕРСИИ

Асинхронные системные вызовы ввода-вывода впервые появились в Linux 2.5 в августе 2002 года.  

СООТВЕТСТВИЕ СТАНДАРТАМ

Вызов io_cancel() есть только в Linux, и он не должен использоваться в переносимых программах.  

ЗАМЕЧАНИЯ

В glibc нет обёрточной функции для данного системного вызова.

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

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

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


 

Index

ИМЯ
ОБЗОР
ОПИСАНИЕ
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
ОШИБКИ
ВЕРСИИ
СООТВЕТСТВИЕ СТАНДАРТАМ
ЗАМЕЧАНИЯ
СМОТРИТЕ ТАКЖЕ

This document was created by man2html using the manual pages.
Time: 17:41:22 GMT, October 23, 2013

SVENSKA - SVENSKA - ja