.\" -*- coding: UTF-8 -*-
.\" Copyright 1992, Drew Eckhardt <drew@cs.colorado.edu>
.\" Copyright 1993-1994, Ian Jackson <iwj10@cus.cam.ac.uk>
.\" Copyright 2006-2014, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH mkdir 2 "11 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
mkdir, mkdirat \- إنشاء دليل
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
.\" .B #include <unistd.h>
\fB#include <sys/stat.h>\fP
.P
\fBint mkdir(const char *\fP\fIpath\fP\fB, mode_t \fP\fImode\fP\fB);\fP
.P
\fB#include <fcntl.h>           \fP/* تعريف ثوابت AT_* */
\fB#include <sys/stat.h>\fP
.P
\fBint mkdirat(int \fP\fIdirfd\fP\fB, const char *\fP\fIpath\fP\fB, mode_t \fP\fImode\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBmkdirat\fP():
.nf
    منذ glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    قبل glibc 2.10:
        _ATFILE_SOURCE
.fi
.SH الوصف
\fBmkdir\fP()  يحاول إنشاء دليل باسم \fIpath\fP.
.P
الوسيط \fImode\fP يحدد وضع الدليل الجديد (انظر \fBinode\fP(7)).  يُعدل بواسطة
\fIumask\fP للعملية بالطريقة المعتادة: في غياب ACL مبدئي، يكون وضع الدليل
المنشأ هو (\fImode\fP & \[ti]\fIumask\fP & 0777).  ما إذا كانت بتات \fImode\fP الأخرى
تُكرّم للدليل المنشأ يعتمد على نظام التشغيل.  بالنسبة للينكس، انظر الإصدارات
أدناه.
.P
الدليل المنشأ حديثًا سيكون مملوكًا لمعرف المستخدم الفعّال للعملية.  إذا كان
الدليل المحتوي على الملف يحتوي على بت set\-group\-ID مضبوطًا، أو إذا كان نظام
الملفات موصولًا بدلالات مجموعة BSD (\fImount \-o bsdgroups\fP أو، بالمرادف
\fImount \-o grpid\fP)، سيرث الدليل الجديد ملكية المجموعة من والده؛ وإلا سيكون
مملوكًا لمعرف المجموعة الفعّال للعملية.
.P
.\"
.\"
إذا كان الدليل الأب يحتوي على بت set\-group\-ID مضبوطًا، فسيكون كذلك للدليل
المنشأ حديثًا.
.SS mkdirat()
نداء النظام \fBmkdirat\fP()  يعمل بنفس الطريقة تمامًا مثل \fBmkdir\fP()، باستثناء
الاختلافات الموصوفة هنا.
.P
إذا كان \fIpath\fP نسبيًا، فسيُفسر بالنسبة إلى الدليل المشار إليه بواسطة واصف
الملف \fIdirfd\fP (بدلاً من كونه نسبيًا إلى دليل العمل الحالي للعملية
المستدعية، كما يفعل \fBmkdir\fP()  لاسم مسار نسبي).
.P
إذا كان \fIpath\fP نسبيًا وكان \fIdirfd\fP هو القيمة الخاصة \fBAT_FDCWD\fP، فسيُفسر
\fIpath\fP بالنسبة إلى دليل العمل الحالي للعملية المستدعية (مثل \fBmkdir\fP()).
.P
إذا كان المسار \fIpath\fP مطلقاً، فُيتجاهل \fIdirfd\fP.
.P
انظر \fBopenat\fP(2)  لشرح الحاجة إلى \fBmkdirat\fP().
.SH "قيمة الإرجاع"
\fBmkdir\fP()  و \fBmkdirat\fP()  يُرجعان صفرًا عند النجاح.  عند الخطأ، يُرجع \-1
ويُضبط \fIerrno\fP للإشارة إلى الخطأ.
.SH الأخطاء
.TP 
\fBEACCES\fP
الدليل الأب لا يسمح بإذن الكتابة للعملية، أو أحد الدلائل في \fIpath\fP لم يسمح
بإذن البحث.  (انظر أيضًا \fBpath_resolution\fP(7).)
.TP 
\fBEBADF\fP
(\fBmkdirat\fP())  \fIpath\fP نسبي لكن \fIdirfd\fP ليس \fBAT_FDCWD\fP ولا واصف ملف صالح.
.TP 
\fBEDQUOT\fP
استُنفدت حصة المستخدم من كتل القرص أو الفهارس (inodes) على نظام الملفات.
.TP 
\fBEEXIST\fP
\fIpath\fP موجود بالفعل (ليس بالضرورة كدليل).  يشمل هذا الحالة حيث \fIpath\fP هو
رابط رمزي، سواء كان معلقًا أم لا.
.TP 
\fBEFAULT\fP
المسار \fIpath\fP يشير إلى خارج مساحة العناوين التي يمكن الوصول إليها.
.TP 
\fBEINVAL\fP
المكون النهائي ("basename") لـ \fIpath\fP للدليل الجديد غير صالح (مثلًا، يحتوي
على أحرف غير مسموح بها بواسطة نظام الملفات الأساسي).
.TP 
\fBELOOP\fP
وُجد عدد كبير جدًا من الوصلات الرمزية أثناء تحليل \fIpath\fP.
.TP 
\fBEMLINK\fP
عدد الروابط إلى الدليل الأب سيتجاوز \fBLINK_MAX\fP.
.TP 
\fBENAMETOOLONG\fP
المسار \fIpath\fP كان طويلاً جداً.
.TP 
\fBENOENT\fP
مكون الدليل في \fIpath\fP غير موجود أو أنه وصلة رمزية معلقة.
.TP 
\fBENOMEM\fP
ذاكرة النواة المتوفرة غير كافية.
.TP 
\fBENOSPC\fP
الجهاز المحتوي على \fIpath\fP ليس لديه مساحة للدليل الجديد.
.TP 
\fBENOSPC\fP
لا يمكن إنشاء الدليل الجديد لأن حصة القرص للمستخدم قد استُنفدت.
.TP 
\fBENOTDIR\fP
المكون المستخدم كدليل في \fIpath\fP ليس دليلاً في الواقع.
.TP 
\fBENOTDIR\fP
(\fBmkdirat\fP())  \fIpath\fP نسبي و \fIdirfd\fP هو واصف ملف يشير إلى ملف غير دليل.
.TP 
\fBEPERM\fP
نظام الملفات المحتوي على \fIpath\fP لا يدعم إنشاء الدلائل.
.TP 
\fBEROFS\fP
يشير \fIpath\fP إلى ملف في نظام ملفات للقراءة فقط.
.TP 
\fBEOVERFLOW\fP
تعيينات UID أو GID (انظر \fBuser_namespaces\fP(7))  لم تُهيأ.
.SH الإصدارات
تحت لينكس، بالإضافة إلى بتات الإذن، بت \fBS_ISVTX\fP \fImode\fP يُكرّم أيضًا.
.SS "ملاحظات glibc"
على النوى القديمة حيث \fBmkdirat\fP()  غير متاح، دالة الغلاف glibc تتراجع إلى
استخدام \fBmkdir\fP().  عندما يكون \fIpath\fP نسبيًا، تبني glibc اسم مسار بناءً
على الرابط الرمزي في \fI/proc/self/fd\fP الذي يتوافق مع الوسيط \fIdirfd\fP.
.SH المعايير
POSIX.1\-2024.
.SH التاريخ
.TP 
\fBmkdir\fP()
.\" SVr4 documents additional EIO, EMULTIHOP
4.2BSD, SVr4, POSIX.1\-1988.
.TP 
\fBmkdirat\fP()
glibc 2.4, Linux 2.6.16, POSIX.1\-2008.
.SH ملاحظات
توجد العديد من العيوب في البروتوكول الأساسي لـ NFS. بعضها يؤثر على
\fBmkdir\fP().
.SH "انظر أيضًا"
\fBmkdir\fP(1), \fBchmod\fP(2), \fBchown\fP(2), \fBmknod\fP(2), \fBmount\fP(2),
\fBrmdir\fP(2), \fBstat\fP(2), \fBumask\fP(2), \fBunlink\fP(2), \fBacl\fP(5),
\fBpath_resolution\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 .