dotlock(1)

الاسم
mutt_dotlock - قفل ملفات البريد المؤقتة.

موجز

mutt_dotlock [-t|-f|-u|-d] [-p] [-r عدد_المحاولات] ملف

الوصف

mutt_dotlock يطبق طريقة القفل التقليدية لملفات البريد المؤقتة: لقفل ملف، يُنشأ ملف باسم ملف.lock. يعمل البرنامج بامتيازات مجموعة البريد عند الضرورة.

الخيارات

-t  مجرد محاولة. لن يقوم mutt_dotlock بقفل ملف فعليًا، بل سيُعلم العملية المستدعية إذا كان من الممكن قفل ملف.

-f  فرض القفل. إذا احتفظت عملية أخرى بقفل على ملف لمدة أطول من حد زمني معين، سيكسر mutt_dotlock ذلك القفل بإزالة ملف القفل.

-u  إلغاء القفل. سيزيل mutt_dotlock ملف.lock.

-d  حذف. سيقفل mutt_dotlock ملف، ويزيله إذا كان طوله 0، ثم يزيل ملف.lock.

-p  استخدام الامتيازات. إذا أُعطي هذا الخيار، سيعمل mutt_dotlock بامتيازات مجموعة البريد عند إنشاء وحذف ملفات القفل.

-r عدد_المحاولات
    يخبر خيار سطر الأوامر هذا mutt_dotlock بمحاولة القفل عدد_المحاولات مرة قبل الاستسلام أو (إذا استُدعي مع خيار سطر الأوامر -f) كسر قفل. القيمة المبدئية هي 5. ينتظر mutt_dotlock ثانية واحدة بين محاولات القفل المتتالية.

الملفات

ملف.lock
    ملف القفل الذي يولده mutt_dotlock.

انظر أيضًا

fcntl(2), flock(2), lockfile(1), mutt(1)

التشخيص

يعطي mutt_dotlock جميع التشخيصات في قيم الإرجاع الخاصة به:

0 - DL_EX_OK
    نجح البرنامج.

1 - DL_EX_ERROR
    حدث خطأ غير محدد مثل معاملات سطر أوامر خاطئة، نقص في ذاكرة النظام وما شابه.

3 - DL_EX_EXIST
    يريد المستخدم قفل ملف تم قفله بالفعل بواسطة عملية أخرى. إذا استُدعي mutt_dotlock مع خيار سطر الأوامر -f، لن يولد mutt_dotlock هذا الخطأ، بل سيكسر أقفال العمليات الأخرى.

4 - DL_EX_NEED_RPIVS
    تحدث قيمة الإرجاع هذه فقط إذا استُدعي mutt_dotlock مع خيار سطر الأوامر -t. تعني أن mutt_dotlock سيضطر لاستخدام امتيازات مجموعة البريد الخاصة به لقفل ملف.

5 - DL_EX_IMPOSSIBLE
    تحدث قيمة الإرجاع هذه فقط إذا استُدعي mutt_dotlock مع خيار سطر الأوامر -t. تعني أن mutt_dotlock غير قادر على قفل ملف حتى مع امتيازات مجموعة البريد.

ملاحظات

يحاول mutt_dotlock تطبيق طريقة قفل نقطي آمنة لـ NFS تم استعارتها من lockfile (1).

إذا لم يستطع المستخدم فتح ملف للقراءة بامتيازاته العادية، سيعيد mutt_dotlock قيمة الخروج DL_EX_ERROR لتجنب هجمات معينة ضد ملفات البريد المؤقتة للمستخدمين الآخرين. يتجنب الكود بعناية حالات السباق عند التحقق من الأذونات؛ للتفاصيل حول كل هذا انظر التعليقات في dotlock.c.

التاريخ

mutt_dotlock جزء من حزمة وكيل مستخدم البريد Mutt. تم إنشاؤه لتجنب تشغيل mutt بامتيازات مجموعة البريد.

المؤلف
Thomas Roessler <roessler@does-not-exist.org>

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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