'\" t
.\"     Title: lsfd
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: أوامر المستخدم
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "LSFD" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم"
.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 "الاسم"
lsfd \- سرد واصفات الملفات
.SH "موجز"
.sp
\fBlsfd\fP [خيار]
.SH "الوصف"
.sp
صُمم \fBlsfd\fP ليكون بديلاً حديثاً لـ \fBlsof\fP(8) على أنظمة لينكس. وبخلاف \fBlsof\fP، فإن \fBlsfd\fP متخصص في نواة لينكس؛ حيث يدعم ميزات لينكس الخاصة مثل مساحات الأسماء (namespaces) برمجية أبسط. لا يعد \fBlsfd\fP بديلاً مطابقاً لـ \fBlsof\fP؛ فهما يختلفان في واجهة سطر الأوامر وتنسيقات الخرج.
.sp
إن الخرج المبدئي عرضة للتغيير. لذا، كلما أمكن، يجب تجنب استخدام المخرجات المبدئية في نصوصك البرمجية. حدد دائماً الأعمدة المتوقعة صراحةً باستخدام \fB\-\-output\fP \fIcolumns\-list\fP في البيئات التي تتطلب خرجاً مستقراً.
.sp
يستخدم \fBlsfd\fP مكتبة Libsmartcols لتنسيق الخرج وترشيحه. راجع وصف خيار \fB\-\-output\fP لتخصيص تنسيق الخرج، وخيار \fB\-\-filter\fP للترشيح. استخدم \fBlsfd \-\-list\-columns\fP للحصول على قائمة بكافة الأعمدة المتاحة.
.SH "الخيارات"
.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
لا تطبع الترويسات.
.RE
.sp
\fB\-o\fP، \fB\-\-output\fP \fIقائمة\fP
.RS 4
حدد أعمدة المخرجات المراد طباعتها. راجع قسم \fBOUTPUT COLUMNS\fP لمعرفة تفاصيل الأعمدة المتاحة.
.sp
يمكن توسيع قائمة الأعمدة المبدئية إذا حُددت \fIقائمة\fP في التنسيق +\fIقائمة\fP (مثال: \fBlsfd \-o +DELETED\fP).
.RE
.sp
\fB\-r\fP، \fB\-\-raw\fP
.RS 4
استخدم تنسيق المخرجات الخام.
.RE
.sp
\fB\-\-notruncate\fP
.RS 4
لا تبتر النص في الأعمدة.
.RE
.sp
\fB\-p\fP, \fB\-\-pid\fP \fIlist\fP
.RS 4
يجمع المعلومات للعمليات المحددة فقط. \fIlist\fP هي قائمة بمعرفات PID مفصولة بفواصل. انظر أيضاً \fBFILTER 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)‎ و \fBFILTER 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 \fIلصيقة\fP:\fI‎تعبير_تصفية\fP
.RS 4
عرف عدادًا مخصصًا يُستخدم في مخرجات \fB\-\-summary\fP. ينشئ \fBlsfd\fP عدادًا باسم \fIلصيقة\fP. أثناء جلب المعلومات، يعد \fBlsfd\fP الملفات التي تطابق \fIتعبير_تصفية\fP، ويخزن العدد المحصى في العداد المسمى \fIلصيقة\fP. يُطبق \fBlsfd\fP المرشحات المعرفة بخيارات \fB\-\-filter\fP قبل العد؛ والملفات المستثناة بواسطة المرشحات لا تُعد.
.sp
انظر ‎\fBscols\-filter\fP(5)‎ حول \fIfilter_expr\fP. يجب ألا تتضمن اللصيقة \fIlabel\fP المحرف \fB{\fP ولا المحرف \fB:\fP . يمكنك تعريف عدادات متعددة بتحديد هذا الخيار عدة مرات. انظر أيضاً \fBCOUNTER 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\fIمتى\fP]
.RS 4
اطبع المسارات كروابط تشعبية للطرفية. يمكن أن يكون معامل \fIمتى\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 "البيئة"
.sp
\fBLIBSMARTCOLS_DEBUG\fP=all
.RS 4
يُفعّل مخرجات تصحيح أخطاء libsmartcols.
.RE
.sp
\fBLIBSMARTCOLS_DEBUG_PADDING\fP=on
.RS 4
يستخدم محارف حشو مرئية.
.RE
.SH "أعمدة المخرجات"
.sp
لكل عمود نوع. تحاط الأنواع بالعلامتين < و >.
.sp
تنبيه: أسماء الأعمدة وأنواعها ليست مستقرة بعد. قد تُغيّر في الإصدارات المستقبلية.
.sp
AINODECLASS <\f(CRسلسلة_نصية\fP>
.RS 4
فئة الـ inode المجهول.
.RE
.sp
ASSOC <\f(CRسلسلة_نصية\fP>
.RS 4
الارتباط بين الملف والعملية.
.RE
.sp
BLKDRV <\f(CRسلسلة_نصية\fP>
.RS 4
اسم تعريف الجهاز الكتلي الذي حُلل بواسطة \f(CR/proc/devices\fP.
.RE
.sp
BPF\-MAP.ID <\f(CRرقم\fP>
.RS 4
معرف خريطة Bpf.
.RE
.sp
BPF\-MAP.TYPE <\f(CRسلسلة_نصية\fP>
.RS 4
الاسم الناتج عن فك ترميز نوع خريطة bpf.
.RE
.sp
BPF\-MAP.TYPE.RAW <\f(CRرقم\fP>
.RS 4
نوع خريطة Bpf (خام).
.RE
.sp
BPF.NAME <\f(CRسلسلة_نصية\fP>
.RS 4
اسم كائن Bpf.
.RE
.sp
BPF\-PROG.ID <\f(CRرقم\fP>
.RS 4
معرف برنامج Bpf.
.RE
.sp
BPF\-PROG.TAG <\f(CRسلسلة_نصية\fP>
.RS 4
وسم برنامج Bpf.
.RE
.sp
BPF\-PROG.TYPE <\f(CRسلسلة_نصية\fP>
.RS 4
الاسم الذي فُك ترميزه لنوع برنامج bpf.
.RE
.sp
BPF\-PROG.TYPE.RAW <\f(CRرقم\fP>
.RS 4
نوع برنامج Bpf (خام).
.RE
.sp
CHRDRV <\f(CRسلسلة_نصية\fP>
.RS 4
اسم مشغل جهاز محرفي تم حله بواسطة \f(CR/proc/devices\fP.
.RE
.sp
COMMAND <\f(CRسلسلة_نصية\fP>
.RS 4
أمر العملية التي تفتح الملف.
.RE
.sp
DELETED <\f(CRمنطقي\fP>
.RS 4
إمكانية الوصول من نظام الملفات.
.RE
.sp
DEV <\f(CRسلسلة_نصية\fP>
.RS 4
معرف الجهاز الذي يحتوي على الملف.
.RE
.sp
DEVTYPE <\f(CRسلسلة_نصية\fP>
.RS 4
نوع الجهاز (\f(CRblk\fP أو \f(CRchar\fP أو \f(CRnodev\fP).
.RE
.sp
ENDPOINTS <\f(CRسلسلة_نصية\fP>
.RS 4
معلومات نقاط نهاية IPC المتصلة مع fd.
.sp
يجمع \fBlsfd\fP نقاط النهاية داخل العمليات التي يفحصها \fBlsfd\fP؛ وقد يفتقد \fBlsfd\fP بعض نقاط النهاية إذا حُصرت العمليات باستخدام الخيار \fB\-p\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 داخل الحاوية. يمكنك إزالة هذا القيد بضبط القيمة 1 للمتغير المنطقي \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(CRرقم\fP>
.RS 4
معرف Eventfd.
.RE
.sp
EVENTPOLL.TFDS <\f(CRسلسلة_نصية\fP>
.RS 4
واصفات الملفات المستهدفة بواسطة ملف eventpoll.
.RE
.sp
FD <\f(CRرقم\fP>
.RS 4
واصف ملف للملف.
.RE
.sp
FLAGS <\f(CRسلسلة_نصية\fP>
.RS 4
الأعلام المحددة عند فتح الملف.
.RE
.sp
FUID <\f(CRرقم\fP>
.RS 4
رقم معرف المستخدم لمالك الملف.
.RE
.sp
INET.LADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP المحلي.
.RE
.sp
INET.RADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP البعيد.
.RE
.sp
INET6.LADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP6 المحلي.
.RE
.sp
INET6.RADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP6 البعيد.
.RE
.sp
INODE <\f(CRرقم\fP>
.RS 4
رقم العقدة المفهرسة (Inode).
.RE
.sp
INOTIFY.INODES <\f(CRسلسلة_نصية\fP>
.RS 4
نسخة مُعقّبة من INOTIFY.INODES.RAW. تنسيق العنصر هو \fIرقم\-العقدة\-المفهرسة\fP,\fIمصدر\-العقدة\-المفهرسة\fP.
.RE
.sp
INOTIFY.INODES.RAW <\f(CRسلسلة_نصية\fP>
.RS 4
قائمة بالعقد المفهرسة المراقبة. تنسيق العنصر هو \fIرقم\-العقدة\-المفهرسة\fP\f(CR,\fP\fIرئيسي\-الجهاز\fP\f(CR:\fP\fIثانوي\-الجهاز\fP.
.RE
.sp
KNAME <\f(CRسلسلة_نصية\fP>
.RS 4
اسم الملف الخام المستخرج من \f(CR/proc/\fP\fIمعرّف\-العملية\fP\f(CR/fd/\fP\fIfd\fP أو \f(CR/proc/\fP\fIمعرّف\-العملية\fP\f(CR/map_files/\fP\fIregion\fP.
.RE
.sp
KTHREAD <\f(CRمنطقي\fP>
.RS 4
ما إذا كانت العملية خيط نواة أم لا.
.RE
.sp
MAJ:MIN <\f(CRسلسلة_نصية\fP>
.RS 4
معرف الجهاز للملفات الخاصة، أو معرف الجهاز الذي يحتوي الملف.
.RE
.sp
MAPLEN <\f(CRرقم\fP>
.RS 4
طول تخطيط الملف (بالصفحات).
.RE
.sp
MISCDEV <\f(CRسلسلة_نصية\fP>
.RS 4
اسم جهاز محرفي متنوع تم حله بواسطة \f(CR/proc/misc\fP.
.RE
.sp
MNTID <\f(CRرقم\fP>
.RS 4
معرف الوصل.
.RE
.sp
MODE <\f(CRسلسلة_نصية\fP>
.RS 4
وضع الوصول (rwx).
.RE
.sp
NAME <\f(CRسلسلة_نصية\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 لا يظهر لمقابس الاستماع.
.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\fIمعرّف\-العملية\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\fIمعرّف\-العملية\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
يخفي \fBlsfd\fP القيمة \f(CRraddr=\fP إذا كان \fIUDP.RADDR\fP هو \f(CR0.0.0.0\fP وكان \fIUDP.RPORT\fP هو 0.
.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(CRرقم\fP>
.RS 4
مجموعات بث Netlink المتعدد.
.RE
.sp
NETLINK.LPORT <\f(CRرقم\fP>
.RS 4
معرف منفذ Netlink المحلي.
.RE
.sp
NETLINK.PROTOCOL <\f(CRسلسلة_نصية\fP>
.RS 4
ميفاق Netlink.
.RE
.sp
NLINK <\f(CRرقم\fP>
.RS 4
عدد الروابط.
.RE
.sp
NS.NAME <\f(CRسلسلة_نصية\fP>
.RS 4
اسم (\fINS.TYPE\fP:[\fIINODE\fP]) مساحة الأسماء المحددة مع الملف.
.RE
.sp
NS.TYPE <\f(CRسلسلة_نصية\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(CRسلسلة_نصية\fP>
.RS 4
مالك الملف.
.RE
.sp
PACKET.IFACE <\f(CRسلسلة_نصية\fP>
.RS 4
اسم الواجهة المرتبطة بمقبس الحزمة (packet socket).
.RE
.sp
PACKET.PROTOCOL <\f(CRسلسلة_نصية\fP>
.RS 4
اسم ميفاق L2 المرتبط بمقبس الحزم (مفكوك الترميز).
.RE
.sp
PACKET.PROTOCOL.RAW <\f(CRرقم\fP>
.RS 4
رقم ميفاق L2 المرتبط بمقبس الحزم (خام).
.RE
.sp
PARTITION <\f(CRسلسلة_نصية\fP>
.RS 4
اسم جهاز كتلي حُلّ بواسطة \f(CR/proc/partition\fP.
.RE
.sp
PID <\f(CRرقم\fP>
.RS 4
معرف العملية (PID) التي تفتح الملف.
.RE
.sp
PIDFD.COMM <\f(CRسلسلة_نصية\fP>
.RS 4
أمر العملية المستهدفة بواسطة pidfd.
.RE
.sp
PIDFD.NSPID <\f(CRسلسلة_نصية\fP>
.RS 4
قيمة حقل NSpid في \f(CR/proc/\fP\fIمعرّف\-العملية\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(CRرقم\fP>
.RS 4
معرف العملية (PID) المستهدفة بواسطة pidfd.
.RE
.sp
PING.ID <`number`>
.RS 4
معرف طلب صدى ICMP المستخدم على مقبس PING.
.RE
.sp
POS <\f(CRرقم\fP>
.RS 4
موضع الملف.
.RE
.sp
RAW.PROTOCOL <\f(CRسلسلة نصية\fP>
.RS 4
اسم ميفاق المقبس الخام (مفكوك الترميز).
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B Note
.ps -1
.br
.sp
نوع بيانات هذا العمود كان <\f(CRعدد\fP> من الإصدار v2.39 إلى v2.41.
.sp .5v
.RE
.RE
.sp
RAW.PROTOCOL.RAW <\f(CRرقم\fP>
.RS 4
رقم ميفاق المقبس الخام (خام).
.RE
.sp
RDEV <\f(CRسلسلة_نصية\fP>
.RS 4
معرف الجهاز (إذا كان ملفًا خاصًا).
.RE
.sp
SIGNALFD.MASK <\f(CRسلسلة_نصية\fP>
.RS 4
الإشارات المقنعة.
.RE
.sp
SIZE <\f(CRرقم\fP>
.RS 4
حجم الملف.
.RE
.sp
SOCK.LISTENING <\f(CRمنطقي\fP>
.RS 4
مقبس استماع.
.RE
.sp
SOCK.NETS <\f(CRرقم\fP>
.RS 4
فهرس العقدة (inode) الذي يحدد نطاق تسمية الشبكة الذي ينتمي إليه المقبس.
.RE
.sp
SOCK.PROTONAME <\f(CRسلسلة_نصية\fP>
.RS 4
اسم الميفاق.
.RE
.sp
SOCK.SHUTDOWN <\f(CRسلسلة_نصية\fP>
.RS 4
حالة إغلاق المقبس.
.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(CRسلسلة_نصية\fP>
.RS 4
حالة المقبس.
.RE
.sp
SOCK.TYPE <\f(CRسلسلة_نصية\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(CRسلسلة_نصية\fP>
.RS 4
نظام الملفات، أو القسم، أو الجهاز الذي يحتوي على الملف. بالنسبة للارتباط الذي تظهر فيه القيمة ERROR في عمود \fITYPE\fP، يملأ \fBlsfd\fP هذا العمود بـ \fIsyscall\fP:_errno_.
.RE
.sp
STTYPE <\f(CRسلسلة_نصية\fP>
.RS 4
أنواع الملفات الخام التي تُرجعها دالة \fBstat\fP(2): BLK، أو CHR، أو DIR، أو FIFO، أو LINK، أو REG، أو SOCK، أو UNKN.
.RE
.sp
TCP.LADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان L3 المحلي (\fIINET.LADDR\fP أو \fIINET6.LADDR\fP) ومنفذ TCP المحلي.
.RE
.sp
TCP.LPORT <\f(CRرقم\fP>
.RS 4
منفذ TCP المحلي.
.RE
.sp
TCP.RADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان L3 البعيد (\fIINET.RADDR\fP أو \fIINET6.RADDR\fP) ومنفذ TCP البعيد.
.RE
.sp
TCP.RPORT <\f(CRرقم\fP>
.RS 4
منفذ TCP البعيد.
.RE
.sp
TID <\f(CRرقم\fP>
.RS 4
معرف الخيط (Thread ID) للعملية التي تفتح الملف.
.RE
.sp
TIMERFD.CLOCKID <\f(CRسلسلة_نصية\fP>
.RS 4
Clockid.
.RE
.sp
TIMERFD.INTERVAL <\f(CRرقم\fP>
.RS 4
الفترة.
.RE
.sp
TIMERFD.REMAINING <\f(CRرقم\fP>
.RS 4
الوقت المتبقي.
.RE
.sp
PTMX.TTY\-INDEX <\f(CRرقم\fP>
.RS 4
فهرس TTY للطرف المقابل.
.RE
.sp
TUN.DEVNETNS <\f(CRعدد\fP>
.RS 4
فهرس العقدة (inode) الذي يحدد نطاق تسمية الشبكة الذي ينتمي إليه الجهاز.
.RE
.sp
TUN.IFACE <\f(CRسلسلة_نصية\fP>
.RS 4
واجهة الشبكة الموجودة خلف جهاز tun.
.RE
.sp
TYPE <\f(CRسلسلة_نصية\fP>
.RS 4
النسخة المجهزة من \fISTTYPE\fP. وهي مطابقة لـ \fISTTYPE\fP مع استثناءات. بالنسبة لـ \fISOCK\fP، تُطبع قيمة \fISOCK.PROTONAME\fP. وبالنسبة لـ \fIUNKN\fP، تُطبع قيمة \fIAINODECLASS\fP إذا كان \fISOURCE\fP هو \f(CRanon_inodefs\fP.
.sp
إذا واجه \fBlsfd\fP خطأ عند استدعاء نظام لمعرفة معلومات عن واصف ملف مستهدف، يملأ \fBlsfd\fP هذا العمود بالقيمة ERROR.
.RE
.sp
UDP.LADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP المحلي ومنفذ UDP المحلي.
.RE
.sp
UDP.LPORT <\f(CRرقم\fP>
.RS 4
منفذ UDP المحلي.
.RE
.sp
UDP.RADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP البعيد ومنفذ UDP البعيد.
.RE
.sp
UDP.RPORT <\f(CRرقم\fP>
.RS 4
منفذ UDP البعيد.
.RE
.sp
UDPLITE.LADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP المحلي ومنفذ UDPLite المحلي.
.RE
.sp
UDPLITE.LPORT <\f(CRرقم\fP>
.RS 4
منفذ UDP المحلي.
.RE
.sp
UDPLITE.RADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان IP البعيد ومنفذ UDPLite البعيد.
.RE
.sp
UDPLITE.RPORT <\f(CRرقم\fP>
.RS 4
منفذ UDP البعيد.
.RE
.sp
UID <\f(CRرقم\fP>
.RS 4
رقم معرف المستخدم.
.RE
.sp
UNIX.IPEER < عدد >
.RS 4
رقم Inode للقرين في مقبس نطاق UNIX.
.sp
إذا كان \fBlsfd\fP يعمل داخل حاوية، فقد لا يملأ عمود \fIUNIX.IPEER\fP. انظر وصف \fIUNIX\fP في عمود \fIENDPOINTS\fP لمزيد من التفاصيل.
.RE
.sp
UNIX.PATH <\f(CRسلسلة_نصية\fP>
.RS 4
مسار نظام الملفات لمقبس نطاق UNIX.
.RE
.sp
USER <\f(CRسلسلة_نصية\fP>
.RS 4
مستخدم العملية.
.RE
.sp
VSOCK.LADDR <\f(CRسلسلة_نصية\fP>, VSOCK.RADDR <\f(CRسلسلة_نصية\fP>
.RS 4
عنوان VSOCK المحلي. تنسيق العنصر هو \fIVSOCK.LCID\fP\f(CR:\fP\fIVSOCK.LPORT\fP.
.sp
سيُجرى فك ترميز معرفات سياق (CIDs) المعروفة: \(lq*\(rq، أو \(lqhypervisor\(rq، أو \(lqlocal\(rq، أو \(lqhost\(rq. كما سيُجرى فك ترميز المنافذ المعروفة: \(lq*\(rq.
.RE
.sp
VSOCK.LCID <\f(CRرقم\fP>, VSOCK.RCID <\f(CRرقم\fP>
.RS 4
معرفات سياق VSOCK المحلية والبعيدة.
.RE
.sp
VSOCK.LPORT <\f(CRرقم\fP>, VSOCK.RPORT <\f(CRرقم\fP>
.RS 4
منافذ VSOCK المحلية والبعيدة.
.RE
.sp
XMODE <\f(CRسلسلة_نصية\fP>
.RS 4
النسخة الموسعة من \fIMODE\fP. قد يكبر هذا العمود؛ حيث يمكن إلحاق أحرف جديدة بـ \fIXMODE\fP عندما يدعم \fBlsfd\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
أُقفل أو أُجّر. يمثل \fIl\fP قراءة، أو قفلاً مشتركاً أو إيجار قراءة. ويمثل \fIL\fP كتابة أو قفلاً حصرياً أو إيجار كتابة. إذا أُخذت أقفال أو إيجارات القراءة/المشتركة والكتابة/الحصرية معاً بواسطة واصف ملف، فسيُستخدم \fIL\fP كعلامة.
.RE
.sp
[\-m]
.RS 4
متعدد الإرسال (Multiplexed). إذا كان واصف الملف مستهدفاً بواسطة ملف eventpoll أو استدعاءات النظام الكلاسيكية لتعدد الإرسال (‎\fBselect\fP(2)‎، و ‎\fBpselect\fP(2)‎، و ‎\fBpoll\fP(2)‎، و ‎\fBppoll\fP(2)‎)، تُضبط علامة البت هذه. لاحظ أنه إذا قوطع استدعاء للنظام الكلاسيكي، فقد يفشل \fBlsfd\fP في وضع علامة \fIm\fP على واصفات الملفات المراقبة بواسطة ذلك الاستدعاء. انظر ‎\fBrestart_syscall\fP(2)‎.
.RE
.RE
.SH "أمثلة المرشحات"
.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 المنتهية خلال 0.5 ثانية:
.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
اسرد العمليات التي تتواصل عبر مقابس unix stream:
.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
اسرد العمليات التي تتواصل عبر مقبس unix stream محدد:
.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 "أمثلة العدادات"
.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 "تاريخ"
.sp
الأمر \fBlsfd\fP جزء من حزمة util\-linux منذ الإصدار v2.38.
.SH "المؤلفين"
.sp
.MTO "yamato\(atredhat.com" "Masatake YAMATO" "،"
.MTO "kzak\(atredhat.com" "Karel Zak" ""
.SH "انظر أيضاً"
.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 "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBlsfd\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."