.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2003 Free Software Foundation, Inc. .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH io_cancel 2 "2 мая 2024 г." "Справочные страницы Linux 6.9.1" .SH ИМЯ io_cancel \- отменяет невыполненную асинхронную операцию ввода\-вывода .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP, \fI\-lc\fP) .P Alternatively, Asynchronous I/O library (\fIlibaio\fP, \fI\-laio\fP); see VERSIONS. .SH СИНТАКСИС .nf \fB#include \fP /* Definition of needed types */ \fB#include \fP /* Definition of \fBSYS_*\fP constants */ \fB#include \fP .P \fBint syscall(SYS_io_cancel, aio_context_t \fP\fIctx_id\fP\fB, struct iocb *\fP\fIiocb\fP\fB,\fP \fB struct io_event *\fP\fIresult\fP\fB);\fP .fi .SH ОПИСАНИЕ \fINote\fP: this page describes the raw Linux system call interface. The wrapper function provided by \fIlibaio\fP uses a different type for the \fIctx_id\fP argument. See VERSIONS. .P Системный вызов \fBio_cancel\fP() пытается отменить асинхронную операцию ввода\-вывода, ранее отправленную системным вызовом \fBio_submit\fP(2). В В параметре \fIiocb\fP указывается отменяемая операция, а в параметре \fIctx_id\fP задаётся идентификатор контекста AIO отправленной операции. Если операция успешно отменена, то событие будет скопировано в память, куда указывает \fIresult\fP, без помещения в очередь выполнения. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" On success, \fBio_cancel\fP() returns 0. For the failure return, see VERSIONS. .SH ОШИБКИ .TP \fBEAGAIN\fP Указанный \fIiocb\fP не был отменен. .TP \fBEFAULT\fP Одна из структур данных указывает на некорректные данные. .TP \fBEINVAL\fP Некорректен контекст AIO, указанный \fIctx_id\fP. .TP \fBENOSYS\fP Вызов \fBio_cancel\fP() не реализован для этой архитектуры. .SH ВЕРСИИ .\" http://git.fedorahosted.org/git/?p=libaio.git You probably want to use the \fBio_cancel\fP() wrapper function provided by \fIlibaio\fP. .P .\" But glibc is confused, since uses 'io_context_t' to declare .\" the system call. Заметим, что в обёрточной функции \fIlibaio\fP используется другой тип (\fIio_context_t\fP) аргумента \fIctx_id\fP. Также заметим, что \fIlibaio\fP не следует соглашениям обычной библиотеки C для возврата ошибок: при ошибке она возвращает отрицательный номер ошибки (из списка в разделе ОШИБКИ). Если системный вызов вызывается с помощью \fBsyscall\fP(2), то возвращаемое значение следует обычным соглашениям для указания на ошибку: возвращается \-1 и в \fIerrno\fP записывается (положительное) значение возникшей ошибки. .SH СТАНДАРТЫ Linux. .SH ИСТОРИЯ Linux 2.5. .SH "СМОТРИТЕ ТАКЖЕ" \fBio_destroy\fP(2), \fBio_getevents\fP(2), \fBio_setup\fP(2), \fBio_submit\fP(2), \fBaio\fP(7) .\" .SH AUTHOR .\" Kent Yoder. .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) Azamat Hackimov , Dmitriy S. Seregin , Yuri Kozlov и Иван Павлов . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT списка рассылки русских переводчиков .ME .