.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2006, 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 sem_init 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
sem_init \- تهيئة كمية إشارة غير مسماة
.SH المكتبة
مكتبة مسالك POSIX (\fIlibpthread\fP،\ \fI\-lpthread\fP)
.SH موجز
.nf
\fB#include <semaphore.h>\fP
.P
\fBint sem_init(sem_t *\fP\fIsem\fP\fB, int \fP\fIpshared\fP\fB, unsigned int \fP\fIvalue\fP\fB);\fP
.fi
.SH الوصف
تهيئ \fBsem_init\fP() كمية الإشارة غير المسماة في العنوان المشار إليه بواسطة
\fIsem\fP.  تحدد وسيطة \fIvalue\fP القيمة المبدئية لكمية الإشارة.
.P
تشير وسيطة \fIpshared\fP إلى ما إذا كانت كمية الإشارة هذه ستُشارك بين خيوط
عملية، أو بين عمليات.
.P
إذا كانت قيمة \fIpshared\fP هي 0، فتُشارك كمية الإشارة بين خيوط عملية، ويجب أن
تكون موجودة في عنوان ما مرئي لجميع الخيوط (مثل، متغير عام، أو متغير مُخصص
ديناميكيًا على الكومة).
.P
إذا كانت قيمة \fIpshared\fP غير صفرية، فتُشارك كمية الإشارة بين العمليات، ويجب
أن تكون موجودة في منطقة من الذاكرة المشتركة (انظر \fBshm_open\fP(3)،
\fBmmap\fP(2)، و \fBshmget\fP(2)).  (بما أن الطفل المُنشأ بواسطة \fBfork\fP(2) يرث
تعيينات الذاكرة من والده، يمكنه أيضًا الوصول إلى كمية الإشارة.)  يمكن لأي
عملية يمكنها الوصول إلى منطقة الذاكرة المشتركة أن تعمل على كمية الإشارة
باستخدام \fBsem_post\fP(3)، \fBsem_wait\fP(3)، وهكذا.
.P
تهيئة كمية إشارة سبق تهيئتها تؤدي إلى سلوك غير محدد.
.SH "قيمة الإرجاع"
تُرجع \fBsem_init\fP() 0 عند النجاح؛ عند الخطأ، يُرجع \-1، ويُضبط \fIerrno\fP
للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEINVAL\fP
تتجاوز \fIvalue\fP قيمة \fBSEM_VALUE_MAX\fP.
.TP 
\fBENOSYS\fP
قيمة \fIpshared\fP غير صفرية، لكن النظام لا يدعم كميات الإشارة المشتركة بين
العمليات (انظر \fBsem_overview\fP(7)).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBsem_init\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001.
.P
بشكل غريب، لا يحدد POSIX.1\-2001 القيمة التي يجب أن تُرجعها استدعاء ناجح لـ
\fBsem_init\fP().  يُصحح POSIX.1\-2008 هذا، محددًا إرجاع الصفر عند النجاح.
.SH أمثلة
انظر \fBshm_open\fP(3) و \fBsem_wait\fP(3).
.SH "انظر أيضًا"
\fBsem_destroy\fP(3)، \fBsem_post\fP(3)، \fBsem_wait\fP(3)، \fBsem_overview\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 .