.\" -*- coding: UTF-8 -*- .\" Copyright 1992, Drew Eckhardt .\" Copyright 2006-2014, 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 symlink 2 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم symlink, symlinkat \- إنشاء اسم جديد لملف .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint symlink(const char *\fP\fItarget\fP\fB, const char *\fP\fIlinkpath\fP\fB);\fP .P \fB#include \fP/* تعريف ثوابت \fBAT_*\fP */ \fB#include \fP .P \fBint symlinkat(const char *\fP\fItarget\fP\fB, int \fP\fInewdirfd\fP\fB, const char *\fP\fIlinkpath\fP\fB);\fP .P .fi .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBsymlink\fP(): .nf .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200112L || /* glibc <= 2.19: */ _BSD_SOURCE .fi .P \fBsymlinkat\fP(): .nf منذ glibc 2.10: _POSIX_C_SOURCE >= 200809L قبل glibc 2.10: _ATFILE_SOURCE .fi .SH الوصف تنشئ \fBsymlink\fP() رابطًا رمزيًا باسم \fIlinkpath\fP يحتوي على السلسلة \fItarget\fP. .P تُفسر الروابط الرمزية وقت التشغيل كما لو أن محتويات الرابط قد استُبدلت في المسار المُتبع للعثور على ملف أو دليل. .P قد تحتوي الروابط الرمزية على مكونات مسار \fI..\fP، والتي (إذا استُخدمت في بداية الرابط) تشير إلى الدلائل الأصلية للدليل الذي يوجد فيه الرابط. .P قد يشير الرابط الرمزي (المعروف أيضًا بالرابط اللين) إلى ملف موجود أو إلى ملف غير موجود؛ الحالة الأخيرة تُعرف بالرابط المعلق. .P صلاحيات الرابط الرمزي غير ذات صلة؛ تُتجاهل الملكية عند اتباع الرابط (إلا عند تمكين ميزة \fIprotected_symlinks\fP، كما هو موضح في \fBproc\fP(5))، ولكن تُفحص عند طلب إزالة الرابط أو إعادة تسميته وكان الرابط في دليل معيّنة البتة اللاصقة (\fBS_ISVTX\fP). .P إذا كان \fIlinkpath\fP موجودًا، فلن يُستبدل. .SS symlinkat() تعمل استدعاء النظام \fBsymlinkat\fP() بنفس طريقة \fBsymlink\fP()، باستثناء الاختلافات الموصوفة هنا. .P إذا كان اسم المسار المُعطى في \fIlinkpath\fP نسبيًا، فإنه يُفسر نسبة إلى الدليل المشار إليه بواصف الملف \fInewdirfd\fP (بدلاً من نسبته إلى دليل العمل الحالي للعملية المستدعية، كما تفعل \fBsymlink\fP() لاسم مسار نسبي). .P إذا كان \fIlinkpath\fP نسبيًا و \fInewdirfd\fP هو القيمة الخاصة \fBAT_FDCWD\fP، فإن \fIlinkpath\fP يُفسر نسبة إلى دليل العمل الحالي للعملية المستدعية (مثل \fBsymlink\fP()). .P إذا كان \fIlinkpath\fP مطلقًا، فإن \fInewdirfd\fP يُتجاهل. .P انظر \fBopenat\fP(2) لشرح الحاجة إلى \fBsymlinkat\fP(). .SH "قيمة الإرجاع" عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEACCES\fP وصل الكتابة إلى الدليل المحتوي على \fIlinkpath\fP مرفوض، أو أحد الدلائل في بادئة مسار \fIlinkpath\fP لم يسمح بصلاحية البحث. (انظر أيضًا \fBpath_resolution\fP(7).) .TP \fBEBADF\fP (\fBsymlinkat\fP()) \fIlinkpath\fP نسبي ولكن \fInewdirfd\fP ليس \fBAT_FDCWD\fP ولا واصف ملف صالح. .TP \fBEDQUOT\fP حصة المستخدم من الموارد على نظام الملفات قد استُنفدت. قد تكون الموارد عقد فهرسة أو كتل قرص، اعتمادًا على تطبيق نظام الملفات. .TP \fBEEXIST\fP \fIlinkpath\fP موجود بالفعل. .TP \fBEFAULT\fP \fItarget\fP أو \fIlinkpath\fP يشير إلى خارج مساحة العنوان القابلة للوصول. .TP \fBEIO\fP حدث خطأ إدخال/إخراج. .TP \fBELOOP\fP وُجد عدد كبير جدًا من الروابط الرمزية أثناء حل \fIlinkpath\fP. .TP \fBENAMETOOLONG\fP \fItarget\fP أو \fIlinkpath\fP طويل جدًا. .TP \fBENOENT\fP مكون دليل في \fIlinkpath\fP غير موجود أو هو رابط رمزي معلق، أو \fItarget\fP أو \fIlinkpath\fP سلسلة فارغة. .TP \fBENOENT\fP (\fBsymlinkat\fP()) \fIlinkpath\fP اسم مسار نسبي و \fInewdirfd\fP يشير إلى دليل قد حُذف. .TP \fBENOMEM\fP ذاكرة النواة المتوفرة غير كافية. .TP \fBENOSPC\fP الجهاز الذي يحتوي على الملف ليس به مساحة لمدخل الدليل الجديد. .TP \fBENOTDIR\fP مكون يُستخدم كدليل في \fIlinkpath\fP ليس في الواقع دليلاً. .TP \fBENOTDIR\fP (\fBsymlinkat\fP()) \fIlinkpath\fP نسبي و \fInewdirfd\fP واصف ملف يشير إلى ملف غير دليل. .TP \fBEPERM\fP نظام الملفات المحتوي على \fIlinkpath\fP لا يدعم إنشاء الروابط الرمزية. .TP \fBEROFS\fP \fIlinkpath\fP على نظام ملفات للقراءة فقط. .SH المعايير POSIX.1\-2024. .SH التاريخ .TP \fBsymlink\fP() .\" SVr4 documents additional error codes EDQUOT and ENOSYS. .\" See .\" .BR open (2) .\" re multiple files with the same name, and NFS. SVr4، 4.3BSD، POSIX.1\-2001. .TP \fBsymlinkat\fP() POSIX.1\-2008. لينكس 2.6.16،‏ glibc 2.4. .SS "ملاحظات glibc" على النوى القديمة حيث \fBsymlinkat\fP() غير متوفرة، تلجأ دالة الغلاف glibc إلى استخدام \fBsymlink\fP(). عندما يكون \fIlinkpath\fP اسم مسار نسبي، تبني glibc اسم مسار استنادًا إلى الرابط الرمزي في \fI/proc/self/fd\fP الذي يقابل وسيطة \fInewdirfd\fP. .SH ملاحظات لا يُجرى أي فحص لـ \fItarget\fP. .P حذف الاسم المشار إليه بواسطة رابط رمزي سيحذف الملف فعليًا (ما لم يكن له روابط صلبة أخرى). إذا لم تكن هذه السلوكية مرغوبة، استخدم \fBlink\fP(2). .SH "انظر أيضًا" \fBln\fP(1), \fBnamei\fP(1), \fBlchown\fP(2), \fBlink\fP(2), \fBlstat\fP(2), \fBopen\fP(2), \fBreadlink\fP(2), \fBrename\fP(2), \fBunlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\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 .