'\" t
.\"     Title: apt-ftparchive
.\"    Author: Jason Gunthorpe
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 29\ \&January\ \&2023
.\"    Manual: APT
.\"    Source: APT 3.3.3
.\"  Language: Persian
.\"
.TH "APT\-FTPARCHIVE" "1" "29\ \&January\ \&2023" "APT 3.3.3" "APT"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
apt-ftparchive \- ابزار تولید فایل‌های شاخص و ایندکس مخزن بسته
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBapt\-ftparchive\fR\ 'u
\fBapt\-ftparchive\fR [\fB\-dsq\fR] [\fB\-\-md5\fR] [\fB\-\-delink\fR] [\fB\-\-readonly\fR] [\fB\-\-contents\fR] [\fB\-\-arch\ \fR\fB\fIarchitecture\fR\fR] [\fB\-o=\fR\fB\fIconfig_string\fR\fR] [\fB\-c=\fR\fB\fIconfig_file\fR\fR] {packages\ \fIpath\fR\ [\fIoverride\-file\fR\ [\fIpathprefix\fR]]  | sources\ \fIpath\fR\ [\fIoverride\-file\fR\ [\fIpathprefix\fR]]  | contents\ \fIpath\fR  | release\ \fIpath\fR  | generate\ \fIconfig_file\fR\ \fIsection\fR...  | clean\ \fIconfig_file\fR  | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help}}
.SH "توضیحات (DESCRIPTION)"
.PP
\fBapt\-ftparchive\fR
یک ابزار خط فرمان است که فایل‌های شاخص مورد استفاده APT برای دسترسی به یک منبع توزیع را تولید می‌کند\&. فایل‌های شاخص باید در سایت مبدأ بر اساس محتوای آن سایت تولید شوند\&.
.PP
\fBapt\-ftparchive\fR
یک ابرمجموعه از برنامه
\fBdpkg-scanpackages\fR(1)
است که تمام عملکردهای آن را از طریق دستور
packages
در بر می‌گیرد\&. این ابزار همچنین شامل یک تولیدکننده فایل محتویات (contents file generator)، یعنی
contents
و ابزاری کامل برای «اسکریپت‌نویسی» فرایند تولید برای یک آرشیو کامل است\&.
.PP
به‌طور داخلی،
\fBapt\-ftparchive\fR
می‌تواند از پایگاه‌های داده باینری برای کش کردن محتویات یک فایل \&.deb استفاده کند و به هیچ برنامه خارجی به جز
\fBgzip\fR(1)
متکی نیست\&. هنگام اجرای یک تولید کامل (full generate)، این ابزار به‌طور خودکار بررسی‌های تغییر فایل را انجام داده و فایل‌های خروجی فشرده‌شده مورد نظر را می‌سازد\&.
.PP
مگر اینکه گزینه
\fB\-h\fR
یا
\fB\-\-help\fR
داده شده باشد، یکی از دستورات زیر باید مشخص شود\&.
.PP
\fBpackages\fR
.RS 4
دستور packages یک فایل بسته (Package) را از یک درخت دایرکتوری تولید می‌کند\&. این دستور دایرکتوری داده‌شده را دریافت کرده و آن را به‌صورت بازگشتی برای فایل‌های \&.deb جستجو می‌کند و برای هر کدام یک رکورد بسته را در stdout منتشر می‌کند\&. این دستور تقریباً معادل
\fBdpkg-scanpackages\fR(1)
است\&.
.sp
گزینه
\fB\-\-db\fR
می‌تواند برای مشخص کردن یک پایگاه‌داده کش باینری استفاده شود\&.
.RE
.PP
\fBsources\fR
.RS 4
دستور
sources
یک فایل شاخص سورس را از یک درخت دایرکتوری تولید می‌کند\&. این دستور دایرکتوری داده‌شده را دریافت کرده و آن را به‌صورت بازگشتی برای فایل‌های \&.dsc جستجو می‌کند و برای هر کدام یک رکورد سورس را در stdout منتشر می‌کند\&. این دستور تقریباً معادل
\fBdpkg-scansources\fR(1)
است\&.
.sp
اگر یک فایل override مشخص شود، یک فایل override سورس با پسوند \&.src جستجو خواهد شد\&. از گزینه \-\-source\-override می‌توان برای تغییر فایل override سورس مورد استفاده بهره برد\&.
.RE
.PP
\fBcontents\fR
.RS 4
دستور
contents
یک فایل محتویات (Contents) را از یک درخت دایرکتوری تولید می‌کند\&. این دستور دایرکتوری داده‌شده را دریافت کرده و آن را به‌صورت بازگشتی برای فایل‌های \&.deb جستجو می‌کند و فهرست فایل‌ها را از هر فایل می‌خواند\&. سپس فهرست فایل‌های تطبیق‌داده‌شده با بسته‌ها را مرتب کرده و در stdout می‌نویسد\&. دایرکتوری‌ها در خروجی نوشته نمی‌شوند\&. اگر چندین بسته مالک یک فایل مشترک باشند، هر بسته با یک کاما در خروجی جدا می‌شود\&.
.sp
گزینه
\fB\-\-db\fR
می‌تواند برای مشخص کردن یک پایگاه‌داده کش باینری استفاده شود\&.
.RE
.PP
\fBrelease\fR
.RS 4
دستور
release
یک فایل Release را از یک درخت دایرکتوری تولید می‌کند\&. این دستور به‌طور پیش‌فرض به‌صورت بازگشتی دایرکتوری داده‌شده را برای فایل‌های فشرده و غیرفشرده
Packages,
Sources,
Contents,
Components
و
icons
و همچنین فایل‌های
Release,
Index
و
md5sum\&.txt
جستجو می‌کند (APT::FTPArchive::Release::Default\-Patterns)\&. الگوهای نام فایل اضافی را می‌توان با درج آن‌ها در
APT::FTPArchive::Release::Patterns
اضافه کرد\&. سپس این دستور یک فایل
Release
شامل خلاصه پیام‌های (digest) الگوریتم‌های MD5، SHA1، SHA256 و SHA512 را (به‌طور پیش‌فرض) برای هر فایل در stdout می‌نویسد\&.
.sp
مقادیر فیلدهای فراداده اضافی در فایل Release از متغیرهای متناظر در زیر
APT::FTPArchive::Release
گرفته می‌شوند، مانند
APT::FTPArchive::Release::Origin\&.
فیلدهای پشتیبانی‌شده عبارتند از:
Origin,
Label,
Suite,
Version,
Codename,
Date,
NotAutomatic,
ButAutomaticUpgrades,
Acquire\-By\-Hash,
Valid\-Until,
Signed\-By,
Architectures,
Components
و
Description\&.
.RE
.PP
\fBgenerate\fR
.RS 4
دستور
generate
برای اجرا از طریق یک اسکریپت cron طراحی شده است و شاخص‌ها را مطابق با فایل پیکربندی داده‌شده می‌سازد\&. زبان پیکربندی روشی انعطاف‌پذیر برای تعیین اینکه چه فایل‌های شاخصی از کدام دایرکتوری‌ها ساخته شوند فراهم می‌کند، و همچنین ابزاری ساده برای نگهداری تنظیمات مورد نیاز ارائه می‌دهد\&.
.RE
.PP
\fBclean\fR
.RS 4
دستور
clean
پایگاه‌های داده استفاده‌شده توسط فایل پیکربندی داده‌شده را با حذف رکوردهایی که دیگر ضروری نیستند مرتب و پاکسازی می‌کند\&.
.RE
.SH "پیکربندی GENERATE (THE GENERATE CONFIGURATION)"
.PP
دستور
generate
از یک فایل پیکربندی برای توصیف آرشیوهایی که قرار است تولید شوند استفاده می‌کند\&. این فایل از فرمت استاندارد پیکربندی ISC که در ابزارهای ISC مانند bind 8 و dhcpd دیده می‌شود پیروی می‌کند\&.
\fBapt.conf\fR(5)
حاوی توضیحات مربوط به قواعد نحوی آن است\&. توجه داشته باشید که پیکربندی generate به‌صورت بخش‌بندی‌شده (sectional) تجزیه می‌شود، اما
\fBapt.conf\fR(5)
به‌صورت درختی (tree) تجزیه می‌گردد\&. این موضوع تنها بر نحوه مدیریت برچسب دامنه (scope tag) تأثیر می‌گذارد\&.
.PP
پیکربندی generate دارای چهار بخش جداگانه است که هر کدام در زیر توضیح داده شده‌اند\&.
.SS "بخش Dir"
.PP
بخش
Dir
دایرکتوری‌های استانداردی را تعریف می‌کند که برای یافتن فایل‌های مورد نیاز در طول فرایند تولید لازم هستند\&. این دایرکتوری‌ها به ابتدای مسیرهای نسبی خاصی که در بخش‌های بعدی تعریف شده‌اند اضافه می‌شوند تا یک مسیر مطلق کامل را ایجاد کنند\&.
.PP
\fBArchiveDir\fR
.RS 4
ریشه آرشیو FTP را مشخص می‌کند؛ در یک پیکربندی استاندارد دبیان، این همان دایرکتوری حاوی گره‌های
ls\-LR
و dist است\&.
.RE
.PP
\fBOverrideDir\fR
.RS 4
محل فایل‌های override را مشخص می‌کند\&.
.RE
.PP
\fBCacheDir\fR
.RS 4
محل فایل‌های کش را مشخص می‌کند\&.
.RE
.PP
\fBFileListDir\fR
.RS 4
اگر تنظیم
FileList
در زیر استفاده شده باشد، محل فایل‌های فهرست فایل را مشخص می‌کند\&.
.RE
.SS "بخش Default"
.PP
بخش
Default
مقادیر پیش‌فرض و تنظیماتی را که عملکرد تولیدکننده را کنترل می‌کنند مشخص می‌نماید\&. سایر بخش‌ها می‌توانند این مقادیر پیش‌فرض را با تنظیمات خاص هر بخش بازنویسی (override) کنند\&.
.PP
\fBPackages::Compress\fR
.RS 4
طرح‌های فشرده‌سازی پیش‌فرض مورد استفاده برای فایل‌های شاخص بسته را تعیین می‌کند\&. این یک رشته شامل فهرستی جداشده با فاصله از حداقل یکی از فشرده‌سازهای پیکربندی‌شده از طریق دامنه پیکربندی
\fBAPT::Compressor\fR
است\&. مقدار پیش‌فرض برای تمام طرح‌های فشرده‌سازی \*(Aq\&. gzip\*(Aq است\&.
.RE
.PP
\fBPackages::Extensions\fR
.RS 4
فهرست پیش‌فرض پسوندهای فایلی را که فایل بسته هستند تعیین می‌کند\&. مقدار پیش‌فرض آن \*(Aq\&.deb\*(Aq است\&.
.RE
.PP
\fBSources::Compress\fR
.RS 4
این گزینه مشابه
Packages::Compress
است با این تفاوت که فشرده‌سازی فایل‌های Sources را کنترل می‌کند\&.
.RE
.PP
\fBSources::Extensions\fR
.RS 4
فهرست پیش‌فرض پسوندهای فایلی را که فایل سورس هستند تعیین می‌کند\&. مقدار پیش‌فرض آن \*(Aq\&.dsc\*(Aq است\&.
.RE
.PP
\fBContents::Compress\fR
.RS 4
این گزینه مشابه
Packages::Compress
است با این تفاوت که فشرده‌سازی فایل‌های Contents را کنترل می‌کند\&.
.RE
.PP
\fBTranslation::Compress\fR
.RS 4
این گزینه مشابه
Packages::Compress
است با این تفاوت که فشرده‌سازی فایل اصلی Translation\-en را کنترل می‌کند\&.
.RE
.PP
\fBDeLinkLimit\fR
.RS 4
تعداد کیلوبایت‌هایی را که باید در هر اجرا پیوندزدایی (delink) شده (و با پیوندهای سخت جایگزین شوند) مشخص می‌کند\&. این گزینه همراه با تنظیم اختصاصی هر بخش یعنی
External\-Links
استفاده می‌شود\&.
.RE
.PP
\fBFileMode\fR
.RS 4
حالت دسترسی (mode) تمام فایل‌های شاخص ایجادشده را مشخص می‌کند\&. مقدار پیش‌فرض آن 0644 است\&. تمام فایل‌های شاخص بدون در نظر گرفتن umask روی این حالت تنظیم می‌شوند\&.
.RE
.PP
\fBLongDescription\fR
.RS 4
مشخص می‌کند که آیا توضیحات طولانی باید در فایل
Packages
گنجانده شوند یا در یک فایل اصلی
Translation\-en
جداگانه تفکیک گردند\&.
.RE
.SS "بخش TreeDefault"
.PP
پیش‌فرض‌های مختص بخش‌های
Tree
را تعیین می‌کند\&. همه این متغیرها متغیرهای جایگزینی هستند و رشته‌های $(DIST)، $(SECTION) و $(ARCH) با مقادیر متناظر خود جایگزین می‌شوند\&.
.PP
\fBMaxContentsChange\fR
.RS 4
تعداد کیلوبایت فایل‌های Contents تولیدشده در هر روز را تعیین می‌کند\&. فایل‌های Contents به‌صورت نوبتی (round-robin) پردازش می‌شوند تا در طول چند روز همه آن‌ها دوباره ساخته شوند\&.
.RE
.PP
\fBContentsAge\fR
.RS 4
تعداد روزهایی را که یک فایل Contents مجاز است بدون تغییر بررسی شود کنترل می‌کند\&. اگر این حد سپری شود، mtime فایل Contents به‌روزرسانی می‌شود\&. این حالت می‌تواند در صورتی رخ دهد که فایل بسته به گونه‌ای تغییر کند که منجر به ایجاد یک فایل Contents جدید نشود [برای مثال، ویرایش override]\&. این مهلت به امید اینکه \&.debهای جدید نصب شوند و در هر صورت به فایل جدید نیاز باشد در نظر گرفته شده است\&. مقدار پیش‌فرض 10 است و واحد آن بر حسب روز می‌باشد\&.
.RE
.PP
\fBDirectory\fR
.RS 4
بالاترین سطح درخت دایرکتوری \&.deb را تعیین می‌کند\&. مقدار پیش‌فرض آن
$(DIST)/$(SECTION)/binary\-$(ARCH)/
است\&.
.RE
.PP
\fBSrcDirectory\fR
.RS 4
بالاترین سطح درخت دایرکتوری بسته‌های سورس را تعیین می‌کند\&. مقدار پیش‌فرض آن
$(DIST)/$(SECTION)/source/
است\&.
.RE
.PP
\fBPackages\fR
.RS 4
فایل خروجی Packages را تعیین می‌کند\&. مقدار پیش‌فرض آن
$(DIST)/$(SECTION)/binary\-$(ARCH)/Packages
است\&.
.RE
.PP
\fBSources\fR
.RS 4
فایل خروجی Sources را تعیین می‌کند\&. مقدار پیش‌فرض آن
$(DIST)/$(SECTION)/source/Sources
است\&.
.RE
.PP
\fBTranslation\fR
.RS 4
فایل اصلی خروجی Translation\-en حاوی توضیحات طولانی را (در صورتی که قرار نیست در فایل Packages گنجانده شوند) تعیین می‌کند\&. مقدار پیش‌فرض آن
$(DIST)/$(SECTION)/i18n/Translation\-en
است\&.
.RE
.PP
\fBInternalPrefix\fR
.RS 4
پیشوند مسیری را تعیین می‌کند که باعث می‌شود یک پیوند نمادین (symlink) به‌جای یک پیوند خارجی، یک پیوند داخلی محسوب شود\&. مقدار پیش‌فرض آن
$(DIST)/$(SECTION)/
است\&.
.RE
.PP
\fBContents\fR
.RS 4
فایل خروجی Contents را تعیین می‌کند\&. مقدار پیش‌فرض آن
$(DIST)/$(SECTION)/Contents\-$(ARCH)
است\&. اگر این تنظیم باعث شود چندین فایل Packages به یک فایل Contents واحد نگاشت شوند (همان‌طور که حالت پیش‌فرض است)، آن‌گاه
\fBapt\-ftparchive\fR
آن فایل‌های بسته را به‌طور خودکار با یکدیگر ادغام خواهد کرد\&.
.RE
.PP
\fBContents::Header\fR
.RS 4
فایل سرآیندی (header file) را که باید به ابتدای خروجی contents اضافه شود تعیین می‌کند\&.
.RE
.PP
\fBBinCacheDB\fR
.RS 4
پایگاه‌داده کش باینری را برای استفاده در این بخش تعیین می‌کند\&. چندین بخش می‌توانند از یک پایگاه‌داده مشترک استفاده کنند\&.
.RE
.PP
\fBFileList\fR
.RS 4
مشخص می‌کند که
\fBapt\-ftparchive\fR
به‌جای پیمایش درخت دایرکتوری، باید فهرست فایل‌ها را از فایل داده‌شده بخواند\&. نام فایل‌های نسبی با دایرکتوری آرشیو پیشوندگذاری می‌شوند\&.
.RE
.PP
\fBSourceFileList\fR
.RS 4
مشخص می‌کند که
\fBapt\-ftparchive\fR
به‌جای پیمایش درخت دایرکتوری، باید فهرست فایل‌ها را از فایل داده‌شده بخواند\&. نام فایل‌های نسبی با دایرکتوری آرشیو پیشوندگذاری می‌شوند\&. این گزینه هنگام پردازش شاخص‌های سورس استفاده می‌شود\&.
.RE
.SS "بخش Tree"
.PP
بخش
Tree
یک درخت فایل استاندارد دبیان را تعریف می‌کند که شامل یک دایرکتوری پایه، سپس چندین بخش (section) در آن دایرکتوری پایه و در نهایت چندین معماری (Architecture) در هر بخش است\&. مسیربندی دقیق مورد استفاده توسط متغیر جایگزینی
Directory
تعریف می‌شود\&.
.PP
بخش
Tree
یک برچسب دامنه (scope tag) دریافت می‌کند که متغیر
$(DIST)
را تنظیم کرده و ریشه درخت را تعریف می‌نماید (مسیر با
ArchiveDir
پیشوند می‌گیرد)\&. معمولاً این تنظیمی مانند
dists/trixie
است\&.
.PP
تمام تنظیمات تعریف‌شده در بخش
TreeDefault
را می‌توان در یک بخش
Tree
به همراه سه متغیر جدید استفاده کرد\&.
.PP
هنگام پردازش یک بخش
Tree
،
\fBapt\-ftparchive\fR
عملیاتی شبیه به این را انجام می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
for i in Sections do
   for j in Architectures do
      Generate for DIST=scope SECTION=i ARCH=j

.fi
.if n \{\
.RE
.\}

.PP
\fBSections\fR
.RS 4
فهرستی جداشده با فاصله از بخش‌هایی است که در زیر توزیع ظاهر می‌شوند؛ معمولاً چیزی شبیه به
main contrib non\-free non\-free\-firmware
است\&.
.RE
.PP
\fBArchitectures\fR
.RS 4
فهرستی جداشده با فاصله از تمام معماری‌هایی است که در زیر بخش جستجو ظاهر می‌شوند\&. معماری ویژه \*(Aqsource\*(Aq برای نشان دادن اینکه این درخت دارای یک آرشیو سورس است استفاده می‌شود\&. معماری \*(Aqall\*(Aq نشان می‌دهد که فایل‌های مختص معماری مانند
Packages
نباید اطلاعات مربوط به بسته‌های معماری
all
را در همه فایل‌ها بگنجانند، زیرا آن‌ها در یک فایل اختصاصی در دسترس خواهند بود\&.
.RE
.PP
\fBLongDescription\fR
.RS 4
مشخص می‌کند که آیا توضیحات طولانی باید در فایل
Packages
گنجانده شوند یا در یک فایل اصلی
Translation\-en
تفکیک گردند\&.
.RE
.PP
\fBBinOverride\fR
.RS 4
فایل override باینری را تعیین می‌کند\&. فایل override حاوی اطلاعات بخش، اولویت و آدرس نگهدارنده است\&.
.RE
.PP
\fBSrcOverride\fR
.RS 4
فایل override سورس را تعیین می‌کند\&. فایل override حاوی اطلاعات بخش است\&.
.RE
.PP
\fBExtraOverride\fR
.RS 4
فایل extra override باینری را تعیین می‌کند\&.
.RE
.PP
\fBSrcExtraOverride\fR
.RS 4
فایل extra override سورس را تعیین می‌کند\&.
.RE
.SS "بخش BinDirectory"
.PP
بخش
bindirectory
یک درخت دایرکتوری باینری بدون ساختار ویژه را تعریف می‌کند\&. برچسب دامنه (scope tag) محل دایرکتوری باینری را مشخص می‌کند و تنظیمات آن مشابه بخش
Tree
است بدون هیچ‌گونه متغیرهای جایگزینی یا تنظیمات
SectionArchitecture\&.
.PP
\fBPackages\fR
.RS 4
خروجی فایل Packages را تعیین می‌کند\&.
.RE
.PP
\fBSources\fR
.RS 4
خروجی فایل Sources را تعیین می‌کند\&. حداقل یکی از
Packages
یا
Sources
الزامی است\&.
.RE
.PP
\fBContents\fR
.RS 4
خروجی فایل Contents را تعیین می‌کند (اختیاری)\&.
.RE
.PP
\fBBinOverride\fR
.RS 4
فایل override باینری را تعیین می‌کند\&.
.RE
.PP
\fBSrcOverride\fR
.RS 4
فایل override سورس را تعیین می‌کند\&.
.RE
.PP
\fBExtraOverride\fR
.RS 4
فایل extra override باینری را تعیین می‌کند\&.
.RE
.PP
\fBSrcExtraOverride\fR
.RS 4
فایل extra override سورس را تعیین می‌کند\&.
.RE
.PP
\fBBinCacheDB\fR
.RS 4
پایگاه‌داده کش را تعیین می‌کند\&.
.RE
.PP
\fBPathPrefix\fR
.RS 4
مسیری را به تمام مسیرهای خروجی الحاق می‌کند\&.
.RE
.PP
\fBFileList\fR, \fBSourceFileList\fR
.RS 4
فایل فهرست فایل را مشخص می‌کند\&.
.RE
.SH "فایل OVERRIDE باینری (THE BINARY OVERRIDE FILE)"
.PP
فایل override باینری کاملاً با
\fBdpkg-scanpackages\fR(1)
سازگار است\&. این فایل شامل چهار فیلد است که با فاصله از هم جدا شده‌اند\&. فیلد اول نام بسته، فیلد دوم اولویتی که باید به آن بسته تحمیل شود، فیلد سوم بخشی که باید به آن بسته تحمیل شود و فیلد نهایی فیلد جایگشت نگهدارنده (maintainer permutation) است\&.
.PP
شکل کلی فیلد نگهدارنده به این صورت است:
.sp
.if n \{\
.RS 4
.\}
.nf
old [// oldn]* => new
.fi
.if n \{\
.RE
.\}
.sp
یا به سادگی:
.sp
.if n \{\
.RS 4
.\}
.nf
new
.fi
.if n \{\
.RE
.\}
.sp
شکل اول امکان مشخص کردن فهرستی از آدرس‌های ایمیل قدیمی جداشده با اسلش دوگانه (//) را فراهم می‌کند\&. اگر هر یک از آن‌ها یافت شود، new جایگزین فیلد نگهدارنده می‌شود\&. شکل دوم بدون قید و شرط فیلد نگهدارنده را جایگزین می‌کند\&.
.SH "فایل OVERRIDE سورس (THE SOURCE OVERRIDE FILE)"
.PP
فایل override سورس کاملاً با
\fBdpkg-scansources\fR(1)
سازگار است\&. این فایل شامل دو فیلد است که با فاصله از هم جدا شده‌اند\&. فیلد اول نام بسته سورس و فیلد دوم بخشی است که باید به آن اختصاص یابد\&.
.SH "فایل EXTRA OVERRIDE (THE EXTRA OVERRIDE FILE)"
.PP
فایل extra override امکان افزودن یا جایگزینی هر تگ دلخواه را در خروجی فراهم می‌کند\&. این فایل دارای سه ستون است: ستون اول نام بسته، ستون دوم تگ و بقیه خط مقدار جدید است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
تمام گزینه‌های خط فرمان را می‌توان با استفاده از فایل پیکربندی تنظیم کرد؛ توضیحات، گزینه پیکربندی مربوطه را برای تنظیم نشان می‌دهند\&. برای گزینه‌های بولی می‌توانید فایل پیکربندی را با مواردی مانند
\fB\-f\-\fR،\fB\-\-no\-f\fR،
\fB\-f=no\fR
یا چندین حالت دیگر بازنویسی (override) کنید\&.
.PP
\fB\-\-md5\fR, \fB\-\-sha1\fR, \fB\-\-sha256\fR, \fB\-\-sha512\fR
.RS 4
تولید چکسام داده‌شده\&. این گزینه‌ها به‌طور پیش‌فرض روشن هستند؛ در صورت خاموش بودن، فایل‌های شاخص تولیدشده در صورت امکان فاقد فیلدهای چکسام خواهند بود\&. آیتم‌های پیکربندی:
APT::FTPArchive::\fIChecksum\fR
و
APT::FTPArchive::\fIIndex\fR::\fIChecksum\fR
که در آن
\fIIndex\fR
می‌تواند
Packages,
Sources
یا
Release
باشد و
\fIChecksum\fR
می‌تواند
MD5,
SHA1,
SHA256
یا
SHA512
باشد\&.
.RE
.PP
\fB\-d\fR, \fB\-\-db\fR
.RS 4
استفاده از یک پایگاه‌داده کش باینری\&. این گزینه تاثیری بر دستور generate ندارد\&. آیتم پیکربندی:
APT::FTPArchive::DB\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
بی‌صدا؛ تولید خروجی مناسب برای ثبت در لاگ (logging)، با حذف نشانگرهای پیشرفت\&. تعداد بیشتر q خروجی را تا حداکثر ۲ ساکت‌تر می‌کند\&. همچنین می‌توانید از
\fB\-q=#\fR
برای تنظیم سطح سکوت استفاده کنید و فایل پیکربندی را نادیده بگیرید\&. آیتم پیکربندی:
quiet\&.
.RE
.PP
\fB\-\-delink\fR
.RS 4
انجام پیوندزدایی (delinking)\&. اگر تنظیم
External\-Links
استفاده شده باشد، این گزینه پیوندزدایی فایل‌ها را فعال می‌کند\&. این گزینه به‌طور پیش‌فرض فعال است و می‌توان آن را با
\fB\-\-no\-delink\fR
غیرفعال کرد\&. آیتم پیکربندی:
APT::FTPArchive::DeLinkAct\&.
.RE
.PP
\fB\-\-contents\fR
.RS 4
انجام تولید محتویات (contents generation)\&. هنگامی که این گزینه تنظیم شده باشد و شاخص‌های بسته با یک DB کش تولید شوند، فهرست فایل‌ها نیز استخراج شده و برای استفاده‌های بعدی در DB ذخیره می‌شود\&. هنگام استفاده از دستور generate، این گزینه همچنین امکان ایجاد هرگونه فایل Contents را فراهم می‌کند\&. مقدار پیش‌فرض روشن است\&. آیتم پیکربندی:
APT::FTPArchive::Contents\&.
.RE
.PP
\fB\-s\fR, \fB\-\-source\-override\fR
.RS 4
انتخاب فایل override سورس برای استفاده با دستور
sources\&.
آیتم پیکربندی:
APT::FTPArchive::SourceOverride\&.
.RE
.PP
\fB\-\-readonly\fR
.RS 4
تنظیم پایگاه‌های داده کش به‌صورت فقط‌خواندنی (read only)\&. آیتم پیکربندی:
APT::FTPArchive::ReadOnlyDB\&.
.RE
.PP
\fB\-a\fR, \fB\-\-arch\fR
.RS 4
پذیرش تنها فایل‌های بسته‌ای که با
*_arch\&.deb
یا
*_all\&.deb
مطابقت دارند در دستورات
packages
و
contents
به‌جای تمام فایل‌های بسته موجود در مسیر داده‌شده\&. آیتم پیکربندی:
APT::FTPArchive::Architecture\&.
.RE
.PP
\fBAPT::FTPArchive::AlwaysStat\fR
.RS 4
\fBapt-ftparchive\fR(1)
تا حد امکان فراداده‌ها را در یک cachedb کش می‌کند\&. اگر بسته‌ها دوباره کامپایل شده و/یا با همان شماره نسخه مجدداً منتشر شوند، این امر منجر به بروز مشکل خواهد شد زیرا از فراداده‌های کش‌شده قدیمی مانند اندازه و چکسام استفاده می‌شود\&. با فعال بودن این گزینه، این اتفاق دیگر رخ نخواهد داد زیرا تغییر فایل بررسی خواهد شد\&. توجه داشته باشید که این گزینه به‌طور پیش‌فرض روی "false" تنظیم شده است زیرا آپلود چندین نسخه/بیلد از یک بسته با یک شماره نسخه توصیه نمی‌شود؛ بنابراین در تئوری هیچ‌کس با این مشکلات روبرو نخواهد شد و از این رو تمام این بررسی‌های اضافی بی‌فایده هستند\&.
.RE
.PP
\fBAPT::FTPArchive::LongDescription\fR
.RS 4
این گزینه پیکربندی به‌طور پیش‌فرض "true" است و تنها در صورتی باید روی
"false"
تنظیم شود که آرشیو تولیدشده با
\fBapt-ftparchive\fR(1)
فایل‌های
Translation
را نیز ارائه دهد\&. توجه داشته باشید که فایل اصلی
Translation\-en
تنها در دستور generate قابل ایجاد است\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش خلاصه کوتاهی از نحوه استفاده\&.
.RE
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
نمایش نسخه برنامه\&.
.RE
.PP
\fB\-\-audit\fR
.RS 4
نمایش پیام‌های حسابرسی (audit) و اعلان (notice)\&. این گزینه بر حالت بی‌صدا (quiet) اولویت دارد، اما فقط برای پیام‌های اعلان، نه پیام‌های پیشرفت\&.
.RE
.PP
\fB\-c\fR, \fB\-\-config\-file\fR
.RS 4
فایل پیکربندی؛ یک فایل پیکربندی را برای استفاده مشخص کنید\&. برنامه فایل پیکربندی پیش‌فرض و سپس این فایل پیکربندی را می‌خواند\&. اگر نیاز است تنظیمات پیکربندی پیش از تجزیه فایل‌های پیکربندی پیش‌فرض اعمال شوند، فایلی را با متغیر محیطی
\fBAPT_CONFIG\fR
مشخص کنید\&. برای اطلاعات مربوط به قواعد نحوی به
\fBapt.conf\fR(5)
مراجعه کنید\&.
.RE
.PP
\fB\-o\fR, \fB\-\-option\fR
.RS 4
تنظیم یک گزینه پیکربندی؛ این کار یک گزینه پیکربندی دلخواه را تنظیم می‌کند\&. ساختار دستوری به‌صورت
\fB\-o Foo::Bar=bar\fR
است\&.
\fB\-o\fR
و
\fB\-\-option\fR
را می‌توان چندین بار برای تنظیم گزینه‌های مختلف به کار برد\&.
.RE
.PP
\fB\-\-cli\-version\fR
.RS 4
درخواست یک نسخه مشخص از CLI\&. این یک الگو است که نسخه را به‌صورت MAJOR\&.MINOR دریافت می‌کند\&. می‌توانید بخش MINOR نسخه را حذف کنید، که در این صورت آخرین سطح فرعی پشتیبانی‌شده استفاده خواهد شد\&.
.sp
مسیرهای نسخه‌گذاری به شرح زیر ارائه می‌شوند: نسخه 3\&.2 دارای نسخه‌های معادل 0\&.32، 1\&.22 و 2\&.12 است که ویژگی‌های جدید را برای نسخه‌های اصلی مشخص‌شده خود پیاده‌سازی می‌کنند\&.
.sp
یک حالت خاص الگوی نسخه X\&.9 است: پس از نسخه‌ای مانند 2\&.9 نسخه 3\&.0 می‌آید، اما 2\&.10 مستقیماً پس از 2\&.8 قرار می‌گیرد؛ با توجه به اینکه ما از شماره نسخه‌های فرد به عنوان سری‌های توسعه استفاده می‌کنیم (2\&.9 سری توسعه 3\&.0 است)\&.
.sp
این قابلیت در APT 3\&.1\&.10 معرفی شده است و جایگزین پیکربندی مختص باینری می‌شود\&. می‌توانید از
\fBAPT::Version\fR
برای اثر مشابه روی باینری‌های قدیمی‌تر استفاده کنید؛ برای مثال، از
\fB\-o APT::Version=2\fR
استفاده کنید تا
\fBapt\fR(8)
مانند سری 2\&.x رفتار کند\&.
.sp
مقدار پیش‌فرض، نسخه فعلی APT برای
\fBapt\fR(8)
و
0\&.(10 * major + minor)
برای دستورات کلاسیک است\&. سری 0\&.X به آرامی منسوخ شده است (soft\-deprecated) و سایر دستورات در آینده به سری 2\&.x منتقل خواهند شد\&.
.RE
.PP
\fB\-\-no\-color\fR, \fB\-\-color\fR
.RS 4
روشن یا خاموش کردن رنگ‌ها\&. رنگ‌ها به‌طور پیش‌فرض در پایانه‌های پشتیبانی‌شده برای
\fBapt\fR(8)
روشن هستند و همچنین می‌توان آن‌ها را با استفاده از متغیرهای محیطی
\fBNO_COLOR\fR
یا
\fBAPT_NO_COLOR\fR
غیرفعال کرد، یا با استفاده از گزینه و حوزه پیکربندی
\fBAPT::Color\fR
بیشتر پیکربندی کرد؛ برای اطلاعات بیشتر به
\fBapt.conf\fR(5)
مراجعه کنید\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای ایجاد یک فایل فشرده Packages برای یک دایرکتوری حاوی بسته‌های باینری (\&.deb):
.sp
.if n \{\
.RS 4
.\}
.nf
\fBapt\-ftparchive\fR packages \fIdirectory\fR | \fBgzip\fR > Packages\&.gz
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBapt.conf\fR(5)
.SH "عیب‌یابی (DIAGNOSTICS)"
.PP
\fBapt\-ftparchive\fR
در عملکرد عادی مقدار صفر و در صورت بروز خطا مقدار ده‌دهی ۱۰۰ را برمی‌گرداند\&.
.SH "اشکالات (BUGS)"
.PP
\m[blue]\fBصفحه باگ‌های APT\fR\m[]\&\s-2\u[1]\d\s+2\&. اگر مایل به گزارش باگ در APT هستید، لطفاً
/usr/share/doc/debian/bug\-reporting\&.txt
یا دستور
\fBreportbug\fR(1)
را ببینید\&.
.SH "نویسندگان (AUTHORS)"
.PP
\fBJason Gunthorpe\fR
.RS 4
.RE
.PP
\fBتیم APT\fR
.RS 4
.RE
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
صفحه باگ‌های APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE