.\" -*- coding: UTF-8 -*- .\" Copyright 2005, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH sigsuspend 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم sigsuspend, rt_sigsuspend \- انتظار إشارة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint sigsuspend(const sigset_t *\fP\fImask\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBsigsuspend\fP(): .nf _POSIX_C_SOURCE .fi .SH الوصف \fBsigsuspend\fP() تستبدل مؤقتًا قناع الإشارة للخيط المستدعي بالقناع المعطى بواسطة \fImask\fP ثم تعلق الخيط حتى تسليم إشارة يكون إجراءها استدعاء معالج إشارة أو إنهاء عملية. .P إذا أنهت الإشارة العملية، فإن \fBsigsuspend\fP() لا تعود. إذا تم التقاط الإشارة، فإن \fBsigsuspend\fP() تعود بعد عودة معالج الإشارة، ويتم استعادة قناع الإشارة إلى الحالة قبل استدعاء \fBsigsuspend\fP(). .P لا يمكن حظر \fBSIGKILL\fP أو \fBSIGSTOP\fP؛ تحديد هذه الإشارات في \fImask\fP ليس له تأثير على قناع إشارة الخيط. .SH "قيمة الإرجاع" \fBsigsuspend\fP() تعود دائمًا بـ \-1، مع تعيين \fIerrno\fP للإشارة إلى الخطأ (عادةً \fBEINTR\fP). .SH الأخطاء .TP \fBEFAULT\fP يشير \fImask\fP إلى ذاكرة ليست جزءًا صالحًا من مساحة عنوان العملية. .TP \fBEINTR\fP تمت مقاطعة الاستدعاء بواسطة إشارة؛ \fBsignal\fP(7). .SH المعايير POSIX.1\-2024. .SH التاريخ POSIX.1\-2001. .SS "الاختلافات بين مكتبة C والنواة" .\" كان استدعاء النظام الأصلي في لينكس يُسمى \fBsigsuspend\fP(). ومع ذلك، مع إضافة الإشارات في الوقت الحقيقي في لينكس 2.2، لم يعد النوع ذو الحجم الثابت 32 بت \fIsigset_t\fP المدعوم من قبل ذلك الاستدعاء مناسبًا للغرض. وبالتالي، تمت إضافة استدعاء نظام جديد، \fBrt_sigsuspend\fP()، لدعم نوع \fIsigset_t\fP موسع. يأخذ استدعاء النظام الجديد وسيطة ثانية، \fIsize_t sigsetsize\fP، والتي تحدد الحجم بالبايت لمجموعة الإشارات في \fImask\fP. هذه الوسيطة مطلوبة حاليًا أن تكون بقيمة \fIsizeof(sigset_t)\fP (أو ينتج الخطأ \fBEINVAL\fP). تخفي دالة الغلاف glibc \fBsigsuspend\fP() هذه التفاصيل عنا، وتستدعي بشفافية \fBrt_sigsuspend\fP() عندما يوفر النواة ذلك. .SH ملاحظات عادةً، يُستخدم \fBsigsuspend\fP() بالتزامن مع \fBsigprocmask\fP(2) لمنع تسليم إشارة أثناء تنفيذ قسم كود حرج. يقوم المستدعي أولاً بحظر الإشارات باستخدام \fBsigprocmask\fP(2). عند اكتمال الكود الحرج، ينتظر المستدعي بعد ذلك الإشارات باستدعاء \fBsigsuspend\fP() مع قناع الإشارة الذي تم إرجاعه بواسطة \fBsigprocmask\fP(2) (في وسيطة \fIoldset\fP). .P انظر \fBsigsetops\fP(3) للحصول على تفاصيل حول معالجة مجموعات الإشارات. .SH "انظر أيضًا" \fBkill\fP(2), \fBpause\fP(2), \fBsigaction\fP(2), \fBsignal\fP(2), \fBsigprocmask\fP(2), \fBsigwaitinfo\fP(2), \fBsigsetops\fP(3), \fBsigwait\fP(3), \fBsignal\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 .