psignal(3)

الاسم
psignal, psiginfo - طباعة وصف الإشارة

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

موجز
#include <signal.h>

void psignal(int sig, const char *s);
void psiginfo(const siginfo_t *pinfo, const char *s);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

psignal():
    منذ glibc 2.19:
            _DEFAULT_SOURCE
    glibc 2.19 وما قبله:
        _BSD_SOURCE || _SVID_SOURCE

psiginfo():
    _POSIX_C_SOURCE >= 200809L

الوصف
تعرض الدالة psignal() رسالة على stderr تتكون من السلسلة s، ونقطتين رأسيتين، ومسافة، وسلسلة تصف رقم الإشارة sig، وسطر جديد في النهاية. إذا كانت السلسلة s فارغة أو NULL، فتُحذف النقطتان الرأسيتان والمسافة. إذا كانت sig غير صالحة، فتشير الرسالة المعروضة إلى إشارة غير معروفة.

الدالة psiginfo() مشابهة لـ psignal()، باستثناء أنها تعرض معلومات عن الإشارة الموصوفة بواسطة pinfo، والذي يجب أن يشير إلى بنية siginfo_t صالحة. بالإضافة إلى وصف الإشارة، تعرض psiginfo() معلومات عن أصل الإشارة، ومعلومات أخرى ذات صلة بالإشارة (مثل عنوان الذاكرة ذي الصلة للإشارات المولدة بواسطة العتاد، ومعرف العملية الفرعية لـ SIGCHLD، ومعرف المستخدم ومعرف العملية للمرسل، للإشارات المُعينة باستخدام kill(2) أو sigqueue(3)).

قيمة الإرجاع
لا تُرجع الدالتان psignal() و psiginfo() أي قيمة.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
psignal()، psiginfo() | سلامة الخيوط | المنطقة (locale) آمنة لتعدد المسالك (MT-Safe)

المعايير
POSIX.1-2008.

التاريخ
glibc 2.10. POSIX.1-2008، 4.3BSD.

العلل
حتى glibc 2.12، احتوت psiginfo() على الأخطاء التالية:

•   في بعض الظروف، لا يُطبع سطر جديد في النهاية.

•   لا تُعرض تفاصيل إضافية للإشارات في الوقت الفعلي.

انظر أيضًا
sigaction(2)، perror(3)، strsignal(3)، signal(7)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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