.\" -*- 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 "31 октября 2023 г." "Linux man\-pages 6.06" 
.SH ИМЯ
io_cancel \- отменяет ожидающий асинхронный запрос ввода\-вывода
.SH LIBRARY
Real\-time library (\fIlibrt\fP, \fI\-lrt\fP)
.SH СИНТАКСИС
.nf
\fB#include <aio.h>\fP
.P
\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)).
.P
Normal asynchronous notification occurs for canceled requests (see \fBaio\fP(7)
and \fBsigevent\fP(3type)).  The request return status (\fBaio_return\fP(3))  is
set to \-1, and the request error status (\fBaio_error\fP(3))  is set to
\fBECANCELED\fP.  The control block of requests that cannot be canceled is not
changed.
.P
Если запрос не может быть отменён, то он завершается как обычно после
выполнения операции ввода\-вывода (в этом случае \fBaio_error\fP(3) вернёт
состояние \fBEINPROGRESSS\fP).
.P
В случае, если значение \fIaiocbp\fP не равно NULL и \fIfd\fP отличается от
файлового дескриптора, для которого создавалась асинхронная операция, то
поведение непредсказуемо.
.P
.\" 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
.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 .