حالة الخروج

في أنظمة التشغيل AmigaOS و MorphOS و AROS ، يتم تحديد أربعة مستويات:

1. موافق 0
2. تحذير ٥
3. خطأ 10
4. الفشل 20

تقوم البرامج النصية عادةً بتنفيذ الأوامر والتقاط حالات خروجها.

لأغراض الصدفة، يُعتبر الأمر ناجحًا إذا خرج بحالة خروج صفرية. أما حالة الخروج غير الصفرية فتشير إلى الفشل. يُستخدم هذا النظام الذي قد يبدو غير بديهي لتوفير طريقة واحدة محددة للإشارة إلى النجاح، وطرق متعددة للإشارة إلى حالات الفشل المختلفة. عند إنهاء أمر بإشارة قيمتها N N، تُعيّن الصدفة قيمة المتغير N $?إلى قيمة أكبر من 128. تستخدم معظم الصدفات القيمة N (128+N) ، بينما تستخدم ksh93 القيمة N (256+N) .

إذا لم يتم العثور على أمر، فيجب أن تُرجع الصدفة حالة 127. أما إذا تم العثور على أمر ولكنه غير قابل للتنفيذ، فيجب أن تكون حالة الإرجاع 126. [ ^{2 ] لاحظ} أن هذا لا ينطبق على جميع الصدفات.

إذا فشل أمر ما بسبب خطأ أثناء التوسيع أو إعادة التوجيه، فإن حالة الخروج تكون أكبر من الصفر.

تسمح لغتا البرمجة C و C++ للبرامج التي تخرج من الدالة الرئيسية أو تعود منها بالإشارة إلى نجاحها أو فشلها عن طريق إرجاع عدد صحيح، أو إرجاع وحدات الماكروEXIT_SUCCESS `exit` و `exit` EXIT_FAILURE. في أنظمة يونكس، تُساوي هذه القيم `exit` 0و `exit` 1على التوالي. ^{[ 3 ]} يمكن لبرنامج AC أيضًا استخدام exit()الدالة `exit` مع تحديد حالة العدد الصحيح أو وحدة الماكرو `exit` كمعامل أول، مما يؤدي إلى إيقاف البرنامج.

mainيتم تمرير القيمة المرجعة من إلى exitالدالة، والتي EXIT_SUCCESSقد EXIT_FAILUREتقوم بترجمتها إلى "شكل محدد للتنفيذ" للإنهاء الناجح أو الإنهاء غير الناجح .

باستثناء 0وحدات الماكرو EXIT_SUCCESSو EXIT_FAILURE، لا يُحدد معيار لغة C معنى رموز الإرجاع. وتختلف قواعد استخدام رموز الإرجاع باختلاف المنصات (انظر الأقسام الخاصة بكل منصة).

في لغة C# ، Main()لا تُرجع الدالة عادةً نوعًا (نوعها هو void، أو إذا كانت async، فهي System.Threading.Tasks.Task). ومع ذلك، Main()قد يشير إلى نوع إرجاع، من النوع int، والذي يُعاد إلى نظام التشغيل. إذا Main()تم تعريف الدالة على أنها async، فإنها تُرجع بدلاً من ذلك . ^{[ 4 ]}System.Threading.Tasks.Task<int>

في مصطلحات نظام التشغيل DOS، يُعرَّف مستوى الخطأ بأنه رمز خروج عددي صحيح يُرجعه برنامج تنفيذي أو روتين فرعي . تتراوح مستويات الخطأ عادةً من 0 إلى 255. ^{[ 5 ] [ 6 ] [ 7 ] [ 8 ]} في نظام DOS ، يتوفر 256 رمز خطأ فقط، لكن نظام DR DOS 6.0 والإصدارات الأحدث تدعم رموز خطأ 16 بت، على الأقل في ملف CONFIG.SYS . ^{[ 7 ]} مع نظامي 4DOS وDR-DOS COMMAND.COM ، يمكن ضبط رموز الخروج (في مهام الدفعات) باستخدام الأمر EXIT n ^{[ 7 ]،} و(في ملف CONFIG.SYS ) باستخدام الأمر ERROR= n . ^{[ 7 ]}

غالبًا ما تُسجَّل حالات الخروج بواسطة برامج الدفعات باستخدام أوامر IF ERRORLEVEL . ^{[ 5 ] [ 7 ]} يدعم نظام DOS متعدد المستخدمين متغير بيئة محجوزًا %ERRORLVL% يتم تحديثه تلقائيًا عند عودة التطبيقات. يدعم ملف COMMAND.COM في نظام DR-DOS 7.02 والإصدارات الأحدث متغير بيئة زائفًا مشابهًا %ERRORLVL% بالإضافة إلى %ERRORLEVEL% . في ملف CONFIG.SYS ، يدعم نظام DR- DOS 6.0 والإصدارات الأحدث الأمر ONERROR لاختبار حالة التحميل ورمز الإرجاع لبرامج تشغيل الأجهزة ورمز خروج البرامج. ^{[ 7 ]} 

