.\" Text automatically generated by txt2man
.TH lostfiles 1 "12 July 2026" "" ""
.SH "نام (NAME)"
lostfiles \- یافتن فایل‌های یتیمی که متعلق به هیچ بسته‌ای نیستند
.SH "نحوه استفاده (USAGE)"
lostfiles [\fB-s\fP] [\fB-z\fP] [\fB-h\fP]
.SH "توضیحات (DESCRIPTION)"
دستور lostfiles پایگاه دادهٔ فایل‌های متعلق به بسته‌ها در pacman را با محتویات واقعی سیستم‌فایل مقایسه کرده و فایل‌هایی را که متعلق به هیچ بسته‌ای نیستند گزارش می‌دهد. برای شناسایی فایل‌های غیربومی کاربرد دارد. باید به عنوان ریشه (root) اجرا شود.
.SH "گزینه‌ها (OPTIONS)"

\fB-s\fP
.PP
.nf
.fam C
  اجرا در حالت سخت‌گیرانه (strict) با هدف نمایش جزئیات بیشتر و نادیده‌گیری کمتر.

.fam T
.fi
\fB-z\fP
.PP
.nf
.fam C
  چاپ و مرتب‌سازی بر اساس اندازه موارد منطبق.

.fam T
.fi
\fB-h\fP
.PP
.nf
.fam C
  نمایش اطلاعات نحوه استفاده و خروج.

.fam T
.fi
.SH "استثناهای تعریف‌شده توسط کاربر (USER-DEFINED EXCLUDES)"
فایل lostfiles.conf می‌تواند هنگام اجرا در حالت آسان‌گیر (relaxed) با فهرستی از مسیرها برای گنجاندن یا مستثنی‌کردن سفارشی‌سازی شود. هر خط که با یک علامت بعلاوه (+) یا منها (\-) آغاز شود و به دنبال آن یک مسیر مطلق بیاید، به ترتیب آن مسیر را در نتایج می‌گنجاند یا از آن مستثنی می‌کند. مسیرهای استثنا به صورت الگوهای عام شل (shell-style globs) تطبیق داده می‌شوند: یک ستاره (*) با هر رشته‌ای در یک مؤلفهٔ مسیر مطابقت دارد، و دو ستاره (**) در میان جداکننده‌های دایرکتوری مطابقت می‌یابد. مستثنی کردن یک دایرکتوری، تمام زیردرخت آن را هرس می‌کند. خطوطی که با علامت هش (#) شروع شوند به عنوان توضیح در نظر گرفته می‌شوند. هر خط دیگری باعث می‌شود lostfiles با خطا متوقف شود، تا از نادیده گرفته شدن خاموش یک قاعدهٔ معیوب جلوگیری گردد.
.PP
دستور lostfiles ابتدا در کنار خود اسکریپت به دنبال lostfiles.conf می‌گردد؛ اگر این فایل مفقود باشد، یا اگر خودش (یا دایرکتوری دربرگیرندهٔ آن) متعلق به root یا کاربر فراخوانندهٔ sudo نباشد، یا توسط گروه یا دیگران قابل نوشتن باشد، همراه با یک هشدار نادیده گرفته می‌شود و lostfiles در عوض به /etc/lostfiles.conf رجوع می‌کند. این امر مانع از آن می‌شود که یک فایل پیکربندی با مجوزهای ناامن برای پنهان کردن فایل‌ها از گزارش به کار رود.
.PP
پیکربندی‌های بازنویسی تکمیلی را می‌توان در /etc/lostfiles.d/ به صورت فایل‌های جداگانهٔ *.conf قرار داد. این فایل‌های الحاقی از همان قالب /etc/lostfiles.conf استفاده می‌کنند و پس از فایل پیکربندی اصلی به ترتیب واژگانی خوانده می‌شوند. این قابلیت به بسته‌ها یا مدیران محلی سیستم اجازه می‌دهد بدون تغییر فایل پیکربندی اصلی، قوانین سفارشی گنجاندن/استثنا را اضافه نمایند.
.SH "نکات (NOTES)"
نام‌های فایلی که حاوی نویسهٔ خط جدید واقعی هستند از نتایج حذف شده و به جای چاپ در خروجی، در قالب یک هشدار خلاصه در stderr گزارش می‌شوند؛ چرا که در غیر این صورت یک نام فایل دست‌کاری‌شده می‌توانست خطی جعلی را به گزارش تزریق کند.
.PP
دستور lostfiles نیازمند در دسترس بودن fd، pacman و شماری از ابزارهای استاندارد coreutils/base است؛ این برنامه در صورت فقدان هر یک، به جای تولید خاموش یک گزارش ناقص، از اجرا خودداری کرده و موارد ناموجود را فهرست می‌کند.
.SH "مشارکت (CONTRIBUTE)"
کاربرانی که تمایل به مشارکت در این کد دارند، می‌توانند آن را فورک کرده و یک pull request ارسال کنند. کد منبع به صورت آزاد در نشانی زیر در دسترس است:
.RS
.IP \(bu 3
https://github.com/graysky2/lostfiles
.SH "نویسندگان (AUTHORS)"
نگه‌دارندهٔ کنونی:
.IP \(bu 3
graysky <therealgraysky AT proton DOT me>
.PP
مشارکت‌کنندگان عمدهٔ پیشین:
.IP \(bu 3
Joan Bruguera (joanbrugueram AT gmail DOT com)
.IP \(bu 3
Mircea Bardac (dev AT mircea.bardac.net)
.IP \(bu 3
اصلاح‌شده توسط Jan Janssen، graysky، karol، asdffdsa، iceram و دیگران.