.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "dpkg-scanpackages 1"
.TH dpkg-scanpackages 1 2026-03-06 1.23.7-dirty "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
dpkg\-scanpackages \- ایجاد فایل‌های نمایه Packages
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdpkg\-scanpackages\fR
[\fIگزینه\fR...] \fIbinary\-path\fR
[\fIoverride\-file\fR
[\fIpath\-prefix\fR]]
\&\fB>\fR
\&\fIPackages\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBdpkg\-scanpackages\fR
درختی از بسته‌های دودویی دبیان را پیمایش و مرتب‌سازی کرده و یک فایل
\&\fBPackages\fR
ایجاد می‌کند؛ این فایل توسط
\&\fBapt\fR\|(8)،
\&\fBdselect\fR\|(1)
و غیره استفاده می‌شود تا به کاربر اعلام کند چه بسته‌هایی برای نصب در دسترس هستند. این فایل‌های
\&\fBPackages\fR
مشابه همان‌هایی هستند که در سایت‌های آرشیو دبیان و دیسک‌های رسانه‌ای یافت می‌شوند. اگر می‌خواهید دایرکتوری از بسته‌های محلی برای نصب روی خوشه‌ای از ماشین‌ها بسازید، می‌توانید خودتان از
\&\fBdpkg\-scanpackages\fR
استفاده کنید.
.PP
\&\fBنکته\fR:
اگر می‌خواهید با
\&\fBapt\fR\|(8)
به فایل
\&\fBPackages\fR
تولیدشده دسترسی داشته باشید، احتمالاً لازم است فایل را با
\&\fBxz\fR\|(1)
(تولید فایل Packages.xz)،
\&\fBbzip2\fR\|(1)
(تولید فایل Packages.bz2) یا
\&\fBgzip\fR\|(1)
(تولید فایل Packages.gz) فشرده‌سازی کنید.
\&\fBapt\fR\|(8)
فایل‌های فشرده‌نشدهٔ
\&\fBPackages\fR
را نادیده می‌گیرد، مگر در مواردی که دسترسی محلی باشد (مانند منابع
\&\fBfile://\fR).
.PP
مقدار
\&\fIbinary\-path\fR
نام درخت بسته‌های دودویی برای پردازش است (برای نمونه،
\&\fBcontrib/binary\-i386\fR).
بهتر است این مسیر نسبت به ریشهٔ آرشیو دبیان باشد، زیرا تمام فیلدهای Filename در فایل جدید
\&\fBPackages\fR
با این رشته آغاز خواهند شد.
.PP
مقدار
\&\fIoverride\-file\fR
نام فایلی برای خواندن است که اطلاعات مربوط به نحوه قرارگیری بسته در توزیع را شامل می‌شود (این فایل از نسخه 1.15.5 dpkg به بعد می‌تواند فشرده باشد)؛ ببینید:
\&\fBdeb\-override\fR\|(5).
.PP
مقدار
\&\fIpath\-prefix\fR
رشته‌ای اختیاری است که به ابتدای فیلدهای Filename افزوده می‌شود.
.PP
اگر بیش از یک نسخه از یک بسته پیدا شود، فقط جدیدترین نسخه در خروجی گنجانده می‌شود. اگر آنها نسخه یکسانی داشته باشند و تنها در معماری متفاوت باشند، تنها اولین مورد یافت‌شده استفاده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-t\fR, \fB\-\-type\fR \fItype\fR" 4
.IX Item "-t, --type type"
به جای بسته‌های ‎*.deb‎، بسته‌های ‎*.\fItype\fR‎ را پویش می‌کند.
.IP "\fB\-e\fR, \fB\-\-extra\-override\fR \fIfile\fR" 4
.IX Item "-e, --extra-override file"
فایل
\&\fIfile\fR
را برای یافتن جایگزینی‌های تکمیلی پویش می‌کند (این فایل از نسخه 1.15.5 dpkg به بعد می‌تواند فشرده باشد).
برای اطلاعات بیشتر درباره قالب آن،
\&\fBdeb\-extra\-override\fR\|(5)
را ببینید.
.IP "\fB\-a\fR, \fB\-\-arch\fR \fIarch\fR" 4
.IX Item "-a, --arch arch"
به جای پویش تمام بسته‌های deb، از الگویی متشکل از
\&\fI*_all.deb\fR
و
\&\fI*_arch.deb\fR،
یا در صورتی که
\&\fB\-\-no\-implicit\-arch\fR
مشخص شده باشد، از
\&\fI*_arch.deb\fR
استفاده می‌کند.
.IP \fB\-\-no\-implicit\-arch\fR 4
.IX Item "--no-implicit-arch"
هنگام تعیین
\&\fB\-\-arch\fR،
بسته‌های باینری معماری
\&\fBall\fR
را به طور ضمنی اضافه نمی‌کند.
.Sp
از نسخه 1.23.6 dpkg به بعد پشتیبانی می‌شود.
.IP "\fB\-h\fR, \fB\-\-hash\fR \fIhash\-list\fR" 4
.IX Item "-h, --hash hash-list"
تنها برای فهرست مشخص‌شده با ویرگول، هش‌های فایل را تولید می‌کند (از نسخه 1.17.14 dpkg به بعد).
حالت پیش‌فرض تولید تمام هش‌های پشتیبانی‌شده در حال حاضر است.
مقادیر پشتیبانی‌شده:
\&\fBmd5\fR،
\&\fBsha1\fR،
\&\fBsha256\fR.
.IP "\fB\-m\fR, \fB\-\-multiversion\fR" 4
.IX Item "-m, --multiversion"
تمام بسته‌های یافت‌شده را در خروجی می‌گنجاند.
.IP "\fB\-M\fR, \fB\-\-medium\fR \fIid\-string\fR" 4
.IX Item "-M, --medium id-string"
یک فیلد
\&\fBX\-Medium\fR
شامل مقدار
\&\fIid\-string\fR
اضافه می‌کند (از نسخه 1.15.5 dpkg به بعد).
این فیلد در صورتی لازم است که بخواهید فایل‌های
\&\fBPackages.cd\fR
را برای استفاده توسط روش دسترسی
\&\fBmedia\fR
در
\&\fBdselect\fR
ایجاد کنید.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
نمایش پیام راهنمای استفاده و خروج.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش نسخه و خروج.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
حالت رنگی را تنظیم می‌کند (از نسخه 1.18.5 dpkg به بعد).
مقادیر پذیرفته‌شده در حال حاضر عبارتند از:
\&\fBauto\fR
(پیش‌فرض)،
\&\fBalways\fR
و
\&\fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که با عنوان پشتیبانی از بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، به کار می‌رود (از نسخه 1.19.0 dpkg به بعد).
مقادیر پذیرفته‌شده عبارتند از:
\&\fB0\fR
و
\&\fB1\fR
(پیش‌فرض).
.SH "عیب‌یابی (DIAGNOSTICS)"
.IX Header "DIAGNOSTICS"
دستور
\&\fBdpkg\-scanpackages\fR
خطاهای معمول و خودتوضیح را نمایش می‌دهد.
همچنین درباره بسته‌هایی که در زیردایرکتوری اشتباه قرار دارند، تکراری هستند، دارای فیلد Filename در فایل کنترل خود هستند، در فایل override وجود ندارند، یا جایگزینی‌های نگه‌دارنده‌ای دارند که بی‌اثر هستند، هشدار می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdpkg\fR\|(1),
\&\fBdselect\fR\|(1),
\&\fBdeb\-override\fR\|(5),
\&\fBdeb\-extra\-override\fR\|(5),
\&\fBdpkg\-scansources\fR\|(1).