Scroll to navigation

errno(3) Library Functions Manual errno(3)

الاسم

errno - رقم آخر خطأ

المكتبة

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

موجز

#include <errno.h>

الوصف

يُعرّف ملف الرأس <errno.h> المتغير الصحيح errno، الذي تُعيِّنه استدعاءات النظام وبعض دوال المكتبة عند حدوث خطأ للإشارة إلى ما حدث من خطأ.

errno

قيمة errno ذات دلالة فقط عندما تشير قيمة إرجاع الاستدعاء إلى خطأ (أي -1 من معظم استدعاءات النظام؛ -1 أو NULL من معظم دوال المكتبة)؛ يُسمح لدالة تنجح بـ تغيير errno. لا تُعيِّن أي استدعاء نظام أو دالة مكتبة قيمة errno إلى الصفر أبدًا.

لبعض استدعاءات النظام ودوال المكتبة (مثل getpriority(2))، تكون -1 قيمة إرجاع صالحة عند النجاح. في مثل هذه الحالات، يمكن تمييز الإرجاع الناجح عن إرجاع الخطأ بتعيين errno إلى الصفر قبل الاستدعاء، ثم، إذا أرجع الاستدعاء حالة تشير إلى احتمال حدوث خطأ، يُفحص ما إذا كان errno له قيمة غير صفرية.

يُعرِّف معيار ISO C errno كقيمة يسرى قابلة للتعديل من النوع int، ويجب عدم التصريح عنه صراحةً؛ قد يكون errno ماكروًا. errno محلي الخيط؛ تعيينه في خيط واحد لا يؤثر على قيمته في أي خيط آخر.

أرقام الأخطاء وأسماؤها

أرقام الأخطاء الصالحة هي جميع الأرقام الموجبة. يُعرّف ملف الرأس <errno.h> أسماء رمزية لكل رقم خطأ محتمل قد يظهر في errno.

يجب أن تكون لجميع أسماء الأخطاء المحددة بواسطة POSIX.1 قيم مميزة، باستثناء EAGAIN و EWOULDBLOCK، اللذين قد يكونان متطابقين. على Linux، هذان الاثنان لهما نفس القيمة على جميع البنى.

تختلف أرقام الأخطاء المقابلة لكل اسم رمزي عبر أنظمة UNIX، وحتى عبر البنى المختلفة على Linux. لذلك، لا تُدرج القيم الرقمية كجزء من قائمة أسماء الأخطاء أدناه. يمكن استخدام الدالتين perror(3) و strerror(3) لتحويل هذه الأسماء إلى رسائل خطأ نصية مقابلة.

على أي نظام Linux معين، يمكن الحصول على قائمة بجميع أسماء الأخطاء الرمزية وأرقام الأخطاء المقابلة باستخدام الأمر errno(1) (جزء من حزمة moreutils):


$ errno -l;
EPERM 1 العملية غير مسموح بها (Operation not permitted)
ENOENT 2 لا يوجد ملف أو دليل كهذا (No such file or directory)
ESRCH 3 لا توجد عملية كهذه (No such process)
EINTR 4 استدعاء نظام مقطوع (Interrupted system call)
EIO 5 خطأ في الإدخال/الإخراج (Input/output error)
...

يمكن أيضًا استخدام الأمر errno(1) للبحث عن أرقام وأسماء أخطاء فردية، وللبحث عن الأخطاء باستخدام سلاسل محارف من وصف الخطأ، كما في الأمثلة التالية:


$ errno 2;
ENOENT 2 لا يوجد ملف أو دليل كهذا (No such file or directory)
$ errno ESRCH;
ESRCH 3 لا توجد عملية كهذه (No such process)
$ errno -s permission;
EACCES 13 الإذن مرفوض (Permission denied)

قائمة أسماء الأخطاء

في قائمة أسماء الأخطاء الرمزية أدناه، تُوسم أسماء مختلفة كما يلي:

يُعرّف الاسم بواسطة POSIX.1-2001، ويُعرّف في إصدارات POSIX.1 اللاحقة، ما لم يُذكر خلاف ذلك.
يُعرّف الاسم في POSIX.1-2008، لكنه لم يكن موجودًا في معايير POSIX.1 السابقة.
الاسم مُعرَّف بواسطة C99.

أدناه قائمة بأسماء الأخطاء الرمزية المُعرَّفة على لينكس:

