الاسم

lslocks - يسرد أقفال النظام المحلية

موجز

lslocks [خيارات]

الوصف

يسرد lslocks معلومات حول كافة أقفال الملفات المحجوزة حاليًا في نظام لينكس.

الخيارات

-b، --bytes

اطبع الأحجام بالبايت بدلاً من الصيغة السهلة القراءة للبشر.

مبدئياً، تُعرض الأحجام بوحدات هي قوى لـ 1024 بايت. الاختصارات الرسمية لهذه الوحدات (KiB، MiB، GiB، ...) تُختصر لاحقاً إلى حرفها الأول فقط: K، M، G، ....

-H، --list-columns

يسرد الأعمدة التي يمكن تحديدها بالخيار ‎--output‎. يمكن استخدامه مع ‎--json‎ أو ‎--raw‎ للحصول على القائمة بتنسيق مقروء آلياً.

-i، --noinaccessible

تجاهل ملفات القفل التي لا يمكن للمستخدم الحالي الوصول إليها.

-J، --json

استخدم تنسيق مخرجات JSON.

-n، --noheadings

عدم طباعة سطر الترويسة.

-o، --output قائمة

حدد أعمدة المخرجات المراد طباعتها. استخدم --help للحصول على قائمة بجميع الأعمدة المتاحة.

يمكن توسيع قائمة الأعمدة المبدئية إذا حُددت القائمة قائمة بتنسيق +list (مثال: lslocks -o +BLOCKER).

--output-all

أخرج كافة الأعمدة المتاحة.

-p، --pid معرّف-العملية

اعرض فقط الأقفال المحجوزة بواسطة العملية ذات المعرف معرّف-العملية هذا.

-Q، --filter تعبير

طباعة الأقفال التي تستوفي الشروط المحددة بواسطة التعبير (expr) فقط.

هذه الميزة تجريبية. انظر أيضاً scols-filter(5). على سبيل المثال، استثناء أقفال نوع POSIX، وطباعة جميع أقفال وضع READ على الملفات ذات الامتداد .qcow2:

lslocks --filter 'TYPE != "POSIX" and MODE == "READ" and PATH =~ ".*\.qcow2"'

-r، --raw

استخدام تنسيق المخرجات الخام.

-u، --notruncate

لا تقتطع النص في الأعمدة.

-h، --help

اعرض نص المساعدة ثم اخرج.

-V، --version

اعرض الإصدار واخرج.

البيئة

LIBSMARTCOLS_DEBUG=all

يُفعّل مخرجات تصحيح أخطاء libsmartcols.

LIBSMARTCOLS_DEBUG_PADDING=on

يستخدم محارف حشو مرئية.

الخرج

الأمر

اسم أمر العملية التي تحتجز القفل.

PID

معرّف العملية (PID) الخاصة بالعملية.

النوع

نوع القفل؛ يمكن أن يكون LEASE (أُنشئ بواسطة fcntl(2))، أو FLOCK (أُنشئ بواسطة flock(2))، أو POSIX (أُنشئ بواسطة fcntl(2) و lockf(3)) أو OFDLCK (أُنشئ بواسطة fcntl(2)).

الحجم

حجم الملف المقفل.

INODE

رقم الفهرس (inode).

MAJ:MIN

رقم الجهاز الرئيسي:الثانوي (major:minor).

الوضع

صلاحيات الوصول للقفل (قراءة، كتابة). إذا كانت العملية محجوزة وتنتظر القفل، فستُلحق الحالة بعلامة *.

M

ما إذا كان القفل إلزامياً؛ 0 تعني لا (بمعنى أن القفل استشاري فقط)، 1 تعني نعم. (انظر fcntl(2).)

البداية

إزاحة البايت النسبية للقفل.

النهاية

إزاحة نهاية القفل.

PATH

المسار الكامل للقفل. إذا لم يُعثر على أي منها، أو لم تكن هناك صلاحيات لقراءة المسار، فسوف يرجع إلى نقطة وصل الجهاز ويُلحق "..." بالمسار. قد يُبتر المسار؛ استخدم --notruncate للحصول على المسار الكامل.

BLOCKER

معرف العملية (PID) التي تحجز القفل.

HOLDERS

حامل (أو حاملو) القفل. تنسيق الحامل هو PID,COMMAND,FD. إذا كان القفل موجهاً لوصف ملف مفتوح، فقد يكون هناك أكثر من حامل للقفل. انظر الملاحظات أدناه.

البيئة

LSLOCKS_COLUMNS=

يحدد قائمة مفصولة بفاصلة لأعمدة المخرجات المراد طباعتها. يمكن استخدام جميع الأعمدة المدرجة بواسطة --list-columns.

ملاحظات

يُهدف من أمر lslocks استبدال أمر lslk(8)، الذي كتبه في الأصل Victor A. Abell <abe@purdue.edu> ولم يُصن منذ عام 2001.

إن مفهوم "العملية التي تحتفظ بالقفل" لعقود الإيجار، وأقفال FLOCK، وأقفال OFD هو مفهوم زائف. فهي ترتبط بوصف الملف المفتوح الذي اكتُسبت عليه. وباستخدام fork(2) و/أو cmsg(3)، يمكن لعمليات متعددة مشاركة وصف ملف مفتوح. لذا فإن العملية الحائزة على عقد إيجار (أو قفل) لا تُحدد بشكل فريد. ويُظهر lslocks إحدى العمليات الحائزة في عمودي COMMAND و PID.

المخرجات المبدئية عرضة للتغيير. لذا، كلما أمكن، يجب تجنب استخدام المخرجات المبدئية في برامجك النصية.

بالنسبة لأقفال OFD، قد يظهر عمود معرف العملية (PID) القيمة -1. لا يمكن تحديد مثل هذه الأسطر بواسطة المرشح، لأن محرك الترشيح الحالي لا يدعم الأرقام السالبة.

المؤلفين

Davidlohr Bueso <dave@gnu.org> Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

انظر أيضاً

flock(1)، fcntl(2)، lockf(3)، scols-filter(5)

التبليغ عن الأخطاء

لتقارير العِلل، استخدم مُتتبع المشكلات https://github.com/util-linux/util-linux/issues.

التوفر

الأمر lslocks جزء من حزمة util-linux التي يمكن تنزيلها من أرشيف نواة لينكس https://www.kernel.org/pub/linux/utils/util-linux/.