.\" -*- coding: UTF-8 -*-
.\" Copyright 2003, Free Software Foundation, Inc.
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH io_getevents 2 "11 أبريل 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
io_getevents \- اقرأ أحداث الإدخال/الإخراج غير المتزامنة من طابور الإكمال
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <linux/aio_abi.h>\fP    /* Definition of \fB*io_*\fP types */
\fB#include <sys/syscall.h>\fP      /* Definition of \fBSYS_*\fP constants */
\fB#include <unistd.h>\fP
.P
\fBint syscall(SYS_io_getevents, aio_context_t \fP\fIctx_id\fP\fB,\fP
\fB            long \fP\fImin_nr\fP\fB, long \fP\fInr\fP\fB, struct io_event *\fP\fIevents\fP\fB,\fP
\fB            struct timespec *\fP\fItimeout\fP\fB);\fP
.fi
.SH الوصف
\fIملاحظة\fP: ربما تريد استخدام دالة الغلاف \fBio_getevents\fP(3) التي يوفرها
\fIlibaio\fP؛ انظر الإصدارات.
.P
استدعاء النظام \fBio_getevents\fP()  يحاول قراءة \fImin_nr\fP حدث على الأقل وحتى
\fInr\fP حدث من طابور الإكمال لسياق AIO المحدد بواسطة \fIctx_id\fP.
.P
الوسيطة \fItimeout\fP تحدد مقدار الوقت للانتظار للأحداث، وتُحدد كمهلة نسبية في
بنية \fBtimespec\fP(3).
.P
الوقت المحدد يُقرّب لأعلى لدقة ساعة النظام ويُضمن عدم انتهائه مبكرًا.
.P
تحديد \fItimeout\fP كـ NULL يعني الحظر إلى أجل غير مسمى حتى يتم الحصول على
\fImin_nr\fP حدث على الأقل.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع \fBio_getevents\fP()  عدد الأحداث المقروءة. قد يكون هذا 0، أو
قيمة أقل من \fImin_nr\fP، إذا انتهت المهلة \fItimeout\fP. قد يكون أيضًا قيمة غير
صفرية أقل من \fImin_nr\fP، إذا قاطع معالج إشارة الاستدعاء.
.P
عند الخطأ، تُعاد القيمة \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEFAULT\fP
إما \fIevents\fP أو \fItimeout\fP مؤشر غير صالح.
.TP 
\fBEINTR\fP
مقاطع بواسطة معالج إشارة؛ انظر \fBsignal\fP(7).
.TP 
\fBEINVAL\fP
\fIctx_id\fP غير صالح.
.TP 
\fBEINVAL\fP
\fImin_nr\fP خارج النطاق أو \fInr\fP خارج النطاق.
.TP 
\fBENOSYS\fP
\fBio_getevents\fP()  غير مطبّق على هذه البنية.
.SH الإصدارات
توفر
.UR https://pagure.io/libaio
\fIlibaio\fP
.UE
دالة تغليف تحمل الاسم
نفسه، ولكن بنموذج أولي وقيمة إرجاع مختلفين.  من المرجح أنك تريد استخدام دالة
التغليف تلك.
.SH المعايير
لينكس.
.SH التاريخ
لينكس 2.5.
.SH "انظر أيضًا"
\fBio_cancel\fP(2), \fBio_destroy\fP(2), \fBio_setup\fP(2), \fBio_submit\fP(2),
\fBio_getevents\fP(3), \fBtimespec\fP(3), \fBaio\fP(7), \fBtime\fP(7)
.\" .SH AUTHOR
.\" Kent Yoder.
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .