الاسم¶

rename, renameat, renameat2 - تغيير اسم أو موقع ملف

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

موجز¶

#include <stdio.h>

int rename(const char *oldpath, const char *newpath);

#include <fcntl.h>           /* Definition of AT_* constants */
#include <stdio.h>

int renameat(int olddirfd, const char *oldpath,
             int newdirfd, const char *newpath);
int renameat2(int olddirfd, const char *oldpath,
             int newdirfd, const char *newpath, unsigned int flags);

renameat():


    Since glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    Before glibc 2.10:


        _ATFILE_SOURCE

renameat2():


    _GNU_SOURCE

الوصف¶

rename() يعيد تسمية ملف، وينقله بين الدلائل إذا لزم الأمر. أي روابط صلبة أخرى للملف (كما أُنشئت باستخدام link(2)) لا تتأثر. واصفات الملفات المفتوحة لـ oldpath لا تتأثر أيضًا.

قيود مختلفة تحدد نجاح عملية إعادة التسمية من عدمه: انظر الأخطاء أدناه.

إذا كان newpath موجودًا بالفعل، يُستبدل آليًا، بحيث لا توجد نقطة يجد فيها أي عملية أخرى تحاول الوصول إلى newpath أنه مفقود. ومع ذلك، سيكون هناك على الأرجح نافذة يشير فيها كل من oldpath و newpath إلى الملف الذي يُعاد تسميته.

إذا كان oldpath و newpath رابطين صلبيين موجودين يشيران إلى نفس الملف، فإن rename() لا يفعل شيئًا، ويعيد حالة نجاح.

إذا كان newpath موجودًا لكن العملية فشلت لسبب ما، يضمن rename() ترك نسخة من newpath في مكانها.

يمكن أن يحدد oldpath دليلًا. في هذه الحالة، يجب أن يكون newpath إما غير موجود، أو يجب أن يحدد دليلًا فارغًا.

إذا كان oldpath يشير إلى رابط رمزي، يُعاد تسمية الرابط؛ إذا كان newpath يشير إلى رابط رمزي، يُستبدل الرابط.

قيمة الإرجاع¶

عند النجاح، يُعاد الصفر. وعند حدوث خطأ، يُعاد الرقم -1، ويُضبط errno للإشارة إلى الخطأ.

الأخطاء¶

EACCES

إذن الكتابة مرفوض للدليل الذي يحتوي على oldpath أو newpath، أو إذن البحث مرفوض لأحد الدلائل في بادئة المسار لـ oldpath أو newpath، أو oldpath هو دليل ولا يسمح بإذن الكتابة (مطلوب لتحديث الإدخال ..). (انظر أيضًا path_resolution(7).)

EBUSY

إعادة التسمية تفشل لأن oldpath أو newpath هو دليل قيد الاستخدام من قبل عملية ما (ربما كدليل عمل حالي، أو كدليل جذر، أو لأنه كان مفتوحًا للقراءة) أو قيد الاستخدام من قبل النظام (على سبيل المثال كنقطة وصل)، بينما يعتبر النظام هذا خطأ. (لاحظ أنه لا يوجد شرط لإرجاع EBUSY في مثل هذه الحالات—لا يوجد خطأ في القيام بإعادة التسمية على أي حال—ولكن يُسمح بإرجاع EBUSY إذا لم يستطع النظام التعامل مع مثل هذه المواقف بطريقة أخرى.)

EDQUOT

استُنفدت حصة المستخدم من كتل القرص على نظام الملفات.

EFAULT

يشير oldpath أو newpath إلى خارج مساحة العناوين التي يمكن الوصول إليها.

EINVAL

اسم المسار الجديد احتوى على بادئة مسار للقديم، أو، بشكل عام، تمت محاولة جعل دليل دليلاً فرعيًا لنفسه.

EISDIR

newpath هو دليل موجود، لكن oldpath ليس دليلاً.

ELOOP

وُجهت روابط رمزية كثيرة جدًا عند حل oldpath أو newpath.

EMLINK

oldpath لديه بالفعل الحد الأقصى لعدد الروابط إليه، أو كان دليلاً والدليل الذي يحتوي على newpath لديه الحد الأقصى لعدد الروابط.

ENAMETOOLONG

