نام (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).