sigwait(3)

الاسم
sigwait - انتظار إشارة

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

موجز
#include <signal.h>

int sigwait(const sigset_t *restrict set, int *restrict sig);

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

sigwait():
    منذ glibc 2.26:
        _POSIX_C_SOURCE >= 199506L
    glibc 2.25 وما قبله:
        _POSIX_C_SOURCE

الوصف
تعلق الدالة sigwait() تنفيذ الخيط المستدعي حتى تصبح إحدى الإشارات المحددة في مجموعة الإشارات set معلقة. لكي تصبح الإشارة معلقة، يجب حظرها أولاً باستخدام sigprocmask(2). تقبل الدالة الإشارة (تزيلها من قائمة الإشارات المعلقة)، وتعيد رقم الإشارة في sig.

عملية sigwait() مماثلة لـ sigwaitinfo(2)، باستثناء:

•   تعيد sigwait() رقم الإشارة فقط، بدلاً من بنية siginfo_t التي تصف الإشارة.

•   قيم الإرجاع للدالتين مختلفة.

قيمة الإرجاع
عند النجاح، تعيد sigwait() 0. عند الخطأ، تعيد رقم خطأ موجب (مذكور في الأخطاء).

الأخطاء

EINVAL
    يحتوي set على رقم إشارة غير صالح.

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

الإصدارات
نُفذت sigwait() باستخدام sigtimedwait(2); راجع ملاحظاتها.

يتجاهل تنفيذ glibc لـ sigwait() بصمت محاولات انتظار إشارتي الوقت الفعلي المستخدمتين داخلياً بواسطة تنفيذ خيوط NPTL. راجع nptl(7) للتفاصيل.

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

التاريخ
POSIX.1-2001.

أمثلة
انظر pthread_sigmask(3).

انظر أيضًا
sigaction(2), signalfd(2), sigpending(2), sigsuspend(2), sigwaitinfo(2), sigsetops(3), signal(7)

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

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

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