في لغة جافا ، main()لا يشير `request` إلى رمز الخروج، لذا عند الحاجة، يُحدد رمز الخروج يدويًا باستخدام ` java.lang.System::exit()request`، مما يُنهي البرنامج وآلة جافا الافتراضية. يمكن لأي دالة استدعاء `request` System.exit()، ما لم يمنع مدير الأمان ذلك. يعمل الوسيط `request` كرمز حالة؛ وبحسب الاصطلاح، يشير رمز الحالة غير الصفري إلى إنهاء غير طبيعي. ^{[ 9 ]}

في نظام التشغيل OpenVMS ، يُشار إلى النجاح بقيم فردية، وإلى الفشل بقيم زوجية. القيمة عبارة عن عدد صحيح من 32 بت، يتضمن الحقول الفرعية التالية: بتات التحكم، ورقم المنشأة، ورقم الرسالة، ومستوى الخطورة. تُقسم قيم الخطورة بين النجاح (نجاح، معلوماتي) والفشل (تحذير، خطأ، كارثي). ^{[ 10 ]}

في لغة C الخاصة بـ Plan 9، يتم الإشارة إلى حالة الخروج بواسطة سلسلة نصية يتم تمريرها إلى الدالة exits() ، والدالة main() من النوع void .

في أنظمة يونكس وغيرها من الأنظمة المتوافقة مع معيار POSIX ، يمكن للعملية الرئيسية استرداد حالة خروج العملية الفرعية باستخدام wait()مجموعة استدعاءات النظام المحددة في ملف رأس POSIX<wait.h> . ^{[ 11 ]} من بين هذه الاستدعاءات، يسترد الاستدعاء waitid()^{[ 12 ]} حالة الخروج كاملة، بينما يسترد الاستدعاءان الأقدم wait()[ waitpid()^{13 ] أقل} 8 بتات أهمية من حالة الخروج فقط.

تُحدد الواجهات قيمة حالة من النوع المُعبأ كحقل بتات يحتوي على أنواع مختلفة من معلومات إنهاء العمليات الفرعية. إذا انتهت العملية الفرعية بالخروج (كما هو مُحدد بواسطة الماكرو؛ والبديل المعتاد هو أنها توقفت بسبب إشارة غير مُعالجة )، wait()فإن SUS يُحدد أنه يُمكن استرداد البتات الثمانية الأقل أهمية من حالة الخروج من قيمة الحالة باستخدام الماكرو .waitpid()intWIFEXITED()WEXITSTATUS()

في waitid()استدعاء النظام (المضاف مع SUSv1)، لم تعد حالة خروج الطفل والمعلومات الأخرى موجودة في حقل بت ولكن في بنية من النوع siginfo_t. ^{[ 14 ]}

تستخدم الأنظمة المتوافقة مع معيار POSIX عادةً اصطلاحًا يُشير إلى النجاح بالصفر، وإلى الخطأ بقيمة غير صفرية. ^{[ 15 ]} وقد وُضعت بعض الاصطلاحات لتحديد المعاني النسبية لرموز الأخطاء المختلفة؛ فعلى سبيل المثال، توصي GNU بتخصيص الرموز التي يكون فيها البت الأعلى مُفعّلاً للأخطاء الجسيمة. ^{[ 3 ]}

حددت أنظمة التشغيل المشتقة من BSD مجموعة واسعة من التفسيرات المفضلة: معاني 15 رمز حالة من 64 إلى 78 مُعرّفة في رأس POSIX <sysexits.h>. ^{[ 16 ]} تاريخيًا، استُمدت هذه الرموز من برنامج sendmail وغيره من برامج نقل الرسائل ، ولكنها استُخدمت لاحقًا في العديد من البرامج الأخرى. ^{[ 17 ]} وقد تم إيقاف استخدامها، ويُنصح بتجنبها. ^{[ 16 ]}

يحتوي دليل البرمجة النصية المتقدمة بلغة باش على بعض المعلومات حول معنى رموز حالة الخروج غير الصفرية. ^{[ 18 ]}

في لغة Rust ، main()يمكن أن تُرجع أي نوع يُنفذ السمة std::process::Termination. ^{[ 19 ]}

داخليًا في بيئة تشغيل Rust، ستعود هذه القيم libc::EXIT_SUCCESSعند التنفيذ الناجح libc::EXIT_FAILUREوعند الفشل.

في مكتبة Rust القياسية، تحتوي الأنواع التالية على تطبيقات لـ std::process::Termination:

• !( النوع الذي لا يتكرر )
• ()( نوع الوحدة )
• std::convert::Infallible
• std::process::ExitCode(مع الثوابت SUCCESSو FAIL)
• std::result::Result<T, E>

^{[ 20 ]}

يستخدم نظام التشغيل مايكروسوفت ويندوز أعدادًا صحيحة غير موقعة من 32 بت كرموز خروج، ^{[ 21 ] [ 22 ]} على الرغم من أن مترجم الأوامر يتعامل معها على أنها أعداد موقعة. ^{[ 23 ]}

تُشار إلى رموز الخروج مباشرةً، على سبيل المثال، بواسطة مُفسِّر سطر الأوامر CMD.exe بالمصطلحات errorlevelالموروثة من نظام DOS . وتشير إليها عمليات إطار عمل .NET و Windows PowerShellExitCode كخاصية للكائن Process.