'\" t
.\"     Title: lsfd
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: User Commands
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "LSFD" "1" "2026-09-02" "util\-linux 2.42.3" "دستورهای کاربری"
.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)"
lsfd \- فهرست کردن توصیف‌کننده‌های فایل باز پردازه‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlsfd\fP [گزینه]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBlsfd\fP به عنوان یک جایگزین مدرن برای \fBlsof\fP(8) در سیستم‌های لینوکس در نظر گرفته شده است.
برخلاف \fBlsof\fP، \fBlsfd\fP مختص هسته لینوکس است؛ این دستور با کدی ساده‌تر از قابلیت‌های اختصاصی لینوکس مانند فضاهای نام (namespaces) پشتیبانی می‌کند. \fBlsfd\fP یک جایگزین بی‌درنگ و مستقیم (drop\-in) برای \fBlsof\fP نیست؛ آن‌ها در رابط خط فرمان و قالب‌های خروجی متفاوت هستند.
.sp
خروجی پیش‌فرض ممکن است تغییر کند. بنابراین هر زمان که ممکن است، باید از استفاده از خروجی‌های پیش‌فرض در اسکریپت‌های خود خودداری کنید. همیشه در محیط‌هایی که خروجی پایدار مورد نیاز است، با استفاده از \fB\-\-output\fP \fIcolumns\-list\fP ستون‌های مورد انتظار را به‌طور صریح مشخص کنید.
.sp
\fBlsfd\fP از Libsmartcols برای قالب‌بندی و پالایش خروجی استفاده می‌کند. برای سفارشی‌سازی قالب خروجی، توضیحات گزینه \fB\-\-output\fP و برای پالایش، گزینه \fB\-\-filter\fP را ببینید. از \fBlsfd \-\-list\-columns\fP برای دریافت فهرستی از تمام ستون‌های موجود استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-l\fP, \fB\-\-threads\fP
.RS 4
فهرست‌بندی در سطح ریسه‌ها (threads).
.RE
.sp
\fB\-J\fP, \fB\-\-json\fP
.RS 4
استفاده از قالب خروجی JSON.
.RE
.sp
\fB\-n\fP, \fB\-\-noheadings\fP
.RS 4
عدم چاپ سرآیندها (headings).
.RE
.sp
\fB\-o\fP, \fB\-\-output\fP \fIlist\fP
.RS 4
مشخص کردن این‌که کدام ستون‌های خروجی چاپ شوند. برای جزئیات ستون‌های موجود به بخش \fBستون‌های خروجی (OUTPUT COLUMNS)\fP مراجعه کنید.
.sp
فهرست پیش‌فرض ستون‌ها در صورتی که \fIlist\fP در قالب +\fIlist\fP مشخص شود، قابل گسترش است (به عنوان مثال، \fBlsfd \-o +DELETED\fP).
.RE
.sp
\fB\-r\fP, \fB\-\-raw\fP
.RS 4
استفاده از قالب خروجی خام (raw).
.RE
.sp
\fB\-\-notruncate\fP
.RS 4
عدم کوتاه کردن متن در ستون‌ها.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP \fIlist\fP
.RS 4
جمع‌آوری اطلاعات فقط برای پردازه‌های مشخص‌شده.
\fIlist\fP فهرستی از شناسه‌های پردازه (PID) جداشده با کاما است.
همچنین بخش \fBمثال‌های پالایش (FILTER EXAMPLES)\fP را ببینید.
.RE
.sp
\fB\-i\fP[\fB4\fP|\fB6\fP], \fB\-\-inet\fP[\fB=4\fP|\fB=6\fP]
.RS 4
فهرست کردن فقط سوکت‌های IPv4 و/یا سوکت‌های IPv6.
.RE
.sp
\fB\-Q\fP, \fB\-\-filter\fP \fIexpression\fP
.RS 4
چاپ فقط فایل‌هایی که با شرط ارائه‌شده توسط \fIexpression\fP مطابقت دارند.
همچنین \fBscols\-filter\fP(5) و \fBمثال‌های پالایش (FILTER EXAMPLES)\fP را ببینید.
.sp
گزینه \fB\-Q\fP همراه با یک PID (برای مثال: \fB\-Q PID==1\fP) و گزینه \fB\-p\fP (برای مثال: \fB\-p 1\fP) می‌توانند برای رسیدن به همان نتیجه استفاده شوند، اما استفاده از گزینه \fB\-p\fP بسیار کارآمدتر است زیرا در مرحله بسیار اولیه‌تری از پردازش نسبت به گزینه \fB\-Q\fP عمل می‌کند.
.RE
.sp
\fB\-C\fP, \fB\-\-counter\fP \fIlabel\fP:\fIfilter_expr\fP
.RS 4
تعریف یک شمارنده سفارشی مورد استفاده در خروجی \fB\-\-summary\fP. \fBlsfd\fP یک شمارنده به نام \fIlabel\fP ایجاد می‌کند. در طول جمع‌آوری اطلاعات، \fBlsfd\fP فایل‌های مطابق با \fIfilter_expr\fP را می‌شمارد و تعداد شمارش‌شده را در شمارنده‌ای به نام \fIlabel\fP ذخیره می‌کند. \fBlsfd\fP فیلترهای تعریف‌شده با گزینه‌های \fB\-\-filter\fP را قبل از شمارش اعمال می‌کند؛ فایل‌های حذف‌شده توسط فیلترها شمرده نمی‌شوند.
.sp
درباره \fIfilter_expr\fP به \fBscols\-filter\fP(5) مراجعه کنید.
\fIlabel\fP نباید شامل \fB{\fP یا \fB:\fP باشد. می‌توانید با مشخص کردن چندباره این گزینه، چندین شمارنده تعریف کنید.
همچنین بخش \fBمثال‌های شمارنده (COUNTER EXAMPLES)\fP را ببینید.
.RE
.sp
\fB\-\-summary\fP[\fB=\fP\fImode\fP]
.RS 4
این گزینه خروجی خطوط خلاصه را کنترل می‌کند. آرگومان اختیاری \fImode\fP می‌تواند \fBonly\fP، \fBappend\fP یا \fBnever\fP باشد. اگر آرگومان \fImode\fP حذف شود، مقدار پیش‌فرض آن \fBonly\fP است.
.sp
خلاصه، شمارنده‌ها را گزارش می‌دهد. یک شمارنده از یک برچسب و یک مقدار عددی صحیح تشکیل شده است. \fB\-\-counter\fP گزینه‌ای برای تعریف یک شمارنده است. اگر کاربر هیچ شمارنده‌ای تعریف نکند، \fBlsfd\fP از تعاریف شمارنده‌های داخلی از پیش تعریف‌شده (شمارنده‌های پیش‌فرض) برای ایجاد خروجی خلاصه استفاده می‌کند.
.sp
هشدار: استفاده هم‌زمان از \fB\-\-summary\fP و \fB\-\-json\fP ممکن است خروجی را نامعتبر کند. تنها ترکیب \fB\-\-summary\fP=\fBonly\fP و \fB\-\-json\fP معتبر است.
.RE
.sp
\fB\-\-debug\-filter\fP
.RS 4
تخلیه ساختار داده داخلی برای فیلتر و خروج. این فقط برای توسعه‌دهندگان \fBlsfd\fP مفید است.
.RE
.sp
\fB\-\-dump\-counters\fP
.RS 4
تخلیه تعریف شمارنده‌های استفاده‌شده در خروجی \fB\-\-summary\fP.
.RE
.sp
\fB\-\-hyperlink\fP[\fB=\fP\fIwhen\fP]
.RS 4
چاپ مسیرها به صورت پیوندهای درون‌ترمینالی (hyperlinks). آرگومان اختیاری \fIwhen\fP می‌تواند \fBalways\fP، \fBnever\fP یا \fBauto\fP باشد. اگر آرگومان حذف شود، مقدار پیش‌فرض آن \fBauto\fP است، به این معنی که پیوندها فقط زمانی که خروجی به ترمینال هدایت شود استفاده خواهند شد.
.RE
.sp
\fB\-H\fP, \fB\-\-list\-columns\fP
.RS 4
فهرست کردن ستون‌هایی که می‌توان با گزینه \fB\-\-output\fP مشخص کرد.
می‌تواند با \fB\-\-json\fP یا \fB\-\-raw\fP برای دریافت فهرست در قالبی خوانا برای ماشین استفاده شود.
.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
استفاده از نویسه‌های فاصله‌گذاری مرئی (visible padding).
.RE
.sp
\fBLIBSMARTCOLS_JSON\fP=compact|lines
.RS 4
قالب خروجی JSON را هنگام استفاده از \fB\-\-json\fP کنترل می‌کند. مقادیر پشتیبانی‌شده عبارتند از \fBcompact\fP برای خروجی JSON با حداقل فاصله خالی، و \fBlines\fP برای قالب JSON Lines (یک شیء JSON در هر خط). اگر مقداردهی نشده باشد یا روی هر مقدار دیگری تنظیم شده باشد، از JSON با فرمت‌بندی خوانا (pretty\-printed) استفاده می‌شود.
.RE
.SH "ستون‌های خروجی (OUTPUT COLUMNS)"
.sp
هر ستون یک نوع دارد. نوع‌ها بین < و > قرار گرفته‌اند.
.sp
هشدار: نام‌ها و نوع‌های ستون‌ها هنوز پایدار نیستند.
آن‌ها ممکن است در نسخه‌های آینده تغییر کنند.
.sp
AINODECLASS <\f(CRstring\fP>
.RS 4
کلاس گره آی‌نود بی‌نام (anonymous inode).
.RE
.sp
ASSOC <\f(CRstring\fP>
.RS 4
ارتباط و وابستگی بین فایل و پردازه.
.RE
.sp
BLKDRV <\f(CRstring\fP>
.RS 4
نام گرداننده (driver) دستگاه بلوکی که توسط \f(CR/proc/devices\fP تعیین شده است.
.RE
.sp
BPF\-MAP.ID <\f(CRnumber\fP>
.RS 4
شناسه (ID) نگاشت bpf.
.RE
.sp
BPF\-MAP.TYPE <\f(CRstring\fP>
.RS 4
نام رمزگشایی‌شده نوع نگاشت bpf.
.RE
.sp
BPF\-MAP.TYPE.RAW <\f(CRnumber\fP>
.RS 4
نوع نگاشت bpf (خام).
.RE
.sp
BPF.NAME <\f(CRstring\fP>
.RS 4
نام شیء bpf.
.RE
.sp
BPF\-PROG.ID <\f(CRnumber\fP>
.RS 4
شناسه (ID) برنامه bpf.
.RE
.sp
BPF\-PROG.TAG <\f(CRstring\fP>
.RS 4
برچسب (TAG) برنامه bpf.
.RE
.sp
BPF\-PROG.TYPE <\f(CRstring\fP>
.RS 4
نام رمزگشایی‌شده نوع برنامه bpf.
.RE
.sp
BPF\-PROG.TYPE.RAW <\f(CRnumber\fP>
.RS 4
نوع برنامه bpf (خام).
.RE
.sp
CHRDRV <\f(CRstring\fP>
.RS 4
نام گرداننده (driver) دستگاه نویسه‌ای که توسط \f(CR/proc/devices\fP تعیین شده است.
.RE
.sp
COMMAND <\f(CRstring\fP>
.RS 4
دستور پردازه‌ای که فایل را باز کرده است.
.RE
.sp
DELETED <\f(CRboolean\fP>
.RS 4
دسترس‌پذیری از سیستم فایل.
.RE
.sp
DEV <\f(CRstring\fP>
.RS 4
شناسه (ID) دستگاه حاوی فایل.
.RE
.sp
DEVTYPE <\f(CRstring\fP>
.RS 4
نوع دستگاه (\f(CRblk\fP، \f(CRchar\fP یا \f(CRnodev\fP).
.RE
.sp
ENDPOINTS <\f(CRstring\fP>
.RS 4
اطلاعات نقاط پایانی (endpoints) ارتباط بین‌فرآیندی (IPC) مبادله‌شده با این توصیف‌کننده فایل (fd).
.sp
دستور \fBlsfd\fP نقاط پایانی را در میان پردازه‌هایی که پیمایش می‌کند جمع‌آوری می‌کند؛ اگر پردازه‌ها را با گزینه \fB\-p\fP محدود کنید، \fBlsfd\fP ممکن است برخی از نقاط پایانی را نادیده بگیرد.
.sp
قالب این ستون بستگی به شیء مرتبط با توصیف‌کننده فایل (fd) دارد:
.sp
نوع FIFO، نوع mqueue، منابع ptmx و pts
.RS 4
\fIPID\fP,\fICOMMAND\fP,\fIASSOC\fP[\-r][\-w]
.sp
نویسه‌های پایانی ([\-r][\-w]) نشان‌دهنده حالت خواندن و/یا نوشتن نقطه پایانی هستند.
.RE
.sp
نوع eventfd
.RS 4
\fIPID\fP,\fICOMMAND\fP,\fIASSOC\fP
.RE
.sp
UNIX
.RS 4
مشابه \fIUNIX\-STREAM\fP.
.sp
در یک کانتینر، ممکن است \fBlsfd\fP نتواند ستون \fIENDPOINTS\fP را پر کند. \fBlsfd\fP از \fBsock_diag\fP(7) برای جمع‌آوری اطلاعات درباره نقاط پایانی UNIX استفاده می‌کند. SELinux ممکن است استفاده از \fBsock_diag\fP را در کانتینر محدود کند. می‌توانید این محدودیت را با تنظیم مقدار ۱ برای متغیر منطقی \fIvirt_sandbox_use_netlink\fP برطرف کنید. برای جزئیات بیشتر به \fBcontainer_selinux\fP(8) مراجعه کنید.
.RE
.sp
UNIX\-STREAM
.RS 4
\fIPID\fP,\fICOMMAND\fP,\fIASSOC\fP[\-r?][\-w?]
.sp
درباره نویسه‌های پایانی ([\-r?][\-w?])، به توضیحات \fISOCK.SHUTDOWN\fP مراجعه کنید.
.RE
.RE
.sp
EVENTFD.ID <\f(CRnumber\fP>
.RS 4
شناسه Eventfd.
.RE
.sp
EVENTPOLL.TFDS <\f(CRstring\fP>
.RS 4
توصیف‌کننده‌های فایل هدف قرار گرفته توسط فایل eventpoll.
.RE
.sp
FD <\f(CRnumber\fP>
.RS 4
توصیف‌کننده فایل (File descriptor) برای فایل.
.RE
.sp
FLAGS <\f(CRstring\fP>
.RS 4
پرچم‌های مشخص‌شده هنگام باز کردن فایل.
.RE
.sp
FUID <\f(CRnumber\fP>
.RS 4
شماره شناسه کاربری (UID) مالک فایل.
.RE
.sp
INET.LADDR <\f(CRstring\fP>
.RS 4
نشانی IP محلی.
.RE
.sp
INET.RADDR <\f(CRstring\fP>
.RS 4
نشانی IP دوردست (remote).
.RE
.sp
INET6.LADDR <\f(CRstring\fP>
.RS 4
نشانی IPv6 محلی.
.RE
.sp
INET6.RADDR <\f(CRstring\fP>
.RS 4
نشانی IPv6 دوردست.
.RE
.sp
INODE <\f(CRnumber\fP>
.RS 4
شماره آی‌نود (Inode).
.RE
.sp
INOTIFY.INODES <\f(CRstring\fP>
.RS 4
نسخه پردازش‌شده و خوانای INOTIFY.INODES.RAW.
قالب عنصر به صورت
\fIinode\-number\fP,\fIsource\-of\-inode\fP است.
.RE
.sp
INOTIFY.INODES.RAW <\f(CRstring\fP>
.RS 4
فهرست آی‌نودهای تحت نظارت. قالب عنصر به صورت
\fIinode\-number\fP\f(CR,\fP\fIdevice\-major\fP\f(CR:\fP\fIdevice\-minor\fP است.
.RE
.sp
KNAME <\f(CRstring\fP>
.RS 4
نام خام فایل استخراج‌شده از
\f(CR/proc/\fP\fIpid\fP\f(CR/fd/\fP\fIfd\fP یا \f(CR/proc/\fP\fIpid\fP\f(CR/map_files/\fP\fIregion\fP.
.RE
.sp
KTHREAD <\f(CRboolean\fP>
.RS 4
این‌که آیا پردازه یک ریسه هسته (kernel thread) است یا خیر.
.RE
.sp
MAJ:MIN <\f(CRstring\fP>
.RS 4
شناسه دستگاه برای فایل‌های ویژه، یا شناسه دستگاه حاوی فایل.
.RE
.sp
MAPLEN <\f(CRnumber\fP>
.RS 4
طول نگاشت فایل (بر حسب صفحه / page).
.RE
.sp
MISCDEV <\f(CRstring\fP>
.RS 4
نام متفرقه دستگاه نویسه‌ای تعیین‌شده توسط \f(CR/proc/misc\fP.
.RE
.sp
MNTID <\f(CRnumber\fP>
.RS 4
شناسه سوارکردن (Mount ID).
.RE
.sp
MODE <\f(CRstring\fP>
.RS 4
حالت دسترسی (rwx).
.RE
.sp
NAME <\f(CRstring\fP>
.RS 4
نسخه پردازش‌شده KNAME. عمدتاً همانند KNAME است.
.sp
برخی فایل‌ها قالب‌ها و منابع اطلاعاتی ویژه‌ای دارند:
.sp
AF_VSOCK
.RS 4
state=\fISOCK.STATE\fP type=\fISOCK.TYPE\fP laddr=\fIVSOCK.LADDR\fP[ raddr=\fIVSOCK.RADDR\fP]
.sp
\f(CRraddr\fP برای سوکت‌های در حال گوش دادن (listening) نمایش داده نمی‌شود.
.RE
.sp
bpf\-map
.RS 4
id=\fIBPF\-MAP.ID\fP type=\fIBPF\-MAP.TYPE\fP[ name=\fIBPF.NAME\fP]
.RE
.sp
bpf\-prog
.RS 4
id=\fIBPF\-PROG.ID\fP type=\fIBPF\-PROG.TYPE\fP tag= \fIBPF\-PROG.TAG\fP [ name=\fIBPF.NAME\fP]
.RE
.sp
eventpoll
.RS 4
tfds=\fIEVENTPOLL.TFDS\fP
.RE
.sp
eventfd
.RS 4
id=\fIEVENTFD.ID\fP
.RE
.sp
inotify
.RS 4
inodes=\fIINOTIFY.INODES\fP
.RE
.sp
misc:tun
.RS 4
iface=\fITUN.IFACE\fP[ devnetns=\fITUN.DEVNETNS\fP][ socknetns=\fISOCK.NETNS\fP]
.RE
.sp
NETLINK
.RS 4
protocol=\fINETLINK.PROTOCOL\fP[ lport=\fINETLINK.LPORT\fP[ group=\fINETLINK.GROUPS\fP]]
.RE
.sp
PACKET
.RS 4
type=\fISOCK.TYPE\fP[ protocol=\fIPACKET.PROTOCOL\fP][ iface=\fIPACKET.IFACE\fP]
.RE
.sp
pidfd
.RS 4
pid=\fITARGET\-PID\fP comm=\fITARGET\-COMMAND\fP nspid=\fITARGET\-NSPIDS\fP
.sp
\fBlsfd\fP مقادیر \fITARGET\-PID\fP و \fITARGET\-NSPIDS\fP را از
\f(CR/proc/\fP\fIpid\fP\f(CR/fdinfo/\fP\fIfd\fP استخراج می‌کند.
.RE
.sp
PING
.RS 4
state=\fISOCK.STATE\fP[ id=\fIPING.ID\fP][ laddr=\fIINET.LADDR\fP [ raddr=\fIINET.RADDR\fP]]
.RE
.sp
PINGv6
.RS 4
state=\fISOCK.STATE\fP[ id=\fIPING.ID\fP][ laddr=\fIINET6.LADDR\fP [ raddr=\fIINET6.RADDR\fP]]
.RE
.sp
ptmx
.RS 4
tty\-index=\fIPTMX.TTY\-INDEX\fP
.sp
\fBlsfd\fP مقدار \fIPTMX.TTY\-INDEX\fP را از
\f(CR/proc/\fP\fIpid\fP\f(CR/fdinfo/\fP\fIfd\fP استخراج می‌کند.
.RE
.sp
RAW
.RS 4
state=\fISOCK.STATE\fP[ protocol=\fIRAW.PROTOCOL\fP [ laddr=\fIINET.LADDR\fP [ raddr=\fIINET.RADDR\fP]]]
.RE
.sp
RAWv6
.RS 4
state=\fISOCK.STATE\fP[ protocol=\fIRAW.PROTOCOL\fP [ laddr=\fIINET6.LADDR\fP [ raddr=\fIINET6.RADDR\fP]]]
.RE
.sp
signalfd
.RS 4
mask=\fISIGNALFD.MASK\fP
.RE
.sp
TCP, TCPv6
.RS 4
state=\fISOCK.STATE\fP[ laddr=\fITCP.LADDR\fP [ raddr=\fITCP.RADDR\fP]]
.RE
.sp
timerfd
.RS 4
clockid=\fITIMERFD.CLOCKID\fP[ remaining=\fITIMERFD.REMAINING\fP [ interval=\fITIMERFD.INTERVAL\fP]]
.RE
.sp
UDP, UDPv6
.RS 4
state=\fISOCK.STATE\fP[ laddr=\fIUDP.LADDR\fP [ raddr=\fIUDP.RADDR\fP]]
.sp
اگر \fIUDP.RADDR\fP برابر با \f(CR0.0.0.0\fP و \fIUDP.RPORT\fP برابر با 0 باشد، \fBlsfd\fP مقدار \f(CRraddr=\fP را پنهان می‌کند.
.RE
.sp
UDP\-LITE, UDPLITEv6
.RS 4
state=\fISOCK.STATE\fP[ laddr=\fIUDPLITE.LADDR\fP [ raddr=\fIUDPLITE.RADDR\fP]]
.RE
.sp
UNIX\-STREAM
.RS 4
state=\fISOCK.STATE\fP[ path=\fIUNIX.PATH\fP]
.RE
.sp
UNIX
.RS 4
state=\fISOCK.STATE\fP[ path=\fIUNIX.PATH\fP] type=\fISOCK.TYPE\fP
.RE
.RE
.RS 3
.ll -.6i
.sp
توجه داشته باشید که نشانگرهای \f(CR(deleted)\fP از این ستون حذف شده‌اند.
برای آگاهی از قابلیت خواندن فایل از سیستم فایل، به \fIKNAME\fP، \fIDELETED\fP یا \fIXMODE\fP مراجعه کنید.
.br
.RE
.ll
.sp
NETLINK.GROUPS <\f(CRnumber\fP>
.RS 4
گروه‌های چندپخشی (multicast) نت‌لینک (Netlink).
.RE
.sp
NETLINK.LPORT <\f(CRnumber\fP>
.RS 4
شناسه درگاه (پورت) محلی نت‌لینک.
.RE
.sp
NETLINK.PROTOCOL <\f(CRstring\fP>
.RS 4
پروتکل نت‌لینک.
.RE
.sp
NLINK <\f(CRnumber\fP>
.RS 4
تعداد پیوندها (Link count).
.RE
.sp
NS.NAME <\f(CRstring\fP>
.RS 4
نام (\fINS.TYPE\fP:[\fIINODE\fP]) فضای نام مشخص‌شده با فایل.
.RE
.sp
NS.TYPE <\f(CRstring\fP>
.RS 4
نوع فضای نام مشخص‌شده با فایل.
نوع یکی از موارد \f(CRmnt\fP، \f(CRcgroup\fP، \f(CRuts\fP، \f(CRipc\fP، \f(CRuser\fP، \f(CRpid\fP، \f(CRnet\fP،
\f(CRtime\fP یا \f(CRunknown\fP است.
.RE
.sp
OWNER <\f(CRstring\fP>
.RS 4
مالک فایل.
.RE
.sp
PACKET.IFACE <\f(CRstring\fP>
.RS 4
نام رابط شبکه مرتبط با سوکت بسته (packet socket).
.RE
.sp
PACKET.PROTOCOL <\f(CRstring\fP>
.RS 4
نام پروتکل لایه ۲ (L2) مرتبط با سوکت بسته (رمزگشایی‌شده).
.RE
.sp
PACKET.PROTOCOL.RAW <\f(CRnumber\fP>
.RS 4
شماره پروتکل لایه ۲ (L2) مرتبط با سوکت بسته (خام).
.RE
.sp
PARTITION <\f(CRstring\fP>
.RS 4
نام دستگاه بلوکی تعیین‌شده توسط \f(CR/proc/partition\fP.
.RE
.sp
PID <\f(CRnumber\fP>
.RS 4
شناسه پردازه (PID) بازکننده فایل.
.RE
.sp
PIDFD.COMM <\f(CRstring\fP>
.RS 4
دستور پردازه هدف قرار گرفته توسط pidfd.
.RE
.sp
PIDFD.NSPID <\f(CRstring\fP>
.RS 4
مقدار فیلد NSpid در \f(CR/proc/\fP\fIpid\fP\f(CR/fdinfo/\fP\fIfd\fP مربوط به pidfd.
.sp
نقل‌قول از kernel/fork.c در درخت کد منبع لینوکس:
.RS 3
.ll -.6i
.sp
اگر فضاهای نام pid پشتیبانی شوند، این تابع همچنین pid مربوط به pidfd مشخص‌شده را برای تمام فضاهای نام pid فرزند، با شروع از فضای نام pid فعلی نمونه چاپ می‌کند؛ یعنی فیلد Pid و اولین ورودی در فیلد NSpid یکسان خواهند بود.
.sp
توجه داشته باشید که این با فیلدهای Pid و NSpid در
/proc/<pid>/status متفاوت است، جایی که Pid و NSpid همیشه نسبت به فضای نام pid نمونه procfs نمایش داده می‌شوند.
.br
.RE
.ll
.RE
.sp
PIDFD.PID <\f(CRnumber\fP>
.RS 4
شناسه پردازه (PID) پردازه هدف قرار گرفته توسط pidfd.
.RE
.sp
PING.ID <`number`>
.RS 4
شناسه درخواست اکو ICMP استفاده‌شده در سوکت PING.
.RE
.sp
POS <\f(CRnumber\fP>
.RS 4
موقعیت فایل (File position).
.RE
.sp
RAW.PROTOCOL <\f(CRstring\fP>
.RS 4
نام پروتکل سوکت خام (raw socket) (رمزگشایی‌شده).
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
نوع داده این ستون از نسخه v2.39 تا v2.41 برابر با <\f(CRnumber\fP> بود.
.sp .5v
.RE
.RE
.sp
RAW.PROTOCOL.RAW <\f(CRnumber\fP>
.RS 4
شماره پروتکل سوکت خام (خام).
.RE
.sp
RDEV <\f(CRstring\fP>
.RS 4
شناسه دستگاه (اگر فایل ویژه باشد).
.RE
.sp
SIGNALFD.MASK <\f(CRstring\fP>
.RS 4
سیگنال‌های ماسک‌شده.
.RE
.sp
SIZE <\f(CRnumber\fP>
.RS 4
اندازه فایل.
.RE
.sp
SOCK.LISTENING <\f(CRboolean\fP>
.RS 4
سوکت در حال گوش دادن (Listening socket).
.RE
.sp
SOCK.NETS <\f(CRnumber\fP>
.RS 4
آی‌نود تعیین‌کننده فضای نام شبکه که سوکت به آن تعلق دارد.
.RE
.sp
SOCK.PROTONAME <\f(CRstring\fP>
.RS 4
نام پروتکل.
.RE
.sp
SOCK.SHUTDOWN <\f(CRstring\fP>
.RS 4
وضعیت خاموشی (shutdown) سوکت.
.sp
[\-r?]
.RS 4
اگر نویسه اول \fIr\fP باشد، دریافت مجاز است.
اگر \fI\-\fP باشد، دریافت غیرمجاز است.
اگر \fI?\fP باشد، وضعیت نامشخص است.
.RE
.sp
[\-w?]
.RS 4
اگر نویسه دوم \fIw\fP باشد، ارسال مجاز است.
اگر \fI\-\fP باشد، ارسال غیرمجاز است.
اگر \fI?\fP باشد، وضعیت نامشخص است.
.RE
.RE
.sp
SOCK.STATE <\f(CRstring\fP>
.RS 4
وضعیت سوکت.
.RE
.sp
SOCK.TYPE <\f(CRstring\fP>
.RS 4
نوع سوکت. در اینجا نوع به معنای پارامتر دوم فراخوان سیستمی socket است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
stream
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
dgram
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
raw
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
rdm
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
seqpacket
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
dccp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
packet
.RE
.RE
.sp
SOURCE <\f(CRstring\fP>
.RS 4
سیستم فایل، پارتیشن یا دستگاه حاوی فایل.
برای اتصالی که مقدار ERROR برای ستون \fITYPE\fP دارد، \fBlsfd\fP این ستون را با \fIsyscall\fP:_errno_ پر می‌کند.
.RE
.sp
STTYPE <\f(CRstring\fP>
.RS 4
نوع‌های خام فایل برگشتی از \fBstat\fP(2): BLK، CHR، DIR، FIFO، LINK، REG، SOCK، یا UNKN.
.RE
.sp
TCP.LADDR <\f(CRstring\fP>
.RS 4
نشانی لایه ۳ محلی (\fIINET.LADDR\fP یا \fIINET6.LADDR\fP) و درگاه (پورت) TCP محلی.
.RE
.sp
TCP.LPORT <\f(CRnumber\fP>
.RS 4
درگاه (پورت) TCP محلی.
.RE
.sp
TCP.RADDR <\f(CRstring\fP>
.RS 4
نشانی لایه ۳ دوردست (\fIINET.RADDR\fP یا \fIINET6.RADDR\fP) و درگاه (پورت) TCP دوردست.
.RE
.sp
TCP.RPORT <\f(CRnumber\fP>
.RS 4
درگاه (پورت) TCP دوردست.
.RE
.sp
TID <\f(CRnumber\fP>
.RS 4
شناسه ریسه (Thread ID) مربوط به پردازه بازکننده فایل.
.RE
.sp
TIMERFD.CLOCKID <\f(CRstring\fP>
.RS 4
شناسه ساعت (Clockid).
.RE
.sp
TIMERFD.INTERVAL <\f(CRnumber\fP>
.RS 4
بازه زمانی (Interval).
.RE
.sp
TIMERFD.REMAINING <\f(CRnumber\fP>
.RS 4
زمان باقی‌مانده.
.RE
.sp
PTMX.TTY\-INDEX <\f(CRnumber\fP>
.RS 4
نمایه TTY طرف مقابل.
.RE
.sp
TUN.DEVNETNS <\f(CRnumber\fP>
.RS 4
آی‌نود تعیین‌کننده فضای نام شبکه که دستگاه به آن تعلق دارد.
.RE
.sp
TUN.IFACE <\f(CRstring\fP>
.RS 4
رابط شبکه در پس دستگاه tun.
.RE
.sp
TYPE <\f(CRstring\fP>
.RS 4
نسخه پردازش‌شده \fISTTYPE\fP. با استثنائاتی مشابه \fISTTYPE\fP است.
برای \fISOCK\fP، مقدار \fISOCK.PROTONAME\fP را چاپ می‌کند.
برای \fIUNKN\fP، اگر \fISOURCE\fP برابر \f(CRanon_inodefs\fP باشد، مقدار \fIAINODECLASS\fP را چاپ می‌کند.
.sp
اگر \fBlsfd\fP هنگام فراخوانی یک فراخوان سیستمی برای کسب اطلاعات درباره یک توصیف‌کننده فایل هدف دچار خطا شود، این ستون را برای آن با ERROR پر می‌کند.
.RE
.sp
UDP.LADDR <\f(CRstring\fP>
.RS 4
نشانی IP محلی و درگاه (پورت) UDP محلی.
.RE
.sp
UDP.LPORT <\f(CRnumber\fP>
.RS 4
درگاه (پورت) UDP محلی.
.RE
.sp
UDP.RADDR <\f(CRstring\fP>
.RS 4
نشانی IP دوردست و درگاه (پورت) UDP دوردست.
.RE
.sp
UDP.RPORT <\f(CRnumber\fP>
.RS 4
درگاه (پورت) UDP دوردست.
.RE
.sp
UDPLITE.LADDR <\f(CRstring\fP>
.RS 4
نشانی IP محلی و درگاه (پورت) UDPLite محلی.
.RE
.sp
UDPLITE.LPORT <\f(CRnumber\fP>
.RS 4
درگاه (پورت) UDP محلی.
.RE
.sp
UDPLITE.RADDR <\f(CRstring\fP>
.RS 4
نشانی IP دوردست و درگاه (پورت) UDPLite دوردست.
.RE
.sp
UDPLITE.RPORT <\f(CRnumber\fP>
.RS 4
درگاه (پورت) UDP دوردست.
.RE
.sp
UID <\f(CRnumber\fP>
.RS 4
شماره شناسه کاربری (UID).
.RE
.sp
UNIX.IPEER < number >
.RS 4
شماره آی‌نود برای همتای سوکت دامنه UNIX.
.sp
اگر \fBlsfd\fP در یک کانتینر اجرا شود، ممکن است ستون \fIUNIX.IPEER\fP را پر نکند.
برای جزئیات بیشتر به توضیحات \fIUNIX\fP در ستون \fIENDPOINTS\fP مراجعه کنید.
.RE
.sp
UNIX.PATH <\f(CRstring\fP>
.RS 4
نام مسیر سیستم فایل برای سوکت دامنه UNIX.
.RE
.sp
USER <\f(CRstring\fP>
.RS 4
کاربر پردازه.
.RE
.sp
VSOCK.LADDR <\f(CRstring\fP>, VSOCK.RADDR <\f(CRstring\fP>
.RS 4
نشانی VSOCK محلی. قالب عنصر به صورت
\fIVSOCK.LCID\fP\f(CR:\fP\fIVSOCK.LPORT\fP است.
.sp
شناسه‌های زمینه (CID) شناخته‌شده رمزگشایی می‌شوند: \(lq*\(rq، \(lqhypervisor\(rq، \(lqlocal\(rq یا \(lqhost\(rq.
درگاه‌های شناخته‌شده رمزگشایی می‌شوند: \(lq*\(rq.
.RE
.sp
VSOCK.LCID <\f(CRnumber\fP>, VSOCK.RCID <\f(CRnumber\fP>
.RS 4
شناسه‌های زمینه (context identifiers) محلی و دوردست VSOCK.
.RE
.sp
VSOCK.LPORT <\f(CRnumber\fP>, VSOCK.RPORT <\f(CRnumber\fP>
.RS 4
درگاه‌های محلی و دوردست VSOCK.
.RE
.sp
XMODE <\f(CRstring\fP>
.RS 4
نسخه توسعه‌یافته \fIMODE\fP. این ستون ممکن است گسترش یابد؛ وقتی \fBlsfd\fP از وضعیت جدیدی از توصیف‌کننده‌های فایل و/یا نگاشت‌های حافظه پشتیبانی کند، ممکن است حروف جدیدی به \fIXMODE\fP اضافه شوند.
.sp
[\-r]
.RS 4
بازشده یا نگاشت‌شده برای خواندن. این مورد در \fIMODE\fP نیز وجود دارد.
.RE
.sp
[\-w]
.RS 4
بازشده یا نگاشت‌شده برای نوشتن. این مورد در \fIMODE\fP نیز وجود دارد.
.RE
.sp
[\-x]
.RS 4
نگاشت‌شده برای اجرای کد. این مورد در \fIMODE\fP نیز وجود دارد.
.RE
.sp
[\-D]
.RS 4
حذف‌شده از سیستم فایل. همچنین \fIDELETED\fP را ببینید.
.RE
.sp
[\-Ll]
.RS 4
قفل‌شده یا اجاره‌شده (leased). نویسه \fIl\fP نشان‌دهنده یک قفل خواندن، قفل اشتراکی یا اجاره خواندن است.
\fIL\fP نشان‌دهنده یک قفل نوشتن، قفل انحصاری یا اجاره نوشتن است. اگر هر دو قفل یا اجاره خواندن/اشتراکی و نوشتن/انحصاری توسط یک توصیف‌کننده فایل گرفته شده باشند، \fIL\fP به عنوان پرچم استفاده می‌شود.
.RE
.sp
[\-m]
.RS 4
مالتی‌پلکس‌شده (چندگانه). اگر توصیف‌کننده فایل توسط یک فایل eventpoll یا فراخوان‌های سیستمی کلاسیک برای مالتی‌پلکسینگ (\fBselect\fP(2)، \fBpselect\fP(2)، \fBpoll\fP(2) و \fBppoll\fP(2)) هدف قرار گیرد، این پرچم بیتی تنظیم می‌شود. توجه داشته باشید که اگر فراخوانی یکی از فراخوان‌های سیستمی کلاسیک قطع شود، \fBlsfd\fP ممکن است نتواند \fIm\fP را روی توصیف‌کننده‌های فایل نظارت‌شده توسط آن فراخوانی علامت‌گذاری کند.
به \fBrestart_syscall\fP(2) مراجعه کنید.
.RE
.RE
.SH "مثال‌های پالایش (FILTER EXAMPLES)"
.sp
دستور \fBlsfd\fP گزینه‌های کمی برای پالایش دارد. در بیشتر موارد، آنچه باید بدانید گزینه \fB\-Q\fP (یا \fB\-\-filter\fP) است. در ترکیب با گزینه \fB\-o\fP (یا \fB\-\-output\fP)، می‌توانید خروجی را همان‌طور که می‌خواهید سفارشی کنید.
.sp
فهرست کردن فایل‌های مرتبط با پردازه‌های با PID 1 و PID 2:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) or (PID == 2)\*(Aq
.fam
.fi
.if n .RE
.sp
انجام همان کار به روشی جایگزین:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) || (PID == 2)\*(Aq
.fam
.fi
.if n .RE
.sp
انجام همان کار به روشی کارآمدتر:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-pid 1,2
.fam
.fi
.if n .RE
.sp
می‌توان به جای کاما از فاصله‌ها استفاده کرد:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-pid \*(Aq1 2\*(Aq
.fam
.fi
.if n .RE
.sp
استفاده از \fBpidof\fP(1) برای فهرست کردن فایل‌های مرتبط با "firefox":
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-pid "$(pidof firefox)"
.fam
.fi
.if n .RE
.sp
فهرست کردن اولین توصیف‌کننده فایل بازشده توسط پردازه با PID 1:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) and (FD == 1)\*(Aq
.fam
.fi
.if n .RE
.sp
انجام همان کار به روشی جایگزین:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(PID == 1) && (FD == 1)\*(Aq
.fam
.fi
.if n .RE
.sp
فهرست کردن تمام فایل‌های اجرایی در حال اجرا:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqASSOC == "exe"\*(Aq
.fam
.fi
.if n .RE
.sp
انجام همان کار به روشی جایگزین:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqASSOC eq "exe"\*(Aq
.fam
.fi
.if n .RE
.sp
انجام همان کار اما چاپ فقط نام‌های فایل:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-o NAME \-Q \*(AqASSOC eq "exe"\*(Aq | sort \-u
.fam
.fi
.if n .RE
.sp
فهرست کردن فایل‌های حذف‌شده مرتبط با پردازه‌ها:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqDELETED\*(Aq
.fam
.fi
.if n .RE
.sp
فهرست کردن فایل‌های غیرعادی (غیرمعمولی):
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqTYPE != "REG"\*(Aq
.fam
.fi
.if n .RE
.sp
فهرست کردن دستگاه‌های بلوکی:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqDEVTYPE == "blk"\*(Aq
.fam
.fi
.if n .RE
.sp
انجام همان کار با ستون TYPE:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqTYPE == "BLK"\*(Aq
.fam
.fi
.if n .RE
.sp
فهرست کردن فایل‌هایی که شاخه "dconf" در نام آن‌ها وجود دارد:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(AqNAME =~ ".\(rs*/dconf/.*"\*(Aq
.fam
.fi
.if n .RE
.sp
فهرست کردن فایل‌های بازشده در یک ماشین مجازی QEMU:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(COMMAND =~ ".\(rs*qemu.*") and (FD >= 0)\*(Aq
.fam
.fi
.if n .RE
.sp
فهرست کردن فایل‌های timerfd منقضی‌شده ظرف ۰٫۵ ثانیه:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-Q \*(Aq(TIMERFD.remaining < 0.5) and (TIMERFD.remaining > 0.0)\*(Aq
.fam
.fi
.if n .RE
.sp
فهرست کردن پردازه‌های در حال ارتباط از طریق سوکت‌های جریانی یونیکس:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd\&  \-Q \*(AqTYPE == "UNIX\-STREAM" && UNIX.PATH =~ ".+"\*(Aq \-oUNIX.PATH,PID,COMMAND,FD,SOCK.STATE,ENDPOINTS
.fam
.fi
.if n .RE
.sp
فهرست کردن پردازه‌های در حال ارتباط از طریق یک سوکت جریانی یونیکس مشخص:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd\&  \-Q \*(AqTYPE == "UNIX\-STREAM" && UNIX.PATH == "@/tmp/.X11\-unix/X0"\*(Aq \-oUNIX.PATH,PID,COMMAND,FD,SOCK.STATE,ENDPOINTS
.fam
.fi
.if n .RE
.SH "مثال‌های شمارنده (COUNTER EXAMPLES)"
.sp
گزارش تعداد توصیف‌کننده‌های سوکت netlink و توصیف‌کننده‌های سوکت unix:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-summary=only \(rs
        \-C \*(Aqnetlink sockets\*(Aq:\*(Aq(NAME =~ "NETLINK:.*")\*(Aq \(rs
        \-C \*(Aqunix sockets\*(Aq:\*(Aq(NAME =~ "UNIX:.*")\*(Aq
VALUE COUNTER
   57 netlink sockets
 1552 unix sockets
.fam
.fi
.if n .RE
.sp
انجام همان کار اما چاپ در قالب JSON:
.RS 4
.RE
.sp
.if n .RS 4
.nf
.fam C
# lsfd \-\-summary=only \-\-json \(rs
        \-C \*(Aqnetlink sockets\*(Aq:\*(Aq(NAME =~ "NETLINK:.*")\*(Aq \(rs
        \-C \*(Aqunix sockets\*(Aq:\*(Aq(NAME =~ "UNIX:.*")\*(Aq
{
   "lsfd\-summary": [
      {
         "value": 15,
         "counter": "netlink sockets"
      },{
         "value": 798,
         "counter": "unix sockets"
      }
   ]
}
.fam
.fi
.if n .RE
.SH "تاریخچه (HISTORY)"
.sp
دستور \fBlsfd\fP از نسخه v2.38 بخشی از بسته util\-linux است.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "yamato\(atredhat.com" "Masatake YAMATO" ","
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBbpftool\fP(8),
\fBbps\fP(8),
\fBlslocks\fP(8),
\fBlsof\fP(8),
\fBpidof\fP(1),
\fBproc\fP(5),
\fBscols\-filter\fP(5),
\fBsocket\fP(2),
\fBss\fP(8),
\fBstat\fP(2),
\fBvsock\fP(7)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBlsfd\fP بخشی از بسته util\-linux است که می‌تواند از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."
دریافت شود.