.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH aio_cancel 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
io_cancel \- отменяет ожидающий асинхронный запрос ввода\-вывода
.SH LIBRARY
Real\-time library (\fIlibrt\fP, \fI\-lrt\fP)
.SH СИНТАКСИС
.nf
\fB#include <aio.h>\fP
.PP
\fBint aio_cancel(int \fP\fIfd\fP\fB, struct aiocb *\fP\fIaiocbp\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Функция \fBaio_cancel\fP() пытается отменить ожидающие асинхронные запросы
ввода\-вывода для файлового дескриптора \fIfd\fP. Если значение \fIaiocbp\fP равно
NULL, то отменяются все запросы. В противном случае, отменяется только
запрос, описанный в управляющем блоке, на который указывает значение
\fIaiocbp\fP (описание структуры \fIaiocb\fP смотрите в \fBaio\fP(7)).
.PP
При отмене запроса посылаются обычные асинхронные уведомления (смотрите
\fBaio\fP(7) и \fBsigevent\fP(7)). Запрос возвращает состояние (\fBaio_return\fP(3))
равное \-1, а состояние ошибки (\fBaio_error\fP(3)) устанавливается в
\fBECANCELED\fP. Управляющие блоки запросов, которые не могут быть отменены, не
изменяются.
.PP
Если запрос не может быть отменён, то он завершается как обычно после
выполнения операции ввода\-вывода (в этом случае \fBaio_error\fP(3) вернёт
состояние \fBEINPROGRESSS\fP).
.PP
В случае, если значение \fIaiocbp\fP не равно NULL и \fIfd\fP отличается от
файлового дескриптора, для которого создавалась асинхронная операция, то
поведение непредсказуемо.
.PP
.\" FreeBSD: not those on raw disk devices.
Список операций, которые можно отменять, зависит от реализации.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBaio_cancel\fP() возвращает одно из следующих значений:
.TP 
\fBAIO_CANCELED\fP
Все запросы успешно отменены.
.TP 
\fBAIO_NOTCANCELED\fP
Как минимум, один указанный запрос не отменён, так как он находится в
состоянии выполнения. В этом случае можно проверить состояние каждого
запроса с помощью \fBaio_error\fP(3).
.TP 
\fBAIO_ALLDONE\fP
Все запросы выполнены ещё до вызова.
.TP 
\-1
Произошла ошибка. Значение ошибки можно узнать из \fIerrno\fP.
.SH ОШИБКИ
.TP 
\fBEBADF\fP
Значение \fIfd\fP не является правильным файловым дескриптором.
.TP 
\fBENOSYS\fP
Функция \fBaio_cancel\fP() не реализована.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBaio_cancel\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.sp 1
.SH СТАНДАРТЫ
POSIX.1\-2008.
.SH ИСТОРИЯ
glibc 2.1.  POSIX.1\-2001.
.SH ПРИМЕРЫ
Смотрите \fBaio\fP(7).
.SH "СМ. ТАКЖЕ"
\fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3),
\fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBlio_listio\fP(3), \fBaio\fP(7)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Dmitry Bolkhovskikh <d20052005@yandex.ru>
и
Yuri Kozlov <yuray@komyakino.ru>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .