dpkg-scanpackages(1)              dpkg suite              dpkg-scanpackages(1)


نام (NAME)
       dpkg-scanpackages - ایجاد فایل‌های نمایه Packages

خلاصه دستور (SYNOPSIS)
       dpkg-scanpackages [گزینه...] binary-path [override-file [path-prefix]]
       > Packages

توضیحات (DESCRIPTION)
       دستور dpkg-scanpackages درختی از بسته‌های دودویی دبیان را پیمایش و
       مرتب‌سازی کرده و یک فایل Packages ایجاد می‌کند؛ این فایل توسط apt(8)،
       dselect(1) و غیره استفاده می‌شود تا به کاربر اعلام کند چه بسته‌هایی برای
       نصب در دسترس هستند. این فایل‌های Packages مشابه همان‌هایی هستند که در
       سایت‌های آرشیو دبیان و دیسک‌های رسانه‌ای یافت می‌شوند. اگر می‌خواهید
       دایرکتوری از بسته‌های محلی برای نصب روی خوشه‌ای از ماشین‌ها بسازید،
       می‌توانید خودتان از dpkg-scanpackages استفاده کنید.

       نکته: اگر می‌خواهید با apt(8) به فایل Packages تولیدشده دسترسی داشته
       باشید، احتمالاً لازم است فایل را با xz(1) (تولید فایل Packages.xz)،
       bzip2(1) (تولید فایل Packages.bz2) یا gzip(1) (تولید فایل Packages.gz)
       فشرده‌سازی کنید.  apt(8) فایل‌های فشرده‌نشدهٔ Packages را نادیده می‌گیرد،
       مگر در مواردی که دسترسی محلی باشد (مانند منابع file://).

       مقدار binary-path نام درخت بسته‌های دودویی برای پردازش است (برای نمونه،
       contrib/binary-i386).  بهتر است این مسیر نسبت به ریشهٔ آرشیو دبیان باشد،
       زیرا تمام فیلدهای Filename در فایل جدید Packages با این رشته آغاز
       خواهند شد.

       مقدار override-file نام فایلی برای خواندن است که اطلاعات مربوط به نحوه
       قرارگیری بسته در توزیع را شامل می‌شود (این فایل از نسخه 1.15.5 dpkg به
       بعد می‌تواند فشرده باشد)؛ ببینید: deb-override(5).

       مقدار path-prefix رشته‌ای اختیاری است که به ابتدای فیلدهای Filename
       افزوده می‌شود.

       اگر بیش از یک نسخه از یک بسته پیدا شود، فقط جدیدترین نسخه در خروجی
       گنجانده می‌شود. اگر آنها نسخه یکسانی داشته باشند و تنها در معماری متفاوت
       باشند، تنها اولین مورد یافت‌شده استفاده می‌شود.

گزینه‌ها (OPTIONS)
       -t, --type type
           به جای بسته‌های ‎*.deb‎، بسته‌های ‎*.type‎ را پویش می‌کند.

       -e, --extra-override file
           فایل file را برای یافتن جایگزینی‌های تکمیلی پویش می‌کند (این فایل از
           نسخه 1.15.5 dpkg به بعد می‌تواند فشرده باشد).  برای اطلاعات بیشتر
           درباره قالب آن، deb-extra-override(5) را ببینید.

       -a, --arch arch
           به جای پویش تمام بسته‌های deb، از الگویی متشکل از *_all.deb و
           *_arch.deb، یا در صورتی که --no-implicit-arch مشخص شده باشد، از
           *_arch.deb استفاده می‌کند.

       --no-implicit-arch
           هنگام تعیین --arch، بسته‌های باینری معماری all را به طور ضمنی اضافه
           نمی‌کند.

           از نسخه 1.23.6 dpkg به بعد پشتیبانی می‌شود.

       -h, --hash hash-list
           تنها برای فهرست مشخص‌شده با ویرگول، هش‌های فایل را تولید می‌کند (از
           نسخه 1.17.14 dpkg به بعد).  حالت پیش‌فرض تولید تمام هش‌های
           پشتیبانی‌شده در حال حاضر است.  مقادیر پشتیبانی‌شده: md5، sha1،
           sha256.

       -m, --multiversion
           تمام بسته‌های یافت‌شده را در خروجی می‌گنجاند.

       -M, --medium id-string
           یک فیلد X-Medium شامل مقدار id-string اضافه می‌کند (از نسخه 1.15.5
           dpkg به بعد).  این فیلد در صورتی لازم است که بخواهید فایل‌های
           Packages.cd را برای استفاده توسط روش دسترسی media در dselect ایجاد
           کنید.

       -?, --help
           نمایش پیام راهنمای استفاده و خروج.

       --version
           نمایش نسخه و خروج.

محیط (ENVIRONMENT)
       DPKG_COLORS
           حالت رنگی را تنظیم می‌کند (از نسخه 1.18.5 dpkg به بعد).  مقادیر
           پذیرفته‌شده در حال حاضر عبارتند از: auto (پیش‌فرض)، always و never.

       DPKG_NLS
           در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان
           بومی (Native Language Support)، که با عنوان پشتیبانی از
           بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، به کار می‌رود (از نسخه
           1.19.0 dpkg به بعد).  مقادیر پذیرفته‌شده عبارتند از: 0 و 1 (پیش‌فرض).

عیب‌یابی (DIAGNOSTICS)
       دستور dpkg-scanpackages خطاهای معمول و خودتوضیح را نمایش می‌دهد.  همچنین
       درباره بسته‌هایی که در زیردایرکتوری اشتباه قرار دارند، تکراری هستند،
       دارای فیلد Filename در فایل کنترل خود هستند، در فایل override وجود
       ندارند، یا جایگزینی‌های نگه‌دارنده‌ای دارند که بی‌اثر هستند، هشدار می‌دهد.

همچنین ببینید (SEE ALSO)
       dpkg(1), dselect(1), deb-override(5), deb-extra-override(5),
       dpkg-scansources(1).

1.23.7-dirty                      2026-03-06              dpkg-scanpackages(1)