'\" t
.\"     Title: apt-cache
.\"    Author: Jason Gunthorpe
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 14\ \&March\ \&2024
.\"    Manual: APT
.\"    Source: APT 3.3.3
.\"  Language: Persian
.\"
.TH "APT\-CACHE" "8" "14\ \&March\ \&2024" "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-cache \- پرس‌وجو و جستجو در حافظه پنهان APT
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBapt\-cache\fR\ 'u
\fBapt\-cache\fR [\fB\-agipns\fR] [\fB\-o=\fR\fB\fIconfig_string\fR\fR] [\fB\-c=\fR\fB\fIconfig_file\fR\fR] {gencaches | showpkg\ \fIpkg\fR...  | showsrc\ \fIpkg\fR...  | stats | dump | dumpavail | unmet | search\ \fIregex\fR...  | show\ \fIpkg\fR\ [{=\fIpkg_version_number\fR\ |\ /\fItarget_release\fR}]...  | depends\ \fIpkg\fR\ [{=\fIpkg_version_number\fR\ |\ /\fItarget_release\fR}]...  | rdepends\ \fIpkg\fR\ [{=\fIpkg_version_number\fR\ |\ /\fItarget_release\fR}]...  | pkgnames\ [\fIprefix\fR]  | dotty\ \fIpkg\fR\ [{=\fIpkg_version_number\fR\ |\ /\fItarget_release\fR}]...  | xvcg\ \fIpkg\fR\ [{=\fIpkg_version_number\fR\ |\ /\fItarget_release\fR}]...  | policy\ [\fIpkg\fR...]  | madison\ \fIpkg\fR...  | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help}}
.SH "توضیحات (DESCRIPTION)"
.PP
\fBapt\-cache\fR
عملیات گوناگونی را روی حافظه پنهان بسته‌های APT انجام می‌دهد\&.
\fBapt\-cache\fR
وضعیت سیستم را تغییر نمی‌دهد، اما عملیاتی را برای جستجو و تولید خروجی‌های کاربردی از فراداده‌های بسته‌ها فراهم می‌کند\&. این فراداده‌ها از طریق دستور «update» به عنوان مثال توسط
\fBapt\-get\fR
دریافت و به‌روزرسانی می‌شوند، بنابراین اگر از آخرین به‌روزرسانی مدت زیادی گذشته باشد ممکن است قدیمی باشند، اما در عوض
\fBapt\-cache\fR
مستقل از در دسترس بودن مخازن پیکربندی‌شده (مثلاً در حالت آفلاین) کار می‌کند\&.
.PP
مگر اینکه گزینه
\fB\-h\fR
یا
\fB\-\-help\fR
مشخص شده باشد، یکی از دستورهای زیر باید داده شود\&.
.PP
\fBgencaches\fR
.RS 4
دستور
gencaches
حافظه پنهان بسته‌های APT را ایجاد می‌کند\&. این کار در صورت مفقود بودن یا قدیمی بودن حافظه پنهان، به صورت ضمنی توسط تمام دستوراتی که به این حافظه پنهان نیاز دارند انجام می‌شود\&.
.RE
.PP
\fBshowpkg\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
دستور
showpkg
اطلاعات مربوط به بسته‌های ذکرشده در خط فرمان را نمایش می‌دهد\&. آرگومان‌های باقی‌مانده نام بسته‌ها هستند\&. نسخه‌های موجود و وابستگی‌های معکوس هر بسته ذکرشده، و همچنین وابستگی‌های مستقیم برای هر نسخه فهرست می‌شوند\&. وابستگی‌های مستقیم (معمولی) بسته‌هایی هستند که بسته مورد نظر به آن‌ها وابسته است؛ وابستگی‌های معکوس بسته‌هایی هستند که به بسته مورد نظر وابسته هستند\&. بنابراین، وابستگی‌های مستقیم باید برای یک بسته برآورده شوند، اما نیازی به برآورده شدن وابستگی‌های معکوس نیست\&. برای نمونه،
\fBapt\-cache showpkg libreadline2\fR
خروجی مشابه زیر تولید می‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
Package: libreadline2
Versions: 2\&.1\-12(/var/state/apt/lists/foo_Packages),
Reverse Depends:
  libreadlineg2,libreadline2
  libreadline2\-altdev,libreadline2
Dependencies:
2\&.1\-12 \- libc5 (2 5\&.4\&.0\-0) ncurses3\&.0 (0 (null))
Provides:
2\&.1\-12 \-
Reverse Provides:
.fi
.if n \{\
.RE
.\}
بدین ترتیب می‌توان مشاهده کرد که بسته libreadline2، نسخه 2\&.1\-12، به libc5 و ncurses3\&.0 وابسته است که برای کارکرد libreadline2 باید نصب شده باشند\&. به نوبه خود، libreadlineg2 و libreadline2\-altdev به libreadline2 وابسته هستند\&. اگر libreadline2 نصب باشد، libc5 و ncurses3\&.0 (و ldso) نیز باید نصب باشند؛ اما نیازی به نصب libreadlineg2 و libreadline2\-altdev نیست\&. برای درک معنای دقیق بخش‌های باقی‌مانده خروجی، بهتر است به کد منبع apt مراجعه کنید\&.
.RE
.PP
\fBstats\fR
.RS 4
دستور
stats
برخی آمارها را درباره حافظه پنهان نمایش می‌دهد\&. هیچ آرگومان دیگری انتظار نمی‌رود\&. آمارهای ارائه‌شده عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تعداد کل نام‌های بسته (Total package names)
تعداد نام بسته‌های موجود در حافظه پنهان است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بسته‌های عادی (Normal packages)
تعداد نام‌های بسته‌های عادی و معمولی است؛ این‌ها بسته‌هایی هستند که تطابق یک‌به‌یک میان نام آن‌ها و نامی که سایر بسته‌ها برای وابستگی‌های خود استفاده می‌کنند وجود دارد\&. اکثر بسته‌ها در این دسته قرار می‌گیرند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بسته‌های کاملاً مجازی (Pure virtual packages)
تعداد بسته‌هایی است که فقط به عنوان یک نام بسته مجازی وجود دارند؛ یعنی بسته‌ها صرفاً نام بسته مجازی را «ارائه» (provide) می‌دهند و هیچ بسته‌ای واقعاً از این نام به عنوان نام واقعی خود استفاده نمی‌کند\&. برای مثال، در سیستم دبیان «mail\-transport\-agent» یک بسته کاملاً مجازی است؛ چندین بسته «mail\-transport\-agent» را ارائه می‌دهند، اما هیچ بسته‌ای با نام واقعی «mail\-transport\-agent» وجود ندارد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بسته‌های مجازی منفرد (Single virtual packages)
تعداد بسته‌های مجازی است که تنها یک بسته آن بسته مجازی خاص را ارائه می‌دهد\&. برای نمونه، در سیستم دبیان، «X11\-text\-viewer» یک بسته مجازی است، اما تنها یک بسته، یعنی xless، بسته «X11\-text\-viewer» را ارائه می‌دهد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بسته‌های مجازی ترکیبی (Mixed virtual packages)
تعداد بسته‌هایی است که یا یک بسته مجازی خاص را ارائه می‌دهند یا نام بسته مجازی را به عنوان نام اصلی بسته خود دارند\&. برای نمونه، در سیستم دبیان «debconf» هم یک بسته واقعی است و هم توسط بسته debconf\-tiny ارائه می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
مفقود (Missing)
تعداد نام‌های بسته‌ای است که در یک وابستگی به آن‌ها ارجاع داده شده اما توسط هیچ بسته‌ای ارائه نشده‌اند\&. بسته‌های مفقود ممکن است زمانی ظاهر شوند که به توزیع کامل دسترسی وجود ندارد، یا زمانی که یک بسته (واقعی یا مجازی) از توزیع حذف شده باشد\&. معمولاً از عبارات Conflicts یا Breaks به آن‌ها ارجاع داده می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تعداد کل نسخه‌های متمایز (Total distinct versions)
تعداد نسخه‌های بسته موجود در حافظه پنهان است\&. اگر به بیش از یک توزیع دسترسی وجود داشته باشد (برای مثال stable و unstable)، این مقدار می‌تواند به طور قابل توجهی بیشتر از تعداد کل نام‌های بسته باشد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تعداد کل وابستگی‌ها (Total dependencies)
تعداد روابط وابستگی است که توسط تمام بسته‌های موجود در حافظه پنهان درخواست شده است\&.
.RE
.sp
.RE
.PP
\fBshowsrc\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
دستور
showsrc
تمامی رکوردهای بسته سورس (منبع) را که با نام‌های بسته داده‌شده مطابقت دارند نمایش می‌دهد\&. تمام نسخه‌ها و همچنین تمام رکوردهایی که اعلام می‌کنند این نام یک بسته دوتایی (باینری) است نمایش داده می‌شوند\&. از گزینه
\fB\-\-only\-source\fR
برای نمایش صرفاً نام بسته‌های سورس استفاده کنید\&.
.RE
.PP
\fBdump\fR
.RS 4
دستور
dump
فهرستی کوتاه از تمامی بسته‌های موجود در حافظه پنهان را نمایش می‌دهد\&. این دستور عمدتاً برای اشکال‌زدایی کاربرد دارد\&.
.RE
.PP
\fBdumpavail\fR
.RS 4
دستور
dumpavail
فهرستی از بسته‌های موجود را در خروجی استاندارد چاپ می‌کند\&. این خروجی برای استفاده همراه با
\fBdpkg\fR(1)
مناسب بوده و توسط روش
\fBdselect\fR(1)
به کار می‌رود\&.
.RE
.PP
\fBunmet\fR
.RS 4
دستور
unmet
خلاصه‌ای از تمامی وابستگی‌های برآورده‌نشده در حافظه پنهان بسته‌ها را نمایش می‌دهد\&.
.RE
.PP
\fBshow\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
دستور
show
عملیاتی مشابه
\fBdpkg \-\-print\-avail\fR
انجام می‌دهد؛ این دستور رکوردهای بسته را برای بسته‌های نام‌برده نمایش می‌دهد\&.
.RE
.PP
\fBsearch\fR \fB\fIregex\fR\fR\fB\&...\fR
.RS 4
دستور
search
یک جستجوی متنی کامل در تمام فهرست‌های بسته‌های موجود برای الگوی عبارت باقاعده POSIX داده‌شده انجام می‌دهد؛ به
\fBregex\fR(7)
مراجعه کنید\&. این دستور نام‌ها و توضیحات بسته‌ها را برای یافتن موارد منطبق با عبارت باقاعده جستجو می‌کند و نام بسته به همراه توضیحات کوتاه آن، شامل نام‌های بسته‌های مجازی را چاپ می‌کند\&. اگر گزینه
\fB\-\-full\fR
مشخص شده باشد، خروجی همانند خروجی دستور
show
برای هر بسته منطبق تولید می‌شود؛ و اگر گزینه
\fB\-\-names\-only\fR
مشخص شده باشد، توضیحات طولانی جستجو نمی‌شوند و فقط نام بسته و بسته‌های ارائه‌شده جستجو می‌گردند\&.
.sp
می‌توان از آرگومان‌های مجزا برای مشخص کردن چندین الگوی جستجو استفاده کرد که با یکدیگر عطف منطقی (AND) می‌شوند\&.
.RE
.PP
\fBdepends\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
دستور
depends
فهرستی از تمام وابستگی‌های یک بسته و تمام بسته‌های احتمالی دیگر که می‌توانند آن وابستگی را برآورده کنند نمایش می‌دهد\&.
.RE
.PP
\fBrdepends\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
دستور
rdepends
فهرستی از تمام وابستگی‌های معکوس یک بسته را نمایش می‌دهد\&.
.RE
.PP
\fBpkgnames\fR [\fIprefix\fR]
.RS 4
این دستور نام تمام بسته‌هایی را که APT می‌شناسد چاپ می‌کند\&. آرگومان اختیاری یک پیشوند برای فیلتر کردن فهرست نام‌ها است\&. خروجی برای استفاده در قابلیت تکمیل با کلید Tab در پوسته مناسب است و بسیار سریع تولید می‌شود\&. این دستور بهتر است همراه با گزینه
\fB\-\-generate\fR
استفاده شود\&.
.sp
توجه داشته باشید که بسته‌ای که APT آن را می‌شناسد لزوماً برای بارگیری در دسترس، قابل نصب یا نصب‌شده نیست؛ برای مثال بسته‌های مجازی نیز در فهرست تولیدشده قرار می‌گیرند\&.
.RE
.PP
\fBdotty\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
دستور
dotty
فهرستی از بسته‌ها را در خط فرمان دریافت کرده و خروجی مناسبی برای استفاده توسط dotty از بسته
\m[blue]\fBGraphViz\fR\m[]\&\s-2\u[1]\d\s+2
تولید می‌کند\&. نتیجه مجموعه‌ای از گره‌ها و یال‌ها خواهد بود که روابط بین بسته‌ها را نشان می‌دهند\&. به صورت پیش‌فرض، بسته‌های داده‌شده تمام بسته‌های وابسته را ردیابی می‌کنند؛ این امر می‌تواند منجر به یک نمودار بسیار بزرگ شود\&. برای محدود کردن خروجی تنها به بسته‌هایی که در خط فرمان وارد شده‌اند، گزینه
APT::Cache::GivenOnly
را تنظیم کنید\&.
.sp
گره‌های حاصل دارای چندین شکل هستند: بسته‌های عادی به شکل جعبه، بسته‌های کاملاً مجازی به شکل مثلث، بسته‌های مجازی ترکیبی به شکل لوزی و بسته‌های مفقود به شکل شش‌ضلعی هستند\&. جعبه‌های نارنجی به معنای متوقف شدن بازگشت هستند (بسته‌های برگ)، خطوط آبی نشان‌دهنده پیش‌وابستگی‌ها (Pre\-Depends) و خطوط سبز نشان‌دهنده تداخل‌ها (Conflicts) هستند\&.
.sp
توجه: dotty نمی‌تواند مجموعه‌های بزرگ‌تر بسته‌ها را به تصویر بکشد\&.
.RE
.PP
\fBxvcg\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
مشابه
dotty،
اما برای xvcg از
\m[blue]\fBابزار VCG\fR\m[]\&\s-2\u[2]\d\s+2\&.
.RE
.PP
\fBpolicy\fR [\fIpkg\fR\&...]
.RS 4
دستور
policy
برای کمک به اشکال‌زدایی مسائل مربوط به فایل ترجیحات (preferences) در نظر گرفته شده است\&. بدون آرگومان، اولویت‌های هر منبع را چاپ می‌کند\&. در غیر این صورت، اطلاعات مفصلی درباره اولویت انتخاب بسته‌های نام‌برده چاپ می‌کند\&.
.RE
.PP
\fBmadison\fR \fB\fIpkg\fR\fR\fB\&...\fR
.RS 4
دستور
madison
در
apt\-cache
تلاش می‌کند تا فرمت خروجی و زیرمجموعه‌ای از قابلیت‌های ابزار مدیریت آرشیو دبیان، یعنی
madison
را شبیه‌سازی کند\&. این دستور نسخه‌های موجود یک بسته را در قالب یک جدول نمایش می‌دهد\&. بر خلاف
madison
اصلی، این دستور فقط می‌تواند اطلاعات معماری‌ای را نمایش دهد که APT فهرست بسته‌های آن را دریافت کرده است (APT::Architecture)\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
تمام گزینه‌های خط فرمان را می‌توان با استفاده از فایل پیکربندی تنظیم کرد؛ توضیحات، گزینه پیکربندی مربوطه را مشخص می‌کنند\&. برای گزینه‌های بولی (منطقی)، می‌توانید تنظیمات فایل پیکربندی را با استفاده از مواردی مانند
\fB\-f\-\fR،
\fB\-\-no\-f\fR،
\fB\-f=no\fR
یا چندین شکل مختلف دیگر لغو کنید\&.
.PP
\fB\-p\fR, \fB\-\-pkg\-cache\fR
.RS 4
فایل مورد نظر برای ذخیره حافظه پنهان بسته‌ها را انتخاب می‌کند\&. حافظه پنهان بسته‌ها، حافظه پنهان اصلی است که توسط تمام عملیات استفاده می‌شود\&. مولفه پیکربندی:
Dir::Cache::pkgcache\&.
.RE
.PP
\fB\-s\fR, \fB\-\-src\-cache\fR
.RS 4
فایل مورد نظر برای ذخیره حافظه پنهان منابع (سورس) را انتخاب می‌کند\&. این منبع فقط توسط
gencaches
استفاده می‌شود و نسخه‌ای تجزیه‌شده از اطلاعات بسته را از منابع راه دور ذخیره می‌کند\&. هنگام ساخت حافظه پنهان بسته‌ها، از حافظه پنهان منابع برای جلوگیری از تجزیه مجدد تمامی فایل‌های بسته استفاده می‌شود\&. مولفه پیکربندی:
Dir::Cache::srcpkgcache\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
حالت بی‌صدا؛ خروجی مناسب برای ثبت در گزارش را با حذف نشانگرهای پیشرفت تولید می‌کند\&. تعداد بیشتر حرف q خروجی را بی‌صداتر می‌کند (حداکثر تا ۲)\&. همچنین می‌توانید از
\fB\-q=#\fR
برای تعیین سطح بی‌صدا بودن استفاده کنید که تنظیمات فایل پیکربندی را لغو می‌کند\&. مولفه پیکربندی:
quiet\&.
.RE
.PP
\fB\-i\fR, \fB\-\-important\fR
.RS 4
فقط وابستگی‌های مهم را چاپ می‌کند؛ برای استفاده همراه با
unmet
و
depends\&.
باعث می‌شود فقط روابط Depends و Pre\-Depends چاپ شوند\&. مولفه پیکربندی:
APT::Cache::Important\&.
.RE
.PP
\fB\-\-no\-pre\-depends\fR, \fB\-\-no\-depends\fR, \fB\-\-no\-recommends\fR, \fB\-\-no\-suggests\fR, \fB\-\-no\-conflicts\fR, \fB\-\-no\-breaks\fR, \fB\-\-no\-replaces\fR, \fB\-\-no\-enhances\fR
.RS 4
به صورت پیش‌فرض دستورات
\fBdepends\fR
و
\fBrdepends\fR
تمامی وابستگی‌ها را چاپ می‌کنند\&. این رفتار را می‌توان با این گزینه‌ها که نوع وابستگی مشخص‌شده را نادیده می‌گیرند، تغییر داد\&. مولفه پیکربندی:
APT::Cache::Show\fIDependencyType\fR
به عنوان مثال:
APT::Cache::ShowRecommends\&.
.RE
.PP
\fB\-\-implicit\fR
.RS 4
به طور پیش‌فرض
\fBdepends\fR
و
\fBrdepends\fR
تنها وابستگی‌هایی را چاپ می‌کنند که به صراحت در فراداده‌ها قید شده‌اند\&. با این گزینه، وابستگی‌هایی که به صورت ضمنی و بر اساس داده‌های دیده‌شده اضافه می‌شوند نیز نمایش داده خواهند شد\&. برای نمونه عبارت
Conflicts: foo
به صورت ضمنی بیان می‌کند که این بسته با بسته «foo» از هر معماری دیگری نیز تداخل دارد\&. مولفه پیکربندی:
APT::Cache::ShowImplicit\&.
.RE
.PP
\fB\-f\fR, \fB\-\-full\fR
.RS 4
رکوردهای کامل بسته را هنگام جستجو چاپ می‌کند\&. مولفه پیکربندی:
APT::Cache::ShowFull\&.
.RE
.PP
\fB\-a\fR, \fB\-\-all\-versions\fR
.RS 4
رکوردهای کامل را برای تمام نسخه‌های موجود چاپ می‌کند\&. این حالت پیش‌فرض است؛ برای غیرفعال کردن آن از
\fB\-\-no\-all\-versions\fR
استفاده کنید\&. اگر
\fB\-\-no\-all\-versions\fR
مشخص شود، تنها نسخه کاندید (نسخه‌ای که برای نصب انتخاب خواهد شد) نمایش داده می‌شود\&. این گزینه فقط برای دستور
show
کاربرد دارد\&. مولفه پیکربندی:
APT::Cache::AllVersions\&.
.RE
.PP
\fB\-g\fR, \fB\-\-generate\fR
.RS 4
بازسازی خودکار حافظه پنهان بسته‌ها را انجام می‌دهد، به جای استفاده از حافظه پنهان به همان صورتی که هست\&. این حالت پیش‌فرض است؛ برای خاموش کردن آن، از
\fB\-\-no\-generate\fR
استفاده کنید\&. مولفه پیکربندی:
APT::Cache::Generate\&.
.RE
.PP
\fB\-\-names\-only\fR, \fB\-n\fR
.RS 4
تنها نام بسته و نام بسته‌های ارائه‌شده را جستجو می‌کند، نه توضیحات طولانی را\&. مولفه پیکربندی:
APT::Cache::NamesOnly\&.
.RE
.PP
\fB\-\-all\-names\fR
.RS 4
باعث می‌شود
pkgnames
تمام نام‌ها، از جمله بسته‌های مجازی و وابستگی‌های مفقود را چاپ کند\&. مولفه پیکربندی:
APT::Cache::AllNames\&.
.RE
.PP
\fB\-\-recurse\fR
.RS 4
دستورات
depends
و
rdepends
را بازگشتی می‌کند تا تمامی بسته‌های ذکرشده یک بار چاپ شوند\&. مولفه پیکربندی:
APT::Cache::RecurseDepends\&.
.RE
.PP
\fB\-\-installed\fR
.RS 4
خروجی دستورات
depends
و
rdepends
را به بسته‌هایی که در حال حاضر نصب هستند محدود می‌کند\&. مولفه پیکربندی:
APT::Cache::Installed\&.
.RE
.PP
\fB\-\-with\-source\fR \fB\fIfilename\fR\fR
.RS 4
فایل داده‌شده را به عنوان یک منبع برای فراداده‌ها اضافه می‌کند\&. این گزینه را می‌توان برای افزودن چندین فایل تکرار کرد\&. موارد پشتیبانی‌شده فعلی عبارتند از فایل‌های
*\&.deb،
*\&.dsc،
*\&.changes،
Sources
و
Packages
و همچنین دایرکتوری‌های بسته سورس\&. تطابق فایل‌ها صرفاً بر اساس نام فایل است، نه محتوای آن‌ها!
.sp
فایل‌های
Sources
و
Packages
می‌توانند به هر فرمتی که apt پشتیبانی می‌کند فشرده شوند، تا زمانی که پسوند صحیح را داشته باشند\&. اگر لازم است چندین فایل از این دست را در یک دایرکتوری ذخیره کنید، می‌توانید نامی دلخواه را که آخرین نویسه آن یک زیرخط («_») است پیشوند قرار دهید\&. مثال: my\&.example_Packages\&.xz
.sp
توجه داشته باشید که این منابع به عنوان منابع قابل اعتماد در نظر گرفته می‌شوند (به
\fBapt-secure\fR(8)
مراجعه کنید)\&. مولفه پیکربندی:
APT::Sources::With\&.
.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
برای ایجاد رفتاری شبیه به سری 2\&.x در
\fBapt\fR(8)
استفاده کنید\&.
.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 "فایل‌ها (FILES)"
.PP
/etc/apt/sources\&.list
.RS 4
مکان‌های دریافت بسته‌ها\&. مولفه پیکربندی:
Dir::Etc::SourceList\&.
.RE
.PP
/etc/apt/sources\&.list\&.d/
.RS 4
قطعه‌فایل‌ها برای مکان‌های دریافت بسته‌ها\&. مولفه پیکربندی:
Dir::Etc::SourceParts\&.
.RE
.PP
/var/lib/apt/lists/
.RS 4
ناحیه ذخیره‌سازی برای اطلاعات وضعیت هر منبع بسته مشخص‌شده در
\fBsources.list\fR(5)\&.
مولفه پیکربندی:
Dir::State::Lists\&.
.RE
.PP
/var/lib/apt/lists/partial/
.RS 4
ناحیه ذخیره‌سازی برای اطلاعات وضعیت در حال انتقال\&. مولفه پیکربندی:
Dir::State::Lists
(عبارت partial به صورت ضمنی ضمیمه می‌شود)
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBapt.conf\fR(5),
\fBsources.list\fR(5),
\fBapt-get\fR(8),
\fBapt-patterns\fR(7)
.SH "عیب‌یابی (DIAGNOSTICS)"
.PP
\fBapt\-cache\fR
در عملکرد عادی مقدار صفر و در صورت بروز خطا مقدار ده‌دهی ۱۰۰ را بازمی‌گرداند\&.
.SH "اشکالات (BUGS)"
.PP
\m[blue]\fBصفحه باگ‌های APT\fR\m[]\&\s-2\u[3]\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
GraphViz
.RS 4
\%https://graphviz.org
.RE
.IP " 2." 4
ابزار VCG
.RS 4
\%https://www.rw.cdl.uni-saarland.de/people/sander/private/html/gsvcg1.html
.RE
.IP " 3." 4
صفحه باگ‌های APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE