.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2005, Michael Kerrisk <mtk.manpages@gmail.com>
.\" 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 sigset 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
sigset, sighold, sigrelse, sigignore \- واجهة برمجة تطبيقات الإشارات للنظام V
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <signal.h>\fP
.P
\fBtypedef typeof(void (int))  *sighandler_t;\fP
.P
\fB[[deprecated]] sighandler_t sigset(int \fP\fIsig\fP\fB, sighandler_t \fP\fIdisp\fP\fB);\fP
.P
\fB[[deprecated]] int sighold(int \fP\fIsig\fP\fB);\fP
\fB[[deprecated]] int sigrelse(int \fP\fIsig\fP\fB);\fP
\fB[[deprecated]] int sigignore(int \fP\fIsig\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBsigset\fP(), \fBsighold\fP(), \fBsigrelse\fP(), \fBsigignore\fP():
.nf
.\"    || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
    _XOPEN_SOURCE >= 500
.fi
.SH الوصف
تُوفر هذه الدوال في glibc كواجهة توافق للبرامج التي تستخدم واجهة برمجة
تطبيقات الإشارات التاريخية للنظام V. هذه الواجهة قديمة: يجب على التطبيقات
الجديدة استخدام واجهة برمجة تطبيقات الإشارات POSIX (\fBsigaction\fP(2),
\fBsigprocmask\fP(2)، إلخ.)
.P
تعدل الدالة \fBsigset\fP() تصرف الإشارة \fIsig\fP. يمكن أن تكون الوسيطة \fIdisp\fP
عنوان دالة معالج إشارة، أو أحد الثوابت التالية:
.TP 
\fBSIG_DFL\fP
أعد ضبط تصرف \fIsig\fP إلى المبدئي.
.TP 
\fBSIG_IGN\fP
تجاهل \fIsig\fP.
.TP 
\fBSIG_HOLD\fP
أضف \fIsig\fP إلى قناع إشارات العملية، لكن اترك تصرف \fIsig\fP دون تغيير.
.P
إذا حددت \fIdisp\fP عنوان معالج إشارة، فإن \fIsig\fP يُضاف إلى قناع إشارات العملية
أثناء تنفيذ المعالج.
.P
إذا حُددت \fIdisp\fP بقيمة غير \fBSIG_HOLD\fP، فإن \fIsig\fP يُزال من قناع إشارات
العملية.
.P
لا يمكن تغيير الإجراءات المقررة لـ \fBSIGKILL\fP و \fBSIGSTOP\fP.
.P
تضيف الدالة \fBsighold\fP() \fIsig\fP إلى قناع إشارات العملية المستدعية.
.P
تزيل الدالة \fBsigrelse\fP() \fIsig\fP من قناع إشارات العملية المستدعية.
.P
تضبط الدالة \fBsigignore\fP() تصرف \fIsig\fP إلى \fBSIG_IGN\fP.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع \fBsigset\fP() \fBSIG_HOLD\fP إذا كانت \fIsig\fP محظورة قبل
الاستدعاء، أو التصرف السابق للإشارة إذا لم تكن محظورة قبل الاستدعاء. عند
الخطأ، تُرجع \fBsigset\fP() \-1، مع ضبط \fIerrno\fP للإشارة إلى الخطأ. (لكن انظر
الأخطاء أدناه.)
.P
تُرجع الدوال \fBsighold\fP() و \fBsigrelse\fP() و \fBsigignore\fP() 0 عند النجاح؛ عند
الخطأ، تُرجع هذه الدوال \-1 وتضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
بالنسبة لـ \fBsigset\fP()، انظر الأخطاء تحت \fBsigaction\fP(2) و
\fBsigprocmask\fP(2).
.P
بالنسبة لـ \fBsighold\fP() و \fBsigrelse\fP()، انظر الأخطاء تحت \fBsigprocmask\fP(2).
.P
بالنسبة لـ \fBsigignore\fP()، انظر الأخطاء تحت \fBsigaction\fP(2).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBsigset\fP(),
\fBsighold\fP(),
\fBsigrelse\fP(),
\fBsigignore\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008.
.TP 
\fIsighandler_t\fP
GNU.  يستخدم POSIX.1 نفس النوع لكن بدون \fItypedef\fP.
.SH التاريخ
glibc 2.1.  SVr4, POSIX.1\-2001.  يُصنف POSIX.1\-2008 هذه الدوال كمهملة،
موصياً باستخدام \fBsigaction\fP(2)، \fBsigprocmask\fP(2)، \fBpthread_sigmask\fP(3)، و
\fBsigsuspend\fP(2) بدلاً منها.
.SH ملاحظات
توفر الدالة \fBsigset\fP() دلالات موثوقة لمعالجة الإشارات (كما هو الحال عند
استدعاء \fBsigaction\fP(2) مع \fIsa_mask\fP مساوٍ لـ 0).
.P
في System V، توفر الدالة \fBsignal\fP() دلالات غير موثوقة (كما هو الحال عند
استدعاء \fBsigaction\fP(2) مع \fIsa_mask\fP مساوٍ لـ \fISA_RESETHAND | SA_NODEFER\fP).  في BSD، توفر \fBsignal\fP() دلالات موثوقة.  يترك POSIX.1\-2001
هذه الجوانب من \fBsignal\fP() غير محددة.  انظر \fBsignal\fP(2) لمزيد من التفاصيل.
.P
من أجل انتظار إشارة، وفر كل من BSD و System V دالة تسمى \fBsigpause\fP(3)، ولكن
هذه الدالة لها معطيات مختلفة في النظامين. راجع \fBsigpause\fP(3) للتفاصيل.
.SH العلل
قبل glibc 2.2، لم تقم \fBsigset\fP() بإلغاء حظر \fIsig\fP إذا تم تحديد \fIdisp\fP
بقيمة غير \fBSIG_HOLD\fP.
.P
.\" See http://sourceware.org/bugzilla/show_bug.cgi?id=1951
قبل glibc 2.5، لا تُرجع \fBsigset\fP() بشكل صحيح التصرف السابق للإشارة في
حالتين.  أولاً، إذا تم تحديد \fIdisp\fP كـ \fBSIG_HOLD\fP، فإن \fBsigset\fP() الناجحة
تُرجع دائماً \fBSIG_HOLD\fP.  بدلاً من ذلك، يجب أن تُرجع التصرف السابق للإشارة
(إلا إذا كانت الإشارة محظورة، وفي هذه الحالة يجب إرجاع \fBSIG_HOLD\fP).
ثانياً، إذا كانت الإشارة محظورة حالياً، فيجب أن تكون قيمة الإرجاع لـ
\fBsigset\fP() الناجحة هي \fBSIG_HOLD\fP.  بدلاً من ذلك، يُرجع التصرف السابق
للإشارة.  تم إصلاح هذه المشكلات منذ glibc 2.5.
.SH "انظر أيضًا"
\fBkill\fP(2)، \fBpause\fP(2)، \fBsigaction\fP(2)، \fBsignal\fP(2)، \fBsigprocmask\fP(2)،
\fBraise\fP(3)، \fBsigpause\fP(3)، \fBsigvec\fP(3)، \fBsignal\fP(7)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .