الاسم¶

io_cancel - إلغاء عملية إدخال/إخراج غير متزامنة معلقة

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

بديلًا عن ذلك، مكتبة الإدخال/الإخراج غير المتزامنة (libaio،‏ -laio)؛ انظر VERSIONS.

موجز¶

#include <linux/aio_abi.h>    /* تعريف الأنواع المطلوبة */
#include <sys/syscall.h>      /* تعريف ثوابت SYS_* */
#include <unistd.h>

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

الوصف¶

ملاحظة: تصف هذه الصفحة واجهة نداء نظام لينكس الخام. تستخدم دالة الغلاف التي توفرها libaio نوعًا مختلفًا لمعامل ctx_id. راجع VERSIONS.

تحاول استدعاء النظام io_cancel() إلغاء عملية إدخال/إخراج غير متزامنة سبق إرسالها باستخدام io_submit(2). تصف الوسيطة iocb العملية المراد إلغاؤها، والوسيطة ctx_id هي سياق AIO الذي أُرسلت إليه العملية. إذا أُلغيت العملية بنجاح، يُنسخ الحدث إلى الذاكرة المشار إليها بواسطة result دون وضعه في قائمة انتظار الإكمال.

قيمة الإرجاع¶

عند النجاح، تُرجع io_cancel() 0. بالنسبة لقيمة الإرجاع عند الفشل، انظر VERSIONS.

الأخطاء¶

EAGAIN

لم يُلغَ iocb المُحدد.

EFAULT

إحدى بنيات البيانات تشير إلى بيانات غير صالحة.

EINVAL

سياق AIO المحدد بواسطة ctx_id غير صالح.

ENOSYS

io_cancel() غير مُطبّق على هذه البنية.

الإصدارات¶

ربما ترغب في استخدام دالة الغلاف io_cancel() المقدمة من libaio.

لاحظ أن دالة الغلاف libaio تستخدم نوعًا مختلفًا (io_context_t) للمعامل ctx_id. لاحظ أيضًا أن غلاف libaio لا يتبع اصطلاحات مكتبة C المعتادة للإشارة إلى الأخطاء: فعند حدوث خطأ، يُرجع رقم خطأ منفيًا (سالب إحدى القيم المدرجة في الأخطاء ERRORS). إذا استُدعي نداء النظام عبر syscall(2)، فإن القيمة المرجعة تتبع الاصطلاحات المعتادة للإشارة إلى الخطأ: -1، مع ضبط errno على قيمة (موجبة) تشير إلى الخطأ.

المعايير¶

لينكس.

التاريخ¶

لينكس 2.5.

انظر أيضًا¶

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

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.