'\" t
.\"     Title: lslocks
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: System Administration
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "LSLOCKS" "8" "2026-09-02" "util\-linux 2.42.3" "System Administration"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
lslocks \- فهرست کردن قفل‌های محلی سیستم روی فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlslocks\fP [options]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBlslocks\fP اطلاعات مربوط به تمامی قفل‌های فایلی را که در حال حاضر در یک سیستم لینوکس نگه داشته شده‌اند، فهرست می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-b\fP, \fB\-\-bytes\fP
.RS 4
چاپ اندازه‌ها بر حسب بایت به جای شکل خوانا برای انسان.
.sp
به‌طور پیش‌فرض، اندازه‌ها در واحدهایی که توان‌هایی از ۱۰۲۴ بایت هستند نشان داده می‌شوند.
کوتاه‌نوشت‌های رسمی برای این واحدها (KiB، MiB، GiB، .\|.\|.)
بیشتر خلاصه شده و تنها به حرف اول آن‌ها تبدیل می‌شوند: K، M، G، .\|.\|..
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
فهرست کردن ستون‌هایی که می‌توانند با گزینه \fB\-\-output\fP مشخص شوند.
می‌تواند با \fB\-\-json\fP یا \fB\-\-raw\fP برای دریافت فهرست در قالب ماشین‌خوان استفاده شود.
.RE
.sp
\fB\-i\fP, \fB\-\-noinaccessible\fP
.RS 4
نادیده گرفتن فایل‌های قفلی که برای کاربر فعلی غیرقابل‌دسترس هستند.
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
استفاده از قالب خروجی JSON.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
چاپ نکردن خط سرستون.
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlist\fP
.RS 4
مشخص کردن ستون‌های خروجی برای چاپ. از \fB\-\-help\fP برای دریافت فهرستی از تمامی ستون‌های پشتیبانی‌شده استفاده کنید.
.sp
در صورتی که \fIlist\fP در قالب \fI+list\fP مشخص شود (برای نمونه، \fBlslocks \-o +BLOCKER\fP)، فهرست پیش‌فرض ستون‌ها می‌تواند گسترش یابد.
.RE
.sp
\fB\-\-output\-all\fP
.RS 4
نمایش تمامی ستون‌های موجود در خروجی.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP \fIpid\fP
.RS 4
نمایش تنها قفل‌هایی که توسط فرآیندی با این \fIpid\fP نگه داشته شده‌اند.
.RE
.sp
\fB\-Q\fP, \fB\-\-filter\fP \fIexpr\fP
.RS 4
تنها چاپ کردن قفل‌هایی که شرایط مشخص‌شده توسط expr را برآورده می‌کنند.
.sp
این ویژگی آزمایشی (EXPERIMENTAL) است. همچنین \fBscols\-filter\fP(5) را ببینید. برای نمونه،
مستثنی کردن قفل‌های نوع POSIX، اما چاپ تمامی قفل‌های با حالت READ روی فایل‌هایی
با پسوند \fI.qcow2\fP:
.RE
.RS 3
.ll -.6i
.sp
.if n .RS 4
.nf
.fam C
lslocks \-\-filter \*(AqTYPE != "POSIX" and MODE == "READ" and PATH =~ ".*\(rs.qcow2"\*(Aq
.fam
.fi
.if n .RE
.br
.RE
.ll
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
استفاده از قالب خروجی خام.
.RE
.sp
\fB\-u\fP, \fB\-\-notruncate\fP
.RS 4
کوتاه نکردن متن در ستون‌ها.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
خروجی اشکال‌زدایی libsmartcols را فعال می‌کند.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
استفاده از نویسه‌های فاصله‌گذاری مرئی.
.RE
.sp
\fBLIBSMARTCOLS_JSON\fP=compact|lines
.RS 4
کنترل قالب خروجی JSON هنگام استفاده از \fB\-\-json\fP. مقادیر پشتیبانی‌شده عبارتند از
\fBcompact\fP برای خروجی JSON با کمترین فضای خالی، و \fBlines\fP برای قالب خطوط JSON
(یک شیء JSON در هر خط). اگر مقداردهی نشود یا روی هر مقدار دیگری تنظیم شود،
از JSON با قالب‌بندی زیبا (pretty\-printed) استفاده می‌شود.
.RE
.SH "خروجی (OUTPUT)"
.sp
COMMAND
.RS 4
نام دستور فرآیند نگهدارنده قفل.
.RE
.sp
PID
.RS 4
شناسه فرآیند (PID).
.RE
.sp
TYPE
.RS 4
نوع قفل؛ می‌تواند LEASE (ایجاد شده با \fBfcntl\fP(2))، FLOCK (ایجاد شده با \fBflock\fP(2))، POSIX (ایجاد شده با \fBfcntl\fP(2) و \fBlockf\fP(3)) یا OFDLCK (ایجاد شده با \fBfcntl\fP(2)) باشد.
.RE
.sp
SIZE
.RS 4
اندازه فایل قفل‌شده.
.RE
.sp
INODE
.RS 4
شماره inode.
.RE
.sp
MAJ:MIN
.RS 4
شماره دستگاه major:minor.
.RE
.sp
MODE
.RS 4
مجوزهای دسترسی قفل (خواندن، نوشتن). اگر فرآیند مسدود شده و در انتظار قفل باشد، یک \*(Aq*\*(Aq (ستاره) به انتهای حالت اضافه می‌شود.
.RE
.sp
M
.RS 4
آیا قفل اجباری است یا خیر؛ 0 یعنی خیر (به این معنی که قفل فقط مشورتی یا advisory است)، 1 یعنی بله. (\fBfcntl\fP(2) را ببینید.)
.RE
.sp
START
.RS 4
آفست بایتی نسبی قفل.
.RE
.sp
END
.RS 4
آفست پایانی قفل.
.RE
.sp
PATH
.RS 4
مسیر کامل قفل. اگر هیچ موردی یافت نشود، یا مجوزی برای خواندن مسیر وجود نداشته باشد، به نقطه اتصال (mountpoint) دستگاه بازگشت می‌کند و ".\|.\|." به مسیر پیوست می‌شود. مسیر ممکن است کوتاه شده باشد؛ از \fB\-\-notruncate\fP برای دریافت مسیر کامل استفاده کنید.
.RE
.sp
BLOCKER
.RS 4
شناسه فرآیند (PID) فرآیندی که قفل را مسدود کرده است.
.RE
.sp
HOLDERS
.RS 4
دارنده(های) قفل. قالب دارنده به صورت \fIPID\fP,\fICOMMAND\fP,\fIFD\fP است.
اگر یک قفل، قفل مبتنی بر توصیف فایل باز (open file description\-oriented) باشد، می‌تواند بیش از یک دارنده برای قفل وجود داشته باشد.
بخش «نکات» در زیر را ببینید.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
LSLOCKS_COLUMNS=
.RS 4
یک فهرست جداشده با کاما از ستون‌های خروجی جهت چاپ را مشخص می‌کند. تمام ستون‌های فهرست‌شده توسط \fB\-\-list\-columns\fP می‌توانند استفاده شوند.
.RE
.SH "نکات (NOTES)"
.sp
دستور \fBlslocks\fP برای جایگزینی دستور \fBlslk\fP(8) در نظر گرفته شده است، که در ابتدا توسط \c
.MTO "abe\(atpurdue.edu" "Victor A. Abell" ""
نوشته شده بود و از سال ۲۰۰۱ نگهداری نمی‌شود.
.sp
«فرآیند نگهدارنده قفل» برای اجاره‌ها (leases)، قفل‌های FLOCK و
قفل‌های OFD یک مفهوم ساختگی است. آن‌ها با توصیف فایل باز (open file
description) که روی آن به دست آمده‌اند مرتبط هستند. با \fBfork\fP(2) یا
\fBcmsg\fP(3)، چندین فرآیند می‌توانند یک توصیف فایل باز را به اشتراک بگذارند. بنابراین
فرآیند دارنده یک اجاره (یا یک قفل) به‌طور یکتا تعیین نمی‌شود.
دستور \fBlslocks\fP یکی از فرآیندهای دارنده را در ستون‌های COMMAND و PID نشان می‌دهد.
.sp
خروجی پیش‌فرض ممکن است تغییر کند. بنابراین تا حد امکان، باید از استفاده از خروجی پیش‌فرض در اسکریپت‌های خود خودداری کنید.
.sp
برای قفل‌های OFD، ستون PID ممکن است \-1 را نشان دهد. چنین خطوطی نمی‌توانند
توسط فیلتر انتخاب شوند، زیرا موتور فیلتر فعلی از اعداد منفی پشتیبانی نمی‌کند.
.SH "نویسندگان (AUTHORS)"
.sp
\c
.MTO "dave\(atgnu.org" "Davidlohr Bueso"
.MTO "cgoesc2\(atwgu.edu" "Christian Goeschel Ndjomouo" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBflock\fP(1),
\fBfcntl\fP(2),
\fBlockf\fP(3),
\fBscols\-filter\fP(5)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
استفاده کنید.
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBlslocks\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.