dpkg-scansources(1) dpkg suite dpkg-scansources(1)

dpkg-scansources - ایجاد فایل‌های نمایه منابع (Sources)

dpkg-scansources [گزینه...] binary-dir [override-file [path-prefix]] > Sources

دستور dpkg-scansources دایرکتوری binary-dir مشخص‌شده را برای یافتن فایل‌های .dsc پویش می‌کند. از این فایل‌ها برای ایجاد نمایه منابع دبیان استفاده می‌شود که در خروجی استاندارد چاپ می‌گردد.

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

نکته: از آنجا که نمایه فایل override بر اساس بسته‌های باینری است و نه بسته‌های منبع (source)، یک مشکل جزئی در اینجا وجود دارد. پیاده‌سازی فعلی بالاترین اولویت را در میان تمام بسته‌های باینری تولیدشده توسط یک فایل .dsc برای اولویت بسته منبع استفاده می‌کند، و از مدخل override مربوط به اولین بسته باینری فهرست‌شده در فایل .dsc برای تغییر اطلاعات نگه‌دارنده بهره می‌برد. این رفتار ممکن است تغییر کند.

مقدار path-prefix در صورت ارائه، به ابتدای فیلد دایرکتوری در نمایه منبع تولیدشده افزوده می‌شود. شما عموماً از این گزینه استفاده می‌کنید تا فیلدهای دایرکتوری، مسیر را از بالاترین سطح سلسله‌مراتب آرشیو دبیان در بر داشته باشند.

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

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

قالب فایل override منبع با فایل override باینری متفاوت است. این فایل تنها شامل دو فیلد جداشده با فاصله خالی است؛ اولی نام بسته منبع و دومی بخش (section) مربوطه است. خطوط خالی و خطوط توضیحات طبق معمول نادیده گرفته می‌شوند. اگر بسته‌ای در هر دو فایل وجود داشته باشد، فایل override منبع برای تعیین بخش اولویت خواهد داشت.

فعال‌سازی حالت اشکال‌زدایی.
نمایش پیام راهنمای استفاده و خروج.
نمایش نسخه و خروج.

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

deb-override(5), deb-extra-override(5), dpkg-scanpackages(1).

2026-03-06 1.23.7-dirty