.\" -*- coding: UTF-8 -*- .\" Copyright 2006-2008, 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 umask 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم umask \- تعيين قناع إنشاء وضع الملف .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBmode_t umask(mode_t \fP\fImask\fP\fB);\fP .fi .SH الوصف تضبط \fBumask\fP() قناع إنشاء وضع الملف (umask) للعملية المستدعية إلى \fImask\fP & 0777 (أي، تُستخدم فقط بتات صلاحية الملف من \fImask\fP)، وتُعيد القيمة السابقة للقناع. .P .\" e.g., mkfifo(), creat(), mknod(), sem_open(), mq_open(), shm_open() .\" but NOT the System V IPC *get() calls تستخدم \fBopen\fP(2) و \fBmkdir\fP(2) وغيرها من استدعاءات النظام التي تنشئ ملفات الـ umask لتعديل الصلاحيات الموضوعة على الملفات أو الأدلة المنشأة حديثًا. وتحديدًا، تُعطل الصلاحيات الموجودة في umask من معطى \fImode\fP الخاص بـ \fBopen\fP(2) و \fBmkdir\fP(2). .P بدلاً من ذلك، إذا كان للدليل الأب قائمة تحكم بالوصول (ACL) مبدئية (انظر \fBacl\fP(5))، يُتجاهل umask، وتُورث قائمة التحكم بالوصول المبدئية، وتُضبط بتات الصلاحية بناءً على قائمة التحكم بالوصول الموروثة، وتُعطل بتات الصلاحية الغائبة في معطى \fImode\fP. على سبيل المثال، قائمة التحكم بالوصول المبدئية التالية تعادل umask بقيمة 022: .P .in +4n .EX u::rwx,g::r\-x,o::r\-x .EE .in .P بدمج تأثير قائمة التحكم بالوصول المبدئية هذه مع معطى \fImode\fP بقيمة 0666 (rw\-rw\-rw\-)، ستكون صلاحيات الملف الناتجة هي 0644 (rw\-r\-\-r\-\-). .P الثوابت التي ينبغي استخدامها لتحديد \fImasks\fP موصوفة في \fBinode\fP(7). .P القيمة المبدئية النموذجية لـ umask العملية هي \fBS_IWGRP\fP | \fBS_IWOTH\fP (ثماني 022). في الحالة المعتادة حيث يُحدد معطى \fImode\fP لـ \fBopen\fP(2) على النحو التالي: .P .in +4n .EX \fBS_IRUSR\fP | \fBS_IWUSR\fP | \fBS_IRGRP\fP | \fBS_IWGRP\fP | \fBS_IROTH\fP | \fBS_IWOTH\fP .EE .in .P (ثماني 0666) عند إنشاء ملف جديد، ستكون الصلاحيات على الملف الناتج هي: .P .in +4n .EX \fBS_IRUSR\fP | \fBS_IWUSR\fP | \fBS_IRGRP\fP | \fBS_IROTH\fP .EE .in .P (لأن 0666 & \[ti]022 = 0644؛ أي rw\-r\-\-r\-\-). .SH "قيمة الإرجاع" ينجح استدعاء النظام هذا دائمًا وتُعاد القيمة السابقة للقناع. .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001، SVr4، 4.3BSD. .SH ملاحظات ترث العملية الابنة المنشأة عبر \fBfork\fP(2) قناع umask الخاص بوالدها. ويظل umask دون تغيير بعد \fBexecve\fP(2). .P من المستحيل استخدام \fBumask\fP() لجلب umask لعملية ما دون تغييره في نفس الوقت. ستكون هناك حاجة لاستدعاء ثانٍ لـ \fBumask\fP() لاستعادة القناع. إن عدم ذرية هاتين الخطوتين يفتح المجال لحالات السباق (races) في البرامج متعددة الخيوط. .P منذ لينكس 4.7، يمكن عرض umask لأي عملية عبر حقل \fIUmask\fP في \fI/proc/\fPpid\fI/status\fP. يسمح فحص هذا الحقل في \fI/proc/self/status\fP للعملية باستعادة umask الخاص بها دون تغييره في نفس الوقت. .P يؤثر إعداد umask أيضًا على الصلاحيات المسندة إلى كائنات POSIX IPC‏ (\fBmq_open\fP(3)، و \fBsem_open\fP(3)، و \fBshm_open\fP(3))، والأنابيب المسمى (FIFOs) ‏(\fBmkfifo\fP(3))، ومقابس نطاق يونكس (\fBunix\fP(7)) التي تنشئها العملية. لا يؤثر umask على الصلاحيات المسندة إلى كائنات System\ V IPC التي تنشئها العملية (باستخدام \fBmsgget\fP(2)، و \fBsemget\fP(2)، و \fBshmget\fP(2)). .SH "انظر أيضًا" \fBchmod\fP(2), \fBmkdir\fP(2), \fBopen\fP(2), \fBstat\fP(2), \fBacl\fP(5) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .