lostfiles(1) lostfiles(1)

lostfiles - یافتن فایل‌های یتیمی که متعلق به هیچ بسته‌ای نیستند

lostfiles [-s] [-z] [-h]

دستور lostfiles پایگاه دادهٔ فایل‌های متعلق به بسته‌ها در pacman را با محتویات واقعی سیستم‌فایل مقایسه کرده و فایل‌هایی را که متعلق به هیچ بسته‌ای نیستند گزارش می‌دهد. برای شناسایی فایل‌های غیربومی کاربرد دارد. باید به عنوان ریشه (root) اجرا شود.

-s

اجرا در حالت سخت‌گیرانه (strict) با هدف نمایش جزئیات بیشتر و نادیده‌گیری کمتر.
-z 
چاپ و مرتب‌سازی بر اساس اندازه موارد منطبق.
-h 
نمایش اطلاعات نحوه استفاده و خروج.

فایل lostfiles.conf می‌تواند هنگام اجرا در حالت آسان‌گیر (relaxed) با فهرستی از مسیرها برای گنجاندن یا مستثنی‌کردن سفارشی‌سازی شود. هر خط که با یک علامت بعلاوه (+) یا منها (-) آغاز شود و به دنبال آن یک مسیر مطلق بیاید، به ترتیب آن مسیر را در نتایج می‌گنجاند یا از آن مستثنی می‌کند. مسیرهای استثنا به صورت الگوهای عام شل (shell-style globs) تطبیق داده می‌شوند: یک ستاره (*) با هر رشته‌ای در یک مؤلفهٔ مسیر مطابقت دارد، و دو ستاره (**) در میان جداکننده‌های دایرکتوری مطابقت می‌یابد. مستثنی کردن یک دایرکتوری، تمام زیردرخت آن را هرس می‌کند. خطوطی که با علامت هش (#) شروع شوند به عنوان توضیح در نظر گرفته می‌شوند. هر خط دیگری باعث می‌شود lostfiles با خطا متوقف شود، تا از نادیده گرفته شدن خاموش یک قاعدهٔ معیوب جلوگیری گردد.

دستور lostfiles ابتدا در کنار خود اسکریپت به دنبال lostfiles.conf می‌گردد؛ اگر این فایل مفقود باشد، یا اگر خودش (یا دایرکتوری دربرگیرندهٔ آن) متعلق به root یا کاربر فراخوانندهٔ sudo نباشد، یا توسط گروه یا دیگران قابل نوشتن باشد، همراه با یک هشدار نادیده گرفته می‌شود و lostfiles در عوض به /etc/lostfiles.conf رجوع می‌کند. این امر مانع از آن می‌شود که یک فایل پیکربندی با مجوزهای ناامن برای پنهان کردن فایل‌ها از گزارش به کار رود.

پیکربندی‌های بازنویسی تکمیلی را می‌توان در /etc/lostfiles.d/ به صورت فایل‌های جداگانهٔ *.conf قرار داد. این فایل‌های الحاقی از همان قالب /etc/lostfiles.conf استفاده می‌کنند و پس از فایل پیکربندی اصلی به ترتیب واژگانی خوانده می‌شوند. این قابلیت به بسته‌ها یا مدیران محلی سیستم اجازه می‌دهد بدون تغییر فایل پیکربندی اصلی، قوانین سفارشی گنجاندن/استثنا را اضافه نمایند.

نام‌های فایلی که حاوی نویسهٔ خط جدید واقعی هستند از نتایج حذف شده و به جای چاپ در خروجی، در قالب یک هشدار خلاصه در stderr گزارش می‌شوند؛ چرا که در غیر این صورت یک نام فایل دست‌کاری‌شده می‌توانست خطی جعلی را به گزارش تزریق کند.

دستور lostfiles نیازمند در دسترس بودن fd، pacman و شماری از ابزارهای استاندارد coreutils/base است؛ این برنامه در صورت فقدان هر یک، به جای تولید خاموش یک گزارش ناقص، از اجرا خودداری کرده و موارد ناموجود را فهرست می‌کند.

کاربرانی که تمایل به مشارکت در این کد دارند، می‌توانند آن را فورک کرده و یک pull request ارسال کنند. کد منبع به صورت آزاد در نشانی زیر در دسترس است:

•
https://github.com/graysky2/lostfiles

نگه‌دارندهٔ کنونی:

•
graysky <therealgraysky AT proton DOT me>

مشارکت‌کنندگان عمدهٔ پیشین:

  • Joan Bruguera (joanbrugueram AT gmail DOT com)
  • Mircea Bardac (dev AT mircea.bardac.net)
  • اصلاح‌شده توسط Jan Janssen، graysky، karol، asdffdsa، iceram و دیگران.
12 July 2026