كان oldpath أو newpath طويلًا جدًا.

ENOENT

الرابط المسمى بـ oldpath غير موجود؛ أو، مكون دليل في newpath غير موجود؛ أو، oldpath أو newpath هو سلسلة فارغة.

ENOMEM

ذاكرة النواة المتوفرة غير كافية.

ENOSPC

الجهاز الذي يحتوي على الملف ليس به مساحة لمدخل الدليل الجديد.

ENOTDIR

مكون يُستخدم كدليل في oldpath أو newpath ليس في الواقع دليلاً. أو، oldpath هو دليل، و newpath موجود لكنه ليس دليلاً.

ENOTEMPTY أو EEXIST

newpath هو دليل غير فارغ، أي يحتوي على إدخالات غير "." و "..".

EPERM أو EACCES

الدليل الذي يحتوي على oldpath لديه البت اللاصق (S_ISVTX) مضبوطًا ومعرف المستخدم الفعال للعملية ليس معرف المستخدم للملف المراد حذفه ولا معرف المستخدم للدليل الذي يحتويه، والعملية ليست مميزة (لينكس: لا تملك إمكانية CAP_FOWNER)؛ أو newpath هو ملف موجود والدليل الذي يحتويه لديه البت اللاصق مضبوطًا ومعرف المستخدم الفعال للعملية ليس معرف المستخدم للملف المراد استبداله ولا معرف المستخدم للدليل الذي يحتويه، والعملية ليست مميزة (لينكس: لا تملك إمكانية CAP_FOWNER)؛ أو نظام الملفات الذي يحتوي على oldpath لا يدعم إعادة التسمية من النوع المطلوب.

EROFS

الملف موجود في نظام ملفات للقراءة فقط.

EXDEV

oldpath و newpath ليسا على نفس نظام الملفات المُوصَل. (لينكس يسمح لنظام ملفات بأن يُوصَل في نقاط متعددة، لكن rename() لا يعمل عبر نقاط وصل مختلفة، حتى لو كان نفس نظام الملفات موصلاً على كليهما.)

الأخطاء الإضافية التالية يمكن أن تحدث لـ renameat() و renameat2():

EBADF

oldpath (newpath) نسبي لكن olddirfd (newdirfd) ليس واصف ملف صالحًا.

ENOTDIR

oldpath نسبي و olddirfd واصف ملف يشير إلى ملف غير الدليل؛ أو ما شابه ذلك لـ newpath و newdirfd

الأخطاء الإضافية التالية يمكن أن تحدث لـ renameat2():

EEXIST

flags يحتوي على RENAME_NOREPLACE و newpath موجود بالفعل.

EINVAL

عَلَم غير صالح حُدد في flags.

EINVAL

كل من RENAME_NOREPLACE و RENAME_EXCHANGE حُددا في flags.

EINVAL

كل من RENAME_WHITEOUT و RENAME_EXCHANGE حُددا في flags.

EINVAL

نظام الملفات لا يدعم أحد الأعلام في flags.

ENOENT

يحتوي flags على RENAME_EXCHANGE و newpath غير موجود.

EPERM

تم تحديد RENAME_WHITEOUT في flags، لكن المتصل لا يملك صلاحية CAP_MKNOD.

المعايير¶

rename()

C11، ‏POSIX.1-2024.

renameat()

POSIX.1-2024.

renameat2()

لينكس.

التاريخ¶

rename()

C89، POSIX.1-2001، 4.3BSD.

renameat()

POSIX.1-2008. لينكس 2.6.16،‏ glibc 2.4.

renameat2()

لينكس 3.15، glibc 2.28.

العلل¶

على أنظمة ملفات NFS، لا يمكنك افتراض أنه إذا فشلت العملية، لم يتم إعادة تسمية الملف. إذا قام الخادم بعملية إعادة التسمية ثم تعطل، فإن RPC المعاد إرساله والذي سيعالج عند عودة الخادم يسبب فشلاً. يُتوقع من التطبيق التعامل مع هذا. انظر link(2) لمشكلة مماثلة.

انظر أيضًا¶

mv(1)، rename(1)، chmod(2)، link(2)، symlink(2)، unlink(2)، path_resolution(7)، symlink(7)

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.