قائمة الوسائط طويلة جدًا (POSIX.1-2001).
الصلاحية مرفوضة (POSIX.1-2001).
العنوان قيد الاستخدام بالفعل (POSIX.1-2001).
العنوان غير متاح (POSIX.1-2001).
عائلة العنوان غير مدعومة (POSIX.1-2001).
المورد غير متاح مؤقتًا (قد يكون نفس قيمة EWOULDBLOCK) (POSIX.1-2001).
الاتصال قيد التقدم بالفعل (POSIX.1-2001).
تبادل غير صالح.
واصف ملف سيئ (POSIX.1-2001).
واصف الملف في حالة سيئة.
رسالة سيئة (POSIX.1-2001).
واصف طلب غير صالح.
رمز طلب غير صالح.
فتحة غير صالحة.
الجهاز أو المورد مشغول (POSIX.1-2001).
أُلغيَت العملية (POSIX.1-2001).
لا توجد عمليات فرعية (POSIX.1-2001).
رقم القناة خارج النطاق.
خطأ في الاتصال عند الإرسال.
أُجهض الاتصال (POSIX.1-2001).
رُفض الاتصال (POSIX.1-2001).
أُعيد تعيين الاتصال (POSIX.1-2001).
تجنب الجمود في الموارد (POSIX.1-2001).
في معظم البنى، مرادف لـ EDEADLK. في بعض البنى (مثل Linux MIPS، PowerPC، SPARC)، هو رمز خطأ منفصل "خطأ جمود قفل الملف".
عنوان الوجهة مطلوب (POSIX.1-2001).
وسيطة الرياضيات خارج نطاق الدالة (POSIX.1، C99).
تجاوز حصة القرص (POSIX.1-2001).
الملف موجود (POSIX.1-2001).
عنوان سيئ (POSIX.1-2001).
الملف كبير جدًا (POSIX.1-2001).
المُضيف معطَّل.
المُضيف غير قابل للوصول (POSIX.1-2001).
صفحة الذاكرة بها خطأ عتادي.
المُعرِّف أُزيل (POSIX.1-2001).
حرف متعدد البايت أو عريض غير صالح أو ناقص (POSIX.1, C99).
النص المُعروض هنا هو وصف خطأ glibc؛ في POSIX.1، يُوصف هذا الخطأ بأنه "تسلسل بايت غير قانوني".
العملية قيد التقدم (POSIX.1-2001).
استدعاء دالة مُقاطَع (POSIX.1-2001); انظر signal(7).
معامل غير صالح (POSIX.1-2001).
خطأ إدخال/إخراج (POSIX.1-2001).
المقبس موصول (POSIX.1-2001).
هو دليل (POSIX.1-2001).
هو ملف نوع مُسمى.
انتهت صلاحية المفتاح.
رُفض المفتاح من الخدمة.
سُحب المفتاح.
المستوى 2 مُوقَف.
المستوى 2 غير متزامن.
المستوى 3 متوقف.
المستوى 3 معاد تعيينه.
لا يمكن الوصول إلى مكتبة مشتركة مطلوبة.
الوصول إلى مكتبة مشتركة تالفة.
محاولة ربط عدد كبير جدًا من المكتبات المشتركة.
قسم .lib في a.out تالف
لا يمكن تنفيذ مكتبة مشتركة مباشرة.
رقم الرابط خارج النطاق.
عدد كبير جدًا من مستويات الروابط الرمزية (POSIX.1-2001).
نوع الوسيط خاطئ.
ملفات مفتوحة كثيرة جدًا (POSIX.1-2001). يحدث هذا عادةً بسبب تجاوز حد المورد RLIMIT_NOFILE الموصوف في getrlimit(2). يمكن أيضًا أن يحدث بسبب تجاوز الحد المحدد في /proc/sys/fs/nr_open.
روابط كثيرة جدًا (POSIX.1-2001).
رسالة طويلة جدًا (POSIX.1-2001).
محاولة قفزات متعددة (POSIX.1-2001).
اسم ملف طويل جدًا (POSIX.1-2001).
الشبكة معطلة (POSIX.1-2001).
اتصال أُبطل بواسطة الشبكة (POSIX.1-2001).
شبكة غير قابلة للوصول (POSIX.1-2001).
ملفات مفتوحة كثيرة جدًا في النظام (POSIX.1-2001). في لينكس، ربما يكون هذا نتيجة مواجهة حد /proc/sys/fs/file-max (انظر proc(5)).
لا يوجد مصعد.
لا توجد مساحة مخزن مؤقت متاحة (POSIX.1 (خيار XSI STREAMS)).
السمة المسماة غير موجودة، أو العملية ليس لديها وصول إلى هذه السمة؛ انظر xattr(7).
في POSIX.1-2001 (خيار XSI STREAMS)، وُصف هذا الخطأ بأنه "لا توجد رسالة متاحة في طابور قراءة رأس STREAM".
لا يوجد جهاز كهذا (POSIX.1-2001).
لا يوجد ملف أو دليل كهذا (POSIX.1-2001).
عادةً، ينتج هذا الخطأ عندما لا يوجد اسم مسار محدد، أو أحد المكونات في بادئة الدليل لاسم المسار غير موجود، أو اسم المسار المحدد هو رابط رمزي معلق.
خطأ تنسيق تنفيذ (POSIX.1-2001).
المفتاح المطلوب غير متوفر.
لا توجد أقفال متوفرة (POSIX.1-2001).
قُطعت الوصلة (POSIX.1-2001).
لم يُعثر على وسيط.
مساحة غير كافية/لا يمكن تخصيص ذاكرة (POSIX.1-2001).
لا توجد رسالة من النوع المطلوب (POSIX.1-2001).
الآلة غير موجودة على الشبكة.
الحزمة غير مُثبتة.
البروتوكول غير متوفر (POSIX.1-2001).
لا توجد مساحة متبقية على الجهاز (POSIX.1-2001).
لا توجد موارد STREAM (POSIX.1 (خيار XSI STREAMS)).
ليس STREAM (POSIX.1 (خيار XSI STREAMS)).
الدالة غير مُطبَّقة (POSIX.1-2001).
جهاز كتلي مطلوب.
المقبس غير موصول (POSIX.1-2001).
ليس دليلاً (POSIX.1-2001).
الدليل ليس فارغاً (POSIX.1-2001).
الحالة غير قابلة للاسترداد (POSIX.1-2008).
ليس مقبساً (POSIX.1-2001).
العملية غير مدعومة (POSIX.1-2001).
عملية تحكم إدخال/إخراج غير مناسبة (POSIX.1-2001).
الاسم ليس فريداً على الشبكة.
لا يوجد جهاز أو عنوان كهذا (POSIX.1-2001).
العملية غير مدعومة على المقبس (POSIX.1-2001).
(ENOTSUP و EOPNOTSUPP لهما نفس القيمة في لينكس، ولكن وفقاً لـ POSIX.1 يجب أن تكون قيم الخطأ هذه متميزة.)
القيمة كبيرة جداً لتُخزَّن في نوع البيانات (POSIX.1-2001).
المالك مات (POSIX.1-2008).
العملية غير مسموح بها (POSIX.1-2001).
عائلة البروتوكول غير مدعومة.
أنبوب مكسور (POSIX.1-2001).
خطأ في البروتوكول (POSIX.1-2001).
البروتوكول غير مدعوم (POSIX.1-2001).
نوع البروتوكول خاطئ للمقبس (POSIX.1-2001).
النتيجة كبيرة جدًا (POSIX.1, C99).
تغير العنوان البعيد.
الكائن بعيد.
خطأ إدخال/إخراج بعيد.
يجب إعادة تشغيل استدعاء النظام المتقطع.
العملية غير ممكنة بسبب قتل الترددات الراديوية.
نظام الملفات للقراءة فقط (POSIX.1-2001).
لا يمكن الإرسال بعد إغلاق نقطة نهاية النقل.
بحث غير صالح (POSIX.1-2001).
نوع المقبس غير مدعوم.
لا توجد عملية كهذه (POSIX.1-2001).
مقبض ملف قديم (POSIX.1-2001).
يمكن أن يحدث هذا الخطأ لـ NFS ولأنظمة الملفات الأخرى.
خطأ أنبوب التدفقات.
انتهى المؤقت (POSIX.1 (خيار XSI STREAMS)).
(يقول POSIX.1 "مهلة STREAM ioctl(2) ".)
انتهت مهلة الاتصال (POSIX.1-2001).
مراجع كثيرة جدًا: لا يمكن الربط.
ملف النص مشغول (POSIX.1-2001).
البنية تحتاج إلى تنظيف.
برنامج تشغيل البروتوكول غير موصول.
مستخدمون كثيرون جدًا.
العملية ستحظر (قد تكون نفس قيمة EAGAIN) (POSIX.1-2001).
رابط عبر الأجهزة غير صالح (POSIX.1-2001).
التبادل ممتلئ.

ملاحظات

خطأ شائع هو القيام بـ


if (somecall() == -1) {


    printf("somecall() failed\n");


    if (errno == ...) { ...; }
}

حيث لم يعد errno بحاجة إلى الاحتفاظ بالقيمة التي كانت عليه عند العودة من somecall() (أي، قد تم تغييرها بواسطة printf(3)). إذا كان يجب الحفاظ على قيمة errno عبر استدعاء مكتبة، فيجب حفظها:


if (somecall() == -1) {


    int errsv = errno;


    printf("somecall() failed\n");


    if (errsv == ...) { ...; }
}

لاحظ أن واجهات برمجة تطبيقات خيوط POSIX لا تضبط errno عند الخطأ. بدلاً من ذلك، عند الفشل تُرجع رقم خطأ كنتيجة للدالة. تحمل أرقام الأخطاء هذه نفس معاني أرقام الأخطاء المُرجعة في errno بواسطة واجهات برمجة تطبيقات أخرى.

على بعض الأنظمة القديمة، لم يكن <errno.h> موجوداً أو لم يُصرّح عن errno، لذا كان من الضروري التصريح عن errno يدوياً (أي extern int errno). لا تفعل هذا. لقد توقف عن كونه ضرورياً منذ زمن بعيد، وسيُسبب مشاكل مع الإصدارات الحديثة من مكتبة C.

انظر أيضًا

errno(1), err(3), error(3), perror(3), strerror(3)

ترجمة

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

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

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

8 فبراير 2026 صفحات دليل لينكس 6.18