apt-ftparchive - ابزار
تولید
فایلهای
شاخص و
ایندکس
مخزن بسته
apt-ftparchive [-dsq] [--md5]
[--delink] [--readonly] [--contents]
[--arch architecture]
[-o=config_string]
[-c=config_file]
{packages path [override-file [pathprefix]]
|
sources path [override-file [pathprefix]]
| contents path | release path |
generate config_file section... |
clean config_file | {-v | --version} |
{-h | --help}}
apt-ftparchive یک
ابزار خط
فرمان است
که
فایلهای
شاخص مورد
استفاده APT
برای
دسترسی به
یک منبع
توزیع را
تولید
میکند.
فایلهای
شاخص باید
در سایت
مبدأ بر
اساس
محتوای آن
سایت تولید
شوند.
apt-ftparchive یک
ابرمجموعه
از برنامه
dpkg-scanpackages(1) است که
تمام
عملکردهای
آن را از
طریق دستور
packages در بر
میگیرد.
این ابزار
همچنین
شامل یک
تولیدکننده
فایل
محتویات (contents file
generator)، یعنی contents و
ابزاری
کامل برای
«اسکریپتنویسی»
فرایند
تولید برای
یک آرشیو
کامل است.
بهطور
داخلی، apt-ftparchive
میتواند
از
پایگاههای
داده
باینری
برای کش
کردن
محتویات یک
فایل .deb
استفاده
کند و به هیچ
برنامه
خارجی به جز
gzip(1) متکی
نیست. هنگام
اجرای یک
تولید کامل
(full generate)، این
ابزار
بهطور
خودکار
بررسیهای
تغییر فایل
را انجام
داده و
فایلهای
خروجی
فشردهشده
مورد نظر را
میسازد.
مگر اینکه
گزینه -h یا
--help داده شده
باشد، یکی
از دستورات
زیر باید
مشخص شود.
packages
دستور packages
یک فایل
بسته (Package) را از
یک درخت
دایرکتوری
تولید
میکند. این
دستور
دایرکتوری
دادهشده
را دریافت
کرده و آن را
بهصورت
بازگشتی
برای
فایلهای .deb
جستجو
میکند و
برای هر
کدام یک
رکورد بسته
را در stdout
منتشر
میکند. این
دستور
تقریباً
معادل
dpkg-scanpackages(1)
است.
گزینه --db
میتواند
برای مشخص
کردن یک
پایگاهداده
کش باینری
استفاده
شود.
sources
دستور sources
یک فایل
شاخص سورس
را از یک
درخت
دایرکتوری
تولید
میکند. این
دستور
دایرکتوری
دادهشده
را دریافت
کرده و آن را
بهصورت
بازگشتی
برای
فایلهای .dsc
جستجو
میکند و
برای هر
کدام یک
رکورد سورس
را در stdout
منتشر
میکند. این
دستور
تقریباً
معادل
dpkg-scansources(1)
است.
اگر یک
فایل override مشخص
شود، یک
فایل override سورس
با پسوند .src
جستجو
خواهد شد. از
گزینه --source-override
میتوان
برای تغییر
فایل override سورس
مورد
استفاده
بهره برد.
contents
دستور contents
یک فایل
محتویات (Contents)
را از یک
درخت
دایرکتوری
تولید
میکند. این
دستور
دایرکتوری
دادهشده
را دریافت
کرده و آن را
بهصورت
بازگشتی
برای
فایلهای .deb
جستجو
میکند و
فهرست
فایلها را
از هر فایل
میخواند.
سپس فهرست
فایلهای
تطبیقدادهشده
با بستهها
را مرتب
کرده و در stdout
مینویسد.
دایرکتوریها
در خروجی
نوشته
نمیشوند.
اگر چندین
بسته مالک
یک فایل
مشترک
باشند، هر
بسته با یک
کاما در
خروجی جدا
میشود.
گزینه --db
میتواند
برای مشخص
کردن یک
پایگاهداده
کش باینری
استفاده
شود.
release
دستور 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
مینویسد.
مقادیر
فیلدهای
فراداده
اضافی در
فایل 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.
generate
دستور generate
برای اجرا
از طریق یک
اسکریپت cron
طراحی شده
است و
شاخصها را
مطابق با
فایل
پیکربندی
دادهشده
میسازد.
زبان
پیکربندی
روشی
انعطافپذیر
برای تعیین
اینکه چه
فایلهای
شاخصی از
کدام
دایرکتوریها
ساخته شوند
فراهم
میکند، و
همچنین
ابزاری
ساده برای
نگهداری
تنظیمات
مورد نیاز
ارائه
میدهد.
clean
دستور clean
پایگاههای
داده
استفادهشده
توسط فایل
پیکربندی
دادهشده
را با حذف
رکوردهایی
که دیگر
ضروری
نیستند
مرتب و
پاکسازی
میکند.
دستور generate از
یک فایل
پیکربندی
برای توصیف
آرشیوهایی
که قرار است
تولید شوند
استفاده
میکند. این
فایل از
فرمت
استاندارد
پیکربندی ISC
که در
ابزارهای ISC
مانند bind 8 و dhcpd
دیده
میشود
پیروی
میکند. apt.conf(5)
حاوی
توضیحات
مربوط به
قواعد نحوی
آن است. توجه
داشته
باشید که
پیکربندی generate
بهصورت
بخشبندیشده
(sectional) تجزیه
میشود،
اما apt.conf(5)
بهصورت
درختی (tree)
تجزیه
میگردد.
این موضوع
تنها بر
نحوه
مدیریت
برچسب
دامنه (scope tag)
تأثیر
میگذارد.
پیکربندی
generate دارای
چهار بخش
جداگانه
است که هر
کدام در زیر
توضیح داده
شدهاند.
بخش Dir
دایرکتوریهای
استانداردی
را تعریف
میکند که
برای یافتن
فایلهای
مورد نیاز
در طول
فرایند
تولید لازم
هستند. این
دایرکتوریها
به ابتدای
مسیرهای
نسبی خاصی
که در
بخشهای
بعدی تعریف
شدهاند
اضافه
میشوند تا
یک مسیر
مطلق کامل
را ایجاد
کنند.
ArchiveDir
ریشه
آرشیو FTP را
مشخص
میکند؛ در
یک
پیکربندی
استاندارد
دبیان، این
همان
دایرکتوری
حاوی
گرههای ls-LR و dist
است.
OverrideDir
محل
فایلهای override
را مشخص
میکند.
CacheDir
محل
فایلهای
کش را مشخص
میکند.
FileListDir
اگر
تنظیم FileList در
زیر
استفاده
شده باشد،
محل
فایلهای
فهرست فایل
را مشخص
میکند.
بخش Default
مقادیر
پیشفرض و
تنظیماتی
را که
عملکرد
تولیدکننده
را کنترل
میکنند
مشخص
مینماید.
سایر
بخشها
میتوانند
این مقادیر
پیشفرض را
با تنظیمات
خاص هر بخش
بازنویسی (override)
کنند.
Packages::Compress
طرحهای
فشردهسازی
پیشفرض
مورد
استفاده
برای
فایلهای
شاخص بسته
را تعیین
میکند. این
یک رشته
شامل
فهرستی
جداشده با
فاصله از
حداقل یکی
از
فشردهسازهای
پیکربندیشده
از طریق
دامنه
پیکربندی
APT::Compressor است.
مقدار
پیشفرض
برای تمام
طرحهای
فشردهسازی
'. gzip' است.
Packages::Extensions
فهرست
پیشفرض
پسوندهای
فایلی را که
فایل بسته
هستند
تعیین
میکند.
مقدار
پیشفرض آن
'.deb' است.
Sources::Compress
این
گزینه
مشابه Packages::Compress
است با این
تفاوت که
فشردهسازی
فایلهای Sources
را کنترل
میکند.
Sources::Extensions
فهرست
پیشفرض
پسوندهای
فایلی را که
فایل سورس
هستند
تعیین
میکند.
مقدار
پیشفرض آن
'.dsc' است.
Contents::Compress
این
گزینه
مشابه Packages::Compress
است با این
تفاوت که
فشردهسازی
فایلهای Contents
را کنترل
میکند.
Translation::Compress
این
گزینه
مشابه Packages::Compress
است با این
تفاوت که
فشردهسازی
فایل اصلی
Translation-en را کنترل
میکند.
DeLinkLimit
تعداد
کیلوبایتهایی
را که باید
در هر اجرا
پیوندزدایی
(delink) شده (و با
پیوندهای
سخت
جایگزین
شوند) مشخص
میکند. این
گزینه
همراه با
تنظیم
اختصاصی هر
بخش یعنی External-Links
استفاده
میشود.
FileMode
حالت
دسترسی (mode)
تمام
فایلهای
شاخص
ایجادشده
را مشخص
میکند.
مقدار
پیشفرض آن 0644
است. تمام
فایلهای
شاخص بدون
در نظر
گرفتن umask روی
این حالت
تنظیم
میشوند.
LongDescription
مشخص
میکند که
آیا
توضیحات
طولانی
باید در
فایل Packages
گنجانده
شوند یا در
یک فایل
اصلی Translation-en
جداگانه
تفکیک
گردند.
پیشفرضهای
مختص
بخشهای Tree
را تعیین
میکند. همه
این
متغیرها
متغیرهای
جایگزینی
هستند و
رشتههای
$(DIST)، $(SECTION) و $(ARCH) با
مقادیر
متناظر خود
جایگزین
میشوند.
MaxContentsChange
تعداد
کیلوبایت
فایلهای Contents
تولیدشده
در هر روز را
تعیین
میکند.
فایلهای Contents
بهصورت
نوبتی (round-robin)
پردازش
میشوند تا
در طول چند
روز همه
آنها
دوباره
ساخته
شوند.
ContentsAge
تعداد
روزهایی را
که یک فایل Contents
مجاز است
بدون تغییر
بررسی شود
کنترل
میکند. اگر
این حد سپری
شود، mtime فایل
Contents
بهروزرسانی
میشود. این
حالت
میتواند
در صورتی رخ
دهد که فایل
بسته به
گونهای
تغییر کند
که منجر به
ایجاد یک
فایل Contents جدید
نشود [برای
مثال،
ویرایش override].
این مهلت به
امید اینکه
.debهای جدید
نصب شوند و
در هر صورت
به فایل
جدید نیاز
باشد در نظر
گرفته شده
است. مقدار
پیشفرض 10
است و واحد
آن بر حسب
روز
میباشد.
Directory
بالاترین
سطح درخت
دایرکتوری .deb
را تعیین
میکند.
مقدار
پیشفرض آن
$(DIST)/$(SECTION)/binary-$(ARCH)/ است.
SrcDirectory
بالاترین
سطح درخت
دایرکتوری
بستههای
سورس را
تعیین
میکند.
مقدار
پیشفرض آن
$(DIST)/$(SECTION)/source/ است.
Packages
فایل
خروجی Packages را
تعیین
میکند.
مقدار
پیشفرض آن
$(DIST)/$(SECTION)/binary-$(ARCH)/Packages است.
Sources
فایل
خروجی Sources را
تعیین
میکند.
مقدار
پیشفرض آن
$(DIST)/$(SECTION)/source/Sources است.
Translation
فایل
اصلی خروجی
Translation-en حاوی
توضیحات
طولانی را
(در صورتی که
قرار نیست
در فایل Packages
گنجانده
شوند) تعیین
میکند.
مقدار
پیشفرض آن
$(DIST)/$(SECTION)/i18n/Translation-en است.
InternalPrefix
پیشوند
مسیری را
تعیین
میکند که
باعث
میشود یک
پیوند
نمادین (symlink)
بهجای یک
پیوند
خارجی، یک
پیوند
داخلی
محسوب شود.
مقدار
پیشفرض آن
$(DIST)/$(SECTION)/ است.
Contents
فایل
خروجی Contents را
تعیین
میکند.
مقدار
پیشفرض آن
$(DIST)/$(SECTION)/Contents-$(ARCH) است.
اگر این
تنظیم باعث
شود چندین
فایل Packages به یک
فایل Contents واحد
نگاشت شوند
(همانطور
که حالت
پیشفرض
است)،
آنگاه apt-ftparchive
آن
فایلهای
بسته را
بهطور
خودکار با
یکدیگر
ادغام
خواهد کرد.
Contents::Header
فایل
سرآیندی (header file)
را که باید
به ابتدای
خروجی contents
اضافه شود
تعیین
میکند.
BinCacheDB
پایگاهداده
کش باینری
را برای
استفاده در
این بخش
تعیین
میکند.
چندین بخش
میتوانند
از یک
پایگاهداده
مشترک
استفاده
کنند.
FileList
مشخص
میکند که
apt-ftparchive بهجای
پیمایش
درخت
دایرکتوری،
باید فهرست
فایلها را
از فایل
دادهشده
بخواند. نام
فایلهای
نسبی با
دایرکتوری
آرشیو
پیشوندگذاری
میشوند.
SourceFileList
مشخص
میکند که
apt-ftparchive بهجای
پیمایش
درخت
دایرکتوری،
باید فهرست
فایلها را
از فایل
دادهشده
بخواند. نام
فایلهای
نسبی با
دایرکتوری
آرشیو
پیشوندگذاری
میشوند.
این گزینه
هنگام
پردازش
شاخصهای
سورس
استفاده
میشود.
بخش Tree یک
درخت فایل
استاندارد
دبیان را
تعریف
میکند که
شامل یک
دایرکتوری
پایه، سپس
چندین بخش (section)
در آن
دایرکتوری
پایه و در
نهایت
چندین
معماری (Architecture)
در هر بخش
است.
مسیربندی
دقیق مورد
استفاده
توسط متغیر
جایگزینی Directory
تعریف
میشود.
بخش Tree یک
برچسب
دامنه (scope tag)
دریافت
میکند که
متغیر $(DIST) را
تنظیم کرده
و ریشه درخت
را تعریف
مینماید
(مسیر با ArchiveDir
پیشوند
میگیرد).
معمولاً
این تنظیمی
مانند dists/trixie
است.
تمام
تنظیمات
تعریفشده
در بخش TreeDefault را
میتوان در
یک بخش Tree به
همراه سه
متغیر جدید
استفاده
کرد.
هنگام
پردازش یک
بخش Tree ، apt-ftparchive
عملیاتی
شبیه به این
را انجام
میدهد:
for i in Sections do
for j in Architectures do
Generate for DIST=scope SECTION=i ARCH=j
Sections
فهرستی
جداشده با
فاصله از
بخشهایی
است که در
زیر توزیع
ظاهر
میشوند؛
معمولاً
چیزی شبیه
به main contrib non-free non-free-firmware
است.
Architectures
فهرستی
جداشده با
فاصله از
تمام
معماریهایی
است که در
زیر بخش
جستجو ظاهر
میشوند.
معماری
ویژه 'source' برای
نشان دادن
اینکه این
درخت دارای
یک آرشیو
سورس است
استفاده
میشود.
معماری 'all'
نشان
میدهد که
فایلهای
مختص
معماری
مانند Packages
نباید
اطلاعات
مربوط به
بستههای
معماری all را
در همه
فایلها
بگنجانند،
زیرا آنها
در یک فایل
اختصاصی در
دسترس
خواهند
بود.
LongDescription
مشخص
میکند که
آیا
توضیحات
طولانی
باید در
فایل Packages
گنجانده
شوند یا در
یک فایل
اصلی Translation-en
تفکیک
گردند.
BinOverride
فایل override
باینری را
تعیین
میکند.
فایل override حاوی
اطلاعات
بخش،
اولویت و
آدرس
نگهدارنده
است.
SrcOverride
فایل override
سورس را
تعیین
میکند.
فایل override حاوی
اطلاعات
بخش است.
ExtraOverride
فایل extra override
باینری را
تعیین
میکند.
SrcExtraOverride
فایل extra override
سورس را
تعیین
میکند.
بخش bindirectory یک
درخت
دایرکتوری
باینری
بدون
ساختار
ویژه را
تعریف
میکند.
برچسب
دامنه (scope tag)
محل
دایرکتوری
باینری را
مشخص
میکند و
تنظیمات آن
مشابه بخش Tree
است بدون
هیچگونه
متغیرهای
جایگزینی
یا تنظیمات
SectionArchitecture.
Packages
خروجی
فایل Packages را
تعیین
میکند.
Sources
خروجی
فایل Sources را
تعیین
میکند.
حداقل یکی
از Packages یا Sources
الزامی
است.
Contents
خروجی
فایل Contents را
تعیین
میکند
(اختیاری).
BinOverride
فایل override
باینری را
تعیین
میکند.
SrcOverride
فایل override
سورس را
تعیین
میکند.
ExtraOverride
فایل extra override
باینری را
تعیین
میکند.
SrcExtraOverride
فایل extra override
سورس را
تعیین
میکند.
BinCacheDB
پایگاهداده
کش را تعیین
میکند.
PathPrefix
مسیری را
به تمام
مسیرهای
خروجی
الحاق
میکند.
FileList, SourceFileList
فایل
فهرست فایل
را مشخص
میکند.
فایل override
باینری
کاملاً با
dpkg-scanpackages(1) سازگار
است. این
فایل شامل
چهار فیلد
است که با
فاصله از هم
جدا
شدهاند.
فیلد اول
نام بسته،
فیلد دوم
اولویتی که
باید به آن
بسته تحمیل
شود، فیلد
سوم بخشی که
باید به آن
بسته تحمیل
شود و فیلد
نهایی فیلد
جایگشت
نگهدارنده
(maintainer permutation) است.
شکل کلی
فیلد
نگهدارنده
به این صورت
است:
یا به
سادگی:
شکل اول
امکان مشخص
کردن
فهرستی از
آدرسهای
ایمیل
قدیمی
جداشده با
اسلش
دوگانه (//) را
فراهم
میکند. اگر
هر یک از
آنها یافت
شود، new
جایگزین
فیلد
نگهدارنده
میشود. شکل
دوم بدون
قید و شرط
فیلد
نگهدارنده
را جایگزین
میکند.
فایل override
سورس
کاملاً با
dpkg-scansources(1) سازگار
است. این
فایل شامل
دو فیلد است
که با فاصله
از هم جدا
شدهاند.
فیلد اول
نام بسته
سورس و فیلد
دوم بخشی
است که باید
به آن
اختصاص
یابد.
فایل extra override
امکان
افزودن یا
جایگزینی
هر تگ
دلخواه را
در خروجی
فراهم
میکند. این
فایل دارای
سه ستون است:
ستون اول
نام بسته،
ستون دوم تگ
و بقیه خط
مقدار جدید
است.
تمام
گزینههای
خط فرمان را
میتوان با
استفاده از
فایل
پیکربندی
تنظیم کرد؛
توضیحات،
گزینه
پیکربندی
مربوطه را
برای تنظیم
نشان
میدهند.
برای
گزینههای
بولی
میتوانید
فایل
پیکربندی
را با
مواردی
مانند
-f-،--no-f، -f=no یا
چندین حالت
دیگر
بازنویسی (override)
کنید.
--md5, --sha1, --sha256, --sha512
تولید
چکسام
دادهشده.
این
گزینهها
بهطور
پیشفرض
روشن
هستند؛ در
صورت خاموش
بودن،
فایلهای
شاخص
تولیدشده
در صورت
امکان فاقد
فیلدهای
چکسام
خواهند بود.
آیتمهای
پیکربندی:
APT::FTPArchive::Checksum و
APT::FTPArchive::Index::Checksum که
در آن Index
میتواند Packages,
Sources یا Release باشد و
Checksum
میتواند MD5, SHA1,
SHA256 یا SHA512 باشد.
-d, --db
استفاده
از یک
پایگاهداده
کش باینری.
این گزینه
تاثیری بر
دستور generate
ندارد. آیتم
پیکربندی:
APT::FTPArchive::DB.
-q, --quiet
بیصدا؛
تولید
خروجی
مناسب برای
ثبت در لاگ
(logging)، با حذف
نشانگرهای
پیشرفت.
تعداد
بیشتر q
خروجی را تا
حداکثر ۲
ساکتتر
میکند.
همچنین
میتوانید
از -q=# برای
تنظیم سطح
سکوت
استفاده
کنید و فایل
پیکربندی
را نادیده
بگیرید.
آیتم
پیکربندی: quiet.
--delink
انجام
پیوندزدایی
(delinking). اگر تنظیم
External-Links استفاده
شده باشد،
این گزینه
پیوندزدایی
فایلها را
فعال
میکند. این
گزینه
بهطور
پیشفرض
فعال است و
میتوان آن
را با --no-delink
غیرفعال
کرد. آیتم
پیکربندی:
APT::FTPArchive::DeLinkAct.
--contents
انجام
تولید
محتویات (contents
generation). هنگامی که
این گزینه
تنظیم شده
باشد و
شاخصهای
بسته با یک DB
کش تولید
شوند،
فهرست
فایلها
نیز
استخراج
شده و برای
استفادههای
بعدی در DB
ذخیره
میشود.
هنگام
استفاده از
دستور generate،
این گزینه
همچنین
امکان
ایجاد
هرگونه
فایل Contents را
فراهم
میکند.
مقدار
پیشفرض
روشن است.
آیتم
پیکربندی:
APT::FTPArchive::Contents.
-s, --source-override
انتخاب
فایل override سورس
برای
استفاده با
دستور sources.
آیتم
پیکربندی:
APT::FTPArchive::SourceOverride.
--readonly
تنظیم
پایگاههای
داده کش
بهصورت
فقطخواندنی
(read only). آیتم
پیکربندی:
APT::FTPArchive::ReadOnlyDB.
-a, --arch
پذیرش
تنها
فایلهای
بستهای که
با *_arch.deb یا *_all.deb
مطابقت
دارند در
دستورات packages و
contents بهجای
تمام
فایلهای
بسته موجود
در مسیر
دادهشده.
آیتم
پیکربندی:
APT::FTPArchive::Architecture.
APT::FTPArchive::AlwaysStat
apt-ftparchive(1) تا
حد امکان
فرادادهها
را در یک cachedb کش
میکند. اگر
بستهها
دوباره
کامپایل
شده و/یا با
همان شماره
نسخه
مجدداً
منتشر
شوند، این
امر منجر به
بروز مشکل
خواهد شد
زیرا از
فرادادههای
کششده
قدیمی
مانند
اندازه و
چکسام
استفاده
میشود. با
فعال بودن
این گزینه،
این اتفاق
دیگر رخ
نخواهد داد
زیرا تغییر
فایل بررسی
خواهد شد.
توجه داشته
باشید که
این گزینه
بهطور
پیشفرض
روی "false"
تنظیم شده
است زیرا
آپلود
چندین
نسخه/بیلد
از یک بسته
با یک شماره
نسخه توصیه
نمیشود؛
بنابراین
در تئوری
هیچکس با
این مشکلات
روبرو
نخواهد شد و
از این رو
تمام این
بررسیهای
اضافی
بیفایده
هستند.
APT::FTPArchive::LongDescription
این
گزینه
پیکربندی
بهطور
پیشفرض "true"
است و تنها
در صورتی
باید روی "false"
تنظیم شود
که آرشیو
تولیدشده
با
apt-ftparchive(1)
فایلهای Translation
را نیز
ارائه دهد.
توجه داشته
باشید که
فایل اصلی
Translation-en تنها در
دستور generate
قابل ایجاد
است.
-h, --help
نمایش
خلاصه
کوتاهی از
نحوه
استفاده.
-v, --version
نمایش
نسخه
برنامه.
--audit
نمایش
پیامهای
حسابرسی (audit) و
اعلان (notice). این
گزینه بر
حالت
بیصدا (quiet)
اولویت
دارد، اما
فقط برای
پیامهای
اعلان، نه
پیامهای
پیشرفت.
-c, --config-file
فایل
پیکربندی؛
یک فایل
پیکربندی
را برای
استفاده
مشخص کنید.
برنامه
فایل
پیکربندی
پیشفرض و
سپس این
فایل
پیکربندی
را
میخواند.
اگر نیاز
است
تنظیمات
پیکربندی
پیش از
تجزیه
فایلهای
پیکربندی
پیشفرض
اعمال
شوند،
فایلی را با
متغیر
محیطی
APT_CONFIG
مشخص کنید.
برای
اطلاعات
مربوط به
قواعد نحوی
به
apt.conf(5)
مراجعه
کنید.
-o, --option
تنظیم یک
گزینه
پیکربندی؛
این کار یک
گزینه
پیکربندی
دلخواه را
تنظیم
میکند.
ساختار
دستوری
بهصورت -o
Foo::Bar=bar است. -o و --option
را میتوان
چندین بار
برای تنظیم
گزینههای
مختلف به
کار برد.
--cli-version
درخواست
یک نسخه
مشخص از CLI.
این یک الگو
است که نسخه
را بهصورت
MAJOR.MINOR دریافت
میکند.
میتوانید
بخش MINOR نسخه
را حذف
کنید، که در
این صورت
آخرین سطح
فرعی
پشتیبانیشده
استفاده
خواهد شد.
مسیرهای
نسخهگذاری
به شرح زیر
ارائه
میشوند:
نسخه 3.2
دارای
نسخههای
معادل 0.32، 1.22 و 2.12
است که
ویژگیهای
جدید را
برای
نسخههای
اصلی
مشخصشده
خود
پیادهسازی
میکنند.
یک حالت
خاص الگوی
نسخه X.9 است:
پس از
نسخهای
مانند 2.9
نسخه 3.0
میآید،
اما 2.10
مستقیماً
پس از 2.8 قرار
میگیرد؛
با توجه به
اینکه ما از
شماره
نسخههای
فرد به
عنوان
سریهای
توسعه
استفاده
میکنیم (2.9
سری توسعه 3.0
است).
این
قابلیت در APT 3.1.10
معرفی شده
است و
جایگزین
پیکربندی
مختص
باینری
میشود.
میتوانید
از APT::Version برای
اثر مشابه
روی
باینریهای
قدیمیتر
استفاده
کنید؛ برای
مثال، از -o
APT::Version=2 استفاده
کنید تا apt(8)
مانند سری 2.x
رفتار کند.
مقدار
پیشفرض،
نسخه فعلی APT
برای apt(8) و 0.(10 * major +
minor) برای
دستورات
کلاسیک است.
سری 0.X به
آرامی
منسوخ شده
است (soft-deprecated) و
سایر
دستورات در
آینده به
سری 2.x منتقل
خواهند شد.
--no-color, --color
روشن یا
خاموش کردن
رنگها.
رنگها
بهطور
پیشفرض در
پایانههای
پشتیبانیشده
برای
apt(8)
روشن هستند
و همچنین
میتوان
آنها را با
استفاده از
متغیرهای
محیطی
NO_COLOR یا
APT_NO_COLOR غیرفعال
کرد، یا با
استفاده از
گزینه و
حوزه
پیکربندی
APT::Color بیشتر
پیکربندی
کرد؛ برای
اطلاعات
بیشتر به
apt.conf(5)
مراجعه
کنید.
برای
ایجاد یک
فایل فشرده
Packages برای یک
دایرکتوری
حاوی
بستههای
باینری (.deb):
apt-ftparchive packages directory | gzip > Packages.gz
apt-ftparchive در
عملکرد
عادی مقدار
صفر و در
صورت بروز
خطا مقدار
دهدهی ۱۰۰
را
برمیگرداند.
صفحه
باگهای APT[1].
اگر مایل به
گزارش باگ
در APT هستید،
لطفاً
/usr/share/doc/debian/bug-reporting.txt یا
دستور reportbug(1)
را ببینید.
