.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2010, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH lio_listio 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم lio_listio \- بدء قائمة طلبات الإدخال/الإخراج .SH المكتبة مكتبة الوقت الحقيقي (\fIlibrt\fP،\ \fI\-lrt\fP) .SH موجز .nf \fB#include \fP .P \fBint lio_listio(\fPint n; \fB int \fP\fImode\fP\fB,\fP \fB struct aiocb *restrict const \fP\fIaiocb_list\fP\fB[restrict \fP\fIn\fP\fB],\fP \fB int \fP\fIn\fP\fB, struct sigevent *restrict \fP\fIsevp\fP\fB);\fP .fi .SH الوصف الدالة \fBlio_listio\fP() تبدأ قائمة عمليات الإدخال/الإخراج الموصوفة بالمصفوفة \fIaiocb_list\fP. .P عملية \fImode\fP لها إحدى القيم التالية: .TP \fBLIO_WAIT\fP يحجب الاستدعاء حتى تكتمل جميع العمليات. يُتجاهل المعامل \fIsevp\fP. .TP \fBLIO_NOWAIT\fP تُصطف عمليات الإدخال/الإخراج للمعالجة ويعود الاستدعاء فورًا. عند اكتمال جميع عمليات الإدخال/الإخراج، يحدث إشعار غير متزامن، كما هو محدد بالمعامل \fIsevp\fP؛ انظر \fBsigevent\fP(3type) للتفاصيل. إذا كان \fIsevp\fP NULL، لا يحدث أي إشعار غير متزامن. .P المعامل \fIaiocb_list\fP هو مصفوفة من المؤشرات إلى بنى \fIaiocb\fP التي تصف عمليات الإدخال/الإخراج. تُنفذ هذه العمليات بترتيب غير محدد. يحدد المعامل \fIn\fP حجم المصفوفة \fIaiocb_list\fP. تُتجاهل المؤشرات الفارغة في \fIaiocb_list\fP. .P في كل كتلة تحكم في \fIaiocb_list\fP، يحدد الحقل \fIaio_lio_opcode\fP عملية الإدخال/الإخراج التي ستبدأ، كما يلي: .TP \fBLIO_READ\fP ابدأ عملية قراءة. تُصطف العملية كما في استدعاء \fBaio_read\fP(3) الذي يحدد كتلة التحكم هذه. .TP \fBLIO_WRITE\fP ابدأ عملية كتابة. تُصطف العملية كما في استدعاء \fBaio_write\fP(3) الذي يحدد كتلة التحكم هذه. .TP \fBLIO_NOP\fP تجاهل كتلة التحكم هذه. .P للحقول المتبقية في كل كتلة تحكم نفس المعاني كما في \fBaio_read\fP(3) و \fBaio_write\fP(3). يمكن استخدام حقول \fIaio_sigevent\fP لكل كتلة تحكم لتحديد إشعارات لعمليات الإدخال/الإخراج الفردية (انظر \fBsigevent\fP(7)). .SH "قيمة الإرجاع" إذا كان \fImode\fP هو \fBLIO_NOWAIT\fP، تُرجع \fBlio_listio\fP() 0 إذا صُفت جميع عمليات الإدخال/الإخراج بنجاح. وإلا، تُرجع \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .P إذا كان \fImode\fP هو \fBLIO_WAIT\fP، تُرجع \fBlio_listio\fP() 0 عندما تكتمل جميع عمليات الإدخال/الإخراج بنجاح. وإلا، تُرجع \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .P توفر حالة العودة من \fBlio_listio\fP() معلومات فقط عن الاستدعاء نفسه، وليس عن عمليات الإدخال/الإخراج الفردية. قد تفشل عملية أو أكثر من عمليات الإدخال/الإخراج، لكن هذا لا يمنع اكتمال العمليات الأخرى. يمكن تحديد حالة عمليات الإدخال/الإخراج الفردية في \fIaiocb_list\fP باستخدام \fBaio_error\fP(3). عند اكتمال عملية، يمكن الحصول على حالة عودتها باستخدام \fBaio_return\fP(3). يمكن أن تفشل عمليات الإدخال/الإخراج الفردية للأسباب الموصوفة في \fBaio_read\fP(3) و \fBaio_write\fP(3). .SH الأخطاء قد تفشل الدالة \fBlio_listio\fP() للأسباب التالية: .TP \fBEAGAIN\fP نفاد الموارد. .TP \fBEAGAIN\fP .\" Doesn't happen in glibc(?) عدد عمليات الإدخال/الإخراج المحددة بواسطة \fIn\fP قد يتسبب في تجاوز الحد \fBAIO_MAX\fP. .TP \fBEINTR\fP كان \fImode\fP هو \fBLIO_WAIT\fP وتم التقاط إشارة قبل اكتمال جميع عمليات الإدخال/الإخراج؛ انظر \fBsignal\fP(7). (قد تكون هذه إحدى الإشارات المستخدمة لإعلام اكتمال الإدخال/الإخراج غير المتزامن.) .TP \fBEINVAL\fP .\" Doesn't happen in glibc(?) \fImode\fP غير صالح، أو \fIn\fP يتجاوز الحد \fBAIO_LISTIO_MAX\fP. .TP \fBEIO\fP .\" e.g., ioa_reqprio or aio_lio_opcode was invalid فشلت واحدة أو أكثر من العمليات المحددة بواسطة \fIaiocb_list\fP. يمكن للتطبيق التحقق من حالة كل عملية باستخدام \fBaio_return\fP(3). .P إذا فشلت \fBlio_listio\fP() مع الخطأ \fBEAGAIN\fP أو \fBEINTR\fP أو \fBEIO\fP، فقد تكون بعض العمليات في \fIaiocb_list\fP قد بدأت. إذا فشلت \fBlio_listio\fP() لأي سبب آخر، فلن تكون أي من عمليات الإدخال/الإخراج قد بدأت. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBlio_listio\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير POSIX.1\-2008. .SH التاريخ glibc 2.1. POSIX.1\-2001. .SH ملاحظات .\" or the control block of the operation من الجيد تصفير كتل التحكم قبل الاستخدام. يجب عدم تغيير كتل التحكم أثناء تنفيذ عمليات الإدخال/الإخراج. يجب عدم الوصول إلى مناطق المخزن المؤقت التي يتم القراءة منها أو الكتابة إليها أثناء العمليات وإلا قد تحدث نتائج غير محددة. يجب أن تظل مناطق الذاكرة المعنية صالحة. .P تؤدي عمليات الإدخال/الإخراج المتزامنة التي تحدد نفس بنية \fIaiocb\fP إلى نتائج غير محددة. .SH "انظر أيضًا" \fBaio_cancel\fP(3), \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_return\fP(3), \fBaio_suspend\fP(3), \fBaio_write\fP(3), \fBaio\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .