.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2003, Andries E. Brouwer .\" 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 aio_read 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم aio_read \- قراءة غير متزامنة .SH المكتبة مكتبة الوقت الحقيقي (\fIlibrt\fP،\ \fI\-lrt\fP) .SH موجز .nf \fB#include \fP .P \fBint aio_read(struct aiocb *\fP\fIaiocbp\fP\fB);\fP .fi .SH الوصف الدالة \fBaio_read\fP() تُصَفّ طلب الإدخال/الإخراج الموصوف بالمخزن المشار إليه بواسطة \fIaiocbp\fP. هذه الدالة هي النظير غير المتزامن لـ \fBread\fP(2). وسائط الاستدعاء .P .in +4n .EX read(fd, buf, count) .EE .in .P تتوافق (بالترتيب) مع الحقول \fIaio_fildes\fP و \fIaio_buf\fP و \fIaio_nbytes\fP للبنية التي يشير إليها \fIaiocbp\fP. (راجع \fBaio\fP(7) لوصف بنية \fIaiocb\fP.) .P تُقرأ البيانات بدءًا من الموضع المطلق \fIaiocbp\->aio_offset\fP، بغض النظر عن إزاحة الملف. بعد الاستدعاء، تكون قيمة إزاحة الملف غير محددة. .P يعني "غير متزامن" أن هذا الاستدعاء يعود فور إدراج الطلب في الطابور؛ قد تكون القراءة قد اكتملت أو لا عند عودة الاستدعاء. يُختبر الاكتمال باستخدام \fBaio_error\fP(3). يمكن الحصول على حالة الإرجاع لعملية إدخال/إخراج مكتملة بواسطة \fBaio_return\fP(3). يمكن الحصول على إعلام غير متزامن باكتمال الإدخال/الإخراج بتعيين \fIaiocbp\->aio_sigevent\fP بشكل مناسب؛ انظر \fBsigevent\fP(3type) للتفاصيل. .P إذا كان \fB_POSIX_PRIORITIZED_IO\fP معرفا، وهذا الملف يدعمه، فإن العملية غير المتزامنة تُقدم بأولوية تساوي أولوية العملية المستدعِيَة ناقص \fIaiocbp\->aio_reqprio\fP. .P يُتجاهَل الحقل \fIaiocbp\->aio_lio_opcode\fP. .P لا تُقرأ أي بيانات من ملف عادي بعد أقصى إزاحة له. .SH "قيمة الإرجاع" عند النجاح، يُعاد 0. عند حدوث خطأ، لا يوضع الطلب في الدور، ويُعاد \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. إذا اكتشف الخطأ لاحقًا، سيجري الإبلاغ عنه عبر \fBaio_return\fP(3) (يعيد الحالة \-1) و \fBaio_error\fP(3) (حالة الخطأ\[em]أياً كان ما قد يحصل عليه المرء في \fIerrno\fP، مثل \fBEBADF\fP). .SH الأخطاء .TP \fBEAGAIN\fP نفاد الموارد. .TP \fBEBADF\fP \fIaio_fildes\fP ليس واصف ملف صالحًا مفتوحًا للقراءة. .TP \fBEINVAL\fP واحد أو أكثر من \fIaio_offset\fP أو \fIaio_reqprio\fP أو \fIaio_nbytes\fP غير صالح. .TP \fBENOSYS\fP \fBaio_read\fP() غير مُطبّقة. .TP \fBEOVERFLOW\fP الملف هو ملف عادي، نبدأ القراءة قبل نهاية الملف ونريد بايت واحد على الأقل، لكن موضع البداية يتجاوز أقصى إزاحة لهذا الملف. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBaio_read\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\fP(7). .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), \fBlio_listio\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 .