'\" t
.\"     Title: apt
.\"    Author: تیم APT
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 07\ \&November\ \&2025
.\"    Manual: APT
.\"    Source: APT 3.3.3
.\"  Language: Persian
.\"
.TH "APT" "8" "07\ \&November\ \&2025" "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 \- رابط خط فرمان سطح بالا برای مدیریت بستهها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBapt\fR\ 'u
\fBapt\fR [\fB\-h\fR] [\fB\-o=\fR\fB\fIconfig_string\fR\fR] [\fB\-c=\fR\fB\fIconfig_file\fR\fR] [\fB\-t=\fR\fB\fItarget_release\fR\fR] [\fB\-a=\fR\fB\fIarchitecture\fR\fR] {list | search | show | update | install\ \fIpkg\fR\ [{=\fIpkg_version_number\fR\ |\ /\fItarget_release\fR}]...  | remove\ \fIpkg\fR...  | upgrade | full\-upgrade | edit\-sources | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help}}
.SH "توضیحات (DESCRIPTION)"
.PP
\fBapt\fR
یک رابط خط فرمان سطح بالا برای سیستم مدیریت بسته ارائه می‌دهد\&. این ابزار به عنوان رابطی برای کاربر نهایی طراحی شده است و به صورت پیش‌فرض برخی از گزینه‌هایی را که برای استفاده تعاملی مناسب‌تر هستند، در مقایسه با ابزارهای تخصصی‌تر APT مانند
\fBapt-get\fR(8)
و
\fBapt-cache\fR(8)
فعال می‌کند\&.
.PP
درست مانند خود
\fBapt\fR،
صفحه راهنمای آن نیز به عنوان یک رابط برای کاربر نهایی در نظر گرفته شده است و از این رو فقط پرکاربردترین دستورات و گزینه‌ها را ذکر می‌کند؛ این امر تا حدی برای جلوگیری از تکرار اطلاعات در چندین مکان و تا حدی برای جلوگیری از سردرگم شدن خوانندگان با انبوهی از گزینه‌ها و جزئیات است\&.
.PP
\fBupdate\fR (\fBapt-get\fR(8))
.RS 4
\fBupdate\fR
برای بارگیری اطلاعات بسته‌ها از تمام مخازن پیکربندی‌شده استفاده می‌شود\&. سایر دستورات روی این داده‌ها عمل می‌کنند، برای مثال جهت ارتقای بسته‌ها یا جستجو در میان تمام بسته‌های موجود برای نصب و نمایش جزئیات آن‌ها\&.
.RE
.PP
\fBupgrade\fR (\fBapt-get\fR(8))
.RS 4
\fBupgrade\fR
برای نصب نسخه‌های ارتقایافته موجود از تمام بسته‌هایی که در حال حاضر روی سیستم نصب شده‌اند، از مخازن پیکربندی‌شده در
\fBsources.list\fR(5)
استفاده می‌شود\&. اگر برای برآورده ساختن وابستگی‌ها لازم باشد بسته‌های جدیدی نصب خواهند شد، اما بسته‌های موجود هرگز حذف نخواهند شد\&. اگر ارتقای یک بسته نیازمند حذف یک بسته نصب‌شده باشد، ارتقا برای این بسته انجام نخواهد شد\&.
.sp
هنگامی که یک بسته به عنوان آرگومان داده شود، آن بسته پیش از عملیات ارتقا نصب خواهد شد\&.
.RE
.PP
\fBfull\-upgrade\fR (\fBapt-get\fR(8))
.RS 4
دستور
full\-upgrade
عملکرد upgrade را انجام می‌دهد، اما اگر برای ارتقای کلی سیستم لازم باشد، بسته‌های نصب‌شده فعلی را نیز حذف خواهد کرد\&.
.sp
هنگامی که یک بسته به عنوان آرگومان داده شود، آن بسته پیش از عملیات ارتقا نصب خواهد شد\&.
.RE
.PP
\fBinstall\fR, \fBreinstall\fR, \fBremove\fR, \fBpurge\fR (\fBapt-get\fR(8))
.RS 4
عملیات درخواستی را روی یک یا چند بسته مشخص‌شده از طریق
\fBregex\fR(7)،
\fBglob\fR(7)
یا تطابق دقیق انجام می‌دهد\&. عملیات درخواستی را می‌توان برای بسته‌های خاصی با افزودن علامت مثبت (+) به انتهای نام بسته برای نصب آن، یا علامت منفی (\-) برای حذف آن، تغییر داد\&.
.sp
یک نسخه خاص از یک بسته را می‌توان با قرار دادن علامت مساوی (=) پس از نام بسته و سپس نسخه بسته مورد نظر برای نصب انتخاب کرد\&. همچنین نسخه مربوط به یک انتشار (release) خاص را می‌توان با قرار دادن علامت اسلش (/) پس از نام بسته و به دنبال آن نام کد (trixie، forky، sid \&...) یا نام توزیع (stable، testing، unstable) انتخاب نمود\&. این کار در صورت نیاز برای برآورده کردن درخواست، نسخه‌های حاصل از آن انتشار را برای وابستگی‌های این بسته نیز انتخاب خواهد کرد\&.
.sp
حذف یک بسته تمامی داده‌های بسته‌بندی‌شده آن را پاک می‌کند، اما فایل‌های پیکربندی کاربری (تغییریافته) که معمولاً کوچک هستند را باقی می‌گذارد تا در صورتی که حذف به صورت تصادفی رخ داده باشد مشکلی پیش نیاید\&. در چنین شرایطی، کافی است درخواست نصب بسته‌ای را که تصادفاً حذف شده صادر کنید تا عملکرد آن مانند قبل بازیابی شود\&. از طرف دیگر، می‌توانید با فراخوانی
\fBpurge\fR
(حتی روی بسته‌هایی که قبلاً حذف شده‌اند) این بقایا را نیز کاملاً پاک کنید\&. توجه داشته باشید که این کار بر هیچ‌یک از داده‌ها یا فایل‌های پیکربندی ذخیره‌شده در پوشه خانگی (home) شما تاثیری نمی‌گذارد\&.
.RE
.PP
\fBautoremove\fR (\fBapt-get\fR(8))
.RS 4
دستور
autoremove
برای حذف بسته‌هایی استفاده می‌شود که به طور خودکار جهت برآورده کردن وابستگی‌های سایر بسته‌ها نصب شده بودند و اکنون به دلیل تغییر وابستگی‌ها یا حذف بسته‌های نیازمند به آن‌ها، دیگر مورد نیاز نیستند\&.
.sp
شما باید بررسی کنید که این فهرست شامل برنامه‌هایی نباشد که به استفاده از آن‌ها علاقه‌مند شده‌اید، حتی اگر زمانی صرفاً به عنوان یک وابستگی برای بسته‌ای دیگر نصب شده باشند\&. می‌توانید چنین بسته‌هایی را با استفاده از
\fBapt-mark\fR(8)
به عنوان بسته‌های نصب‌شده به صورت دستی علامت‌گذاری کنید\&. بسته‌هایی که صراحتاً از طریق دستور
\fBinstall\fR
نصب کرده‌اید نیز هرگز برای حذف خودکار پیشنهاد نمی‌شوند\&.
.RE
.PP
\fBsatisfy\fR (\fBapt-get\fR(8))
.RS 4
\fBsatisfy\fR
رشته‌های وابستگی را برآورده می‌سازد، همان‌گونه که در Build\-Depends استفاده می‌شود\&. این دستور همچنین تعارض‌ها (conflicts) را با پیشوند قرار دادن
"Conflicts: "
در ابتدای آرگومان مدیریت می‌کند\&.
.sp
مثال:
apt satisfy "foo, bar (>= 1\&.0)" "Conflicts: baz, fuzz"
.RE
.PP
\fBwhy, why\-not\fR
.RS 4
این دستورات مسیر استدلال حل‌کننده وابستگی‌ها (solver) را چاپ می‌کنند\&. آن‌ها در بسیاری از موارد مشابه دستورات معادل در aptitude هستند، اما تفاوت آن‌ها در این است که دلیل واقعی انتخاب‌شده توسط حل‌کننده را چاپ می‌کنند، نه قوی‌ترین مسیر احتمالی را\&.
.sp
دستور
\fBwhy\fR
مشخص می‌کند چرا یک بسته نصب‌شده روی سیستم نصب است\&. این دستور بازخورد معقولی در رابطه با دلیل نصب یک بسته که به صورت خودکار نصب شده ارائه می‌دهد؛ برای بسته‌ای که به صورت دستی نصب شده هیچ دلیل دیگری ارائه نمی‌شود\&. اگر بسته نصب نشده باشد، دلیلی قابل تعیین نیست\&.
.sp
دستور
\fBwhy\-not\fR
مشخص می‌کند چرا نتیجه‌گیری شده که یک بسته غیرقابل نصب است\&. این دستور ممکن است همیشه پاسخی نداشته باشد، حتی اگر یک بسته غیرقابل نصب باشد\&.
.sp
هر دو دستور یک آرگومان می‌گیرند که نام یک بسته است\&.
.RE
.PP
\fBsearch\fR (\fBapt-cache\fR(8))
.RS 4
\fBsearch\fR
می‌تواند برای جستجوی عبارت(های) داده‌شده بر اساس
\fBregex\fR(7)
در فهرست بسته‌های موجود و نمایش نتایج منطبق استفاده شود\&. این دستور برای مثال هنگامی که به دنبال بسته‌های دارای یک قابلیت خاص هستید مفید است\&. اگر به دنبال بسته‌ای شامل یک فایل خاص هستید، دستور
\fBapt-file\fR(1)
را امتحان کنید\&.
.RE
.PP
\fBshow\fR (\fBapt-cache\fR(8))
.RS 4
نمایش اطلاعات درباره بسته(های) مشخص‌شده، شامل وابستگی‌های آن، حجم نصب و بارگیری، مخازنی که بسته در آن‌ها در دسترس است، توضیحات مربوط به محتوای بسته و موارد دیگر\&. به عنوان مثال، پیش از صدور مجوز به
\fBapt\fR(8)
برای حذف یک بسته یا هنگام جستجو برای بسته‌های جدید جهت نصب، مشاهده این اطلاعات می‌تواند سودمند باشد\&.
.RE
.PP
\fBlist\fR
.RS 4
\fBlist\fR
تا حدودی مشابه
\fBdpkg\-query \-\-list\fR
است، از این جهت که می‌تواند فهرستی از بسته‌های دارای معیارهای مشخص را نمایش دهد\&. این دستور از الگوهای
\fBglob\fR(7)
برای تطبیق نام بسته‌ها و
\fBapt-patterns\fR(7)،
و همچنین گزینه‌هایی برای فهرست کردن نسخه‌های نصب‌شده
(\fB\-\-installed\fR)،
قابل ارتقا
(\fB\-\-upgradeable\fR)
یا تمامی نسخه‌های موجود
(\fB\-\-all\-versions\fR)
پشتیبانی می‌کند\&.
.RE
.PP
\fBedit\-sources\fR (work\-in\-progress)
.RS 4
دستور
edit\-sources
به شما اجازه می‌دهد فایل‌های
\fBsources.list\fR(5)
خود را در ویرایشگر متنی مورد علاقه خود ویرایش کنید، در حالی که بررسی‌های صحت اولیه را نیز انجام می‌دهد\&.
.RE
.PP
\fBshowsrc, depends, rdepends, policy\fR (خلاصه‌شده در \fBapt-cache\fR(8))
.RS 4
.RE
.PP
\fBsource, build\-dep, download, changelog, clean, distclean, autoclean\fR (خلاصه‌شده در \fBapt-get\fR(8))
.RS 4
.RE
.SH "اسکریپتنویسی و تفاوتها با سایر ابزارهای APT (SCRIPT USAGE AND DIFFERENCES FROM OTHER APT TOOLS)"
.PP
خط فرمان
\fBapt\fR(8)
به عنوان ابزاری برای کاربر نهایی طراحی شده است و ممکن است رفتار آن در نسخه‌های مختلف تغییر کند\&. با اینکه تلاش می‌شود سازگاری عقبرو (backward compatibility) حفظ گردد، اما در صورتی که تغییری برای استفاده تعاملی سودمند باشد، این سازگاری تضمین نمی‌شود\&.
.PP
تمام قابلیت‌های
\fBapt\fR(8)
در ابزارهای اختصاصی APT مانند
\fBapt-get\fR(8)
و
\fBapt-cache\fR(8)
نیز در دسترس هستند\&.
\fBapt\fR(8)
صرفاً مقدار پیش‌فرض برخی گزینه‌ها را تغییر می‌دهد (به
\fBapt.conf\fR(5)
و به ویژه محدوده Binary مراجعه کنید)\&. بنابراین بهتر است در اسکریپت‌های خود از این دستورات اختصاصی (در صورت نیاز همراه با فعال‌سازی برخی گزینه‌های اضافی) استفاده کنید، زیرا آن‌ها سازگاری عقبرو را تا جای ممکن حفظ می‌کنند\&.
.SH "گزینهها (OPTIONS)"
.PP
تمام گزینه‌های خط فرمان را می‌توان با استفاده از فایل پیکربندی تنظیم کرد؛ توضیحات هر گزینه مشخص‌کننده گزینه پیکربندی مربوطه برای تنظیم است\&. برای گزینه‌های بولی (صحیح/غلط) می‌توانید فایل پیکربندی را با استفاده از مواردی مانند
\fB\-f\-\fR،
\fB\-\-no\-f\fR،
\fB\-f=no\fR
یا چندین حالت دیگر لغو (override) کنید\&.
.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
نمایش پیام‌های بازرسی (و اخطارها)\&. این گزینه تنظیمات حالت بی‌صدا (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 "همچنین ببینید (SEE ALSO)"
.PP
\fBapt-get\fR(8),
\fBapt-cache\fR(8),
\fBsources.list\fR(5),
\fBapt.conf\fR(5),
\fBapt-config\fR(8),
\fBapt-patterns\fR(7), راهنمای کاربری APT در /usr/share/doc/apt\-doc/,
\fBapt_preferences\fR(5), راهنمای چگونه APT (the APT Howto)\&.
.SH "عیب‌یابی (DIAGNOSTICS)"
.PP
\fBapt\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
\fBتیم APT\fR
.RS 4
.RE
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
صفحه باگ‌های APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE