.\" -*- coding: UTF-8 -*- .\" Copyright 2003, Davide Libenzi .\" Copyright 2009-2019, 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 epoll_create 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم epoll_create, epoll_create1 \- فتح واصف ملف epoll .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint epoll_create(int \fP\fIsize\fP\fB);\fP \fBint epoll_create1(int \fP\fIflags\fP\fB);\fP .fi .SH الوصف \fBepoll_create\fP() تنشئ مثيل \fBepoll\fP(7) جديد. منذ لينكس 2.6.8، يتم تجاهل وسيط \fIsize\fP، لكن يجب أن يكون أكبر من الصفر؛ انظر التاريخ. .P \fBepoll_create\fP() تُرجع واصف ملف يشير إلى مثيل epoll الجديد. يُستخدم واصف الملف هذا لجميع الاستدعاءات اللاحقة لواجهة \fBepoll\fP. عندما لا يعود هناك حاجة إليه، يجب إغلاق واصف الملف الذي أرجعته \fBepoll_create\fP() باستخدام \fBclose\fP(2). عندما يتم إغلاق جميع واصفات الملفات التي تشير إلى مثيل epoll، يُدمر النواة المثيل ويُحرر الموارد المرتبطة لإعادة الاستخدام. .SS epoll_create1() إذا كان \fIflags\fP يساوي 0، فبصرف النظر عن حقيقة إسقاط وسيط \fIsize\fP القديم، فإن \fBepoll_create1\fP() مماثلة لـ \fBepoll_create\fP(). يمكن تضمين القيمة التالية في \fIflags\fP للحصول على سلوك مختلف: .TP \fBEPOLL_CLOEXEC\fP اضبط علامة الإغلاق عند التنفيذ (\fBFD_CLOEXEC\fP) على واصف الملف الجديد. انظر وصف العلامة \fBO_CLOEXEC\fP في \fBopen\fP(2) للأسباب التي تجعل هذا مفيدًا. .SH "قيمة الإرجاع" عند النجاح، تُرجع استدعاءات النظام هذه واصف ملف (عدد صحيح غير سالب). عند الخطأ، يتم إرجاع \-1، ويتم تعيين \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEINVAL\fP \fIsize\fP ليس موجبًا. .TP \fBEINVAL\fP (\fBepoll_create1\fP()) قيمة غير صالحة محددة في \fIflags\fP. .TP \fBEMFILE\fP وُصل إلى الحد الأقصى لواصفات الملفات المفتوحة لكل عملية. .TP \fBENFILE\fP وُصل إلى الحد الأقصى لإجمالي عدد الملفات المفتوحة على مستوى النظام. .TP \fBENOMEM\fP ذاكرة غير كافية لإنشاء كائن النواة. .SH المعايير لينكس. .SH التاريخ .TP \fBepoll_create\fP() .\" To be precise: kernel 2.5.44. .\" The interface should be finalized by Linux kernel 2.5.66. لينكس 2.6، glibc 2.3.2. .TP \fBepoll_create1\fP() لينكس 2.6.27، glibc 2.9. .P في تنفيذ \fBepoll_create\fP() الأولي، أبلغ وسيط \fIsize\fP النواة بعدد واصفات الملفات التي يتوقع المتصل إضافتها إلى مثيل \fBepoll\fP. استخدمت النواة هذه المعلومات كتلميح لمقدار المساحة التي ستخصصها مبدئيًا في هياكل البيانات الداخلية التي تصف الأحداث. (إذا لزم الأمر، ستخصص النواة مساحة أكبر إذا تجاوز استخدام المتصل التلميح المعطى في \fIsize\fP.) في الوقت الحاضر، لم يعد هذا التلميح مطلوبًا (تقوم النواة بحجم هياكل البيانات المطلوبة ديناميكيًا دون الحاجة إلى التلميح)، لكن يجب أن يكون \fIsize\fP أكبر من الصفر، لضمان التوافق مع الإصدارات السابقة عند تشغيل تطبيقات \fBepoll\fP الجديدة على أنوية أقدم. .P .\" commit 9df04e1f25effde823a600e755b51475d438f56b قبل لينكس 2.6.29، حدد معامل نواة \fI/proc/sys/fs/epoll/max_user_instances\fP مثيلات epoll النشطة لكل معرف مستخدم حقيقي، وتسبب في فشل \fBepoll_create\fP() مع \fBEMFILE\fP عند التجاوز. .SH "انظر أيضًا" \fBclose\fP(2), \fBepoll_ctl\fP(2), \fBepoll_wait\fP(2), \fBioctl_eventpoll\fP(2), \fBepoll\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 .