الاسم¶

io_destroy - تدمير سياق إدخال/إخراج غير متزامن

المكتبة¶

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

موجز¶

#include <linux/aio_abi.h>    /* Definition of aio_context_t */
#include <sys/syscall.h>      /* Definition of SYS_* constants */
#include <unistd.h>

int syscall(SYS_io_destroy, aio_context_t ctx_id);

ملاحظة: لا توفر glibc غلافًا لـ io_destroy()، مما يستلزم استخدام syscall(2).

الوصف¶

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

ستحاول دعوة النظام io_destroy() إلغاء جميع عمليات الإدخال/الإخراج غير المتزامنة المعلقة الخاصة بـ ctx_id، وستتوقف عند اكتمال جميع العمليات التي تعذر إلغاؤها، وسيُلغى ctx_id.

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

في حالة النجاح، تُرجع الدالة io_destroy() القيمة 0. للاطلاع على حالة الفشل، انظر قسم ”الإصدارات“.

الأخطاء¶

EFAULT

السياق المشار إليه غير صالح.

EINVAL

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

ENOSYS

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

الإصدارات¶

ربما تريد استخدام دالة الغلاف io_destroy() التي يوفرها libaio؛ انظر الإصدارات.

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

المعايير¶

لينكس.

التاريخ¶

لينكس 2.5.

انظر أيضًا¶

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

ترجمة¶

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

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

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