'\" t
.\"     Title: apt-mark
.\"    Author: Mike O\*(AqConnor
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 14\ \&September\ \&2024
.\"    Manual: APT
.\"    Source: APT 3.3.3
.\"  Language: Persian
.\"
.TH "APT\-MARK" "8" "14\ \&September\ \&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-mark \- تغییر تنظیمات نشانهگذاری بستههای نصبشده
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBapt\-mark\fR\ 'u
\fBapt\-mark\fR {\fB\-f=\fR\fB\fIfilename\fR\fR | {auto\ |\ manual}\ \fIpkg\fR...  | {showauto\ |\ showmanual}\ [\fIpkg\fR...] } | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help} 
.HP \w'\fBapt\-mark\fR\ 'u
\fBapt\-mark\fR {hold\ |\ unhold\ |\ install\ |\ remove\ |\ purge}\ \fIpkg\fR...  | {showhold\ |\ showinstall\ |\ showremove\ |\ showpurge}\ [\fIpkg\fR...]  
.SH "توضیحات (DESCRIPTION)"
.PP
\fBapt\-mark\fR
می‌تواند به عنوان یک رابط یکپارچه برای اعمال تنظیمات مختلف روی یک بسته به کار رود؛ مانند نشانه‌گذاری یک بسته به عنوان نصب‌شده به‌صورت خودکار یا دستی، یا تغییر انتخاب‌های
\fBdpkg\fR
نظیر
.BR hold ،
.BR install ،
\fBdeinstall\fR
و
\fBpurge\fR
که برای مثال توسط
\fBapt\-get dselect\-upgrade\fR
یا
\fBaptitude\fR
رعایت می‌شوند\&.
.SH "بسته‌های نصب‌شده به‌صورت خودکار و دستی (AUTOMATICALLY AND MANUALLY INSTALLED PACKAGES)"
.PP
هنگامی که درخواست نصب یک بسته را می‌دهید و در نتیجه آن بسته‌های دیگری برای برآورده کردن وابستگی‌های آن نصب می‌شوند، این وابستگی‌ها به عنوان نصب‌شده به‌صورت خودکار نشانه‌گذاری می‌شوند، در حالی که بسته‌ای که صراحتاً نصب کرده‌اید به عنوان نصب‌شده به‌صورت دستی علامت می‌خورد\&. هنگامی که دیگر هیچ بسته نصب‌شده به‌صورت دستی به یک بسته نصب‌شده خودکار وابسته نباشد، آن بسته دیگر غیرضروری تلقی می‌شود و برای نمونه
\fBapt\-get\fR
یا
\fBaptitude\fR
دست‌کم پیشنهاد حذف آن‌ها را ارائه خواهند داد\&.
.PP
\fBauto\fR
.RS 4
.B auto
برای نشانه‌گذاری یک بسته به عنوان نصب‌شده به‌صورت خودکار استفاده می‌شود، که باعث خواهد شد بسته در زمانی که دیگر هیچ بسته نصب‌شده دستی به آن وابسته نباشد حذف شود\&.
.RE
.PP
\fBmanual\fR
.RS 4
.B manual
برای نشانه‌گذاری یک بسته به عنوان نصب‌شده به‌صورت دستی استفاده می‌شود، که از حذف خودکار بسته در صورتی که هیچ بسته دیگری به آن وابسته نباشد جلوگیری می‌کند\&.
.RE
.PP
\fBminimize\-manual\fR
.RS 4
.B minimize\-manual
برای نشانه‌گذاری وابستگی‌های (تراگذرا) فرابسته‌ها (metapackages) به عنوان نصب‌شده به‌صورت خودکار استفاده می‌شود\&. از این دستور می‌توان به عنوان مثال پس از فرایند نصب برای به حداقل رساندن تعداد بسته‌های نصب‌شده به‌صورت دستی استفاده کرد؛ یا به‌طور مداوم در سیستم‌هایی که توسط فرابسته‌های پیکربندی سیستم مدیریت می‌شوند\&.
.RE
.PP
\fBshowauto\fR
.RS 4
.B showauto
برای چاپ فهرستی از بسته‌های نصب‌شده به‌صورت خودکار با درج هر بسته در یک خط جدید استفاده می‌شود\&. اگر هیچ بسته‌ای مشخص نشود، تمام بسته‌های نصب‌شده به‌صورت خودکار فهرست خواهند شد\&. در صورت مشخص کردن بسته‌ها، تنها آن‌هایی که به‌صورت خودکار نصب شده‌اند نمایش داده می‌شوند\&.
.RE
.PP
\fBshowmanual\fR
.RS 4
.B showmanual
می‌تواند به همان شیوه
.B showauto
استفاده شود، با این تفاوت که به جای آن فهرستی از بسته‌های نصب‌شده به‌صورت دستی را چاپ می‌کند\&.
.RE
.SS "گزینه‌ها (Options)"
.PP
\fB\-f=\fR\fB\fIfilename\fR\fR, \fB\-\-file=\fR\fB\fIfilename\fR\fR
.RS 4
خواندن/نوشتن وضعیت بسته‌ها از نام فایل مشخص‌شده با پارامتر
\fIfilename\fR
به جای مکان پیش‌فرض، که عبارت است از
extended_states
در دایرکتوری تعریف‌شده توسط مولفه پیکربندی
Dir::State\&.
.RE
.SH "جلوگیری از تغییرات در یک بسته (PREVENT CHANGES FOR A PACKAGE)"
.PP
\fBhold\fR
.RS 4
.B hold
برای نشانه‌گذاری یک بسته به عنوان نگه‌داشته‌شده (held back) استفاده می‌شود که از نصب، ارتقا یا حذف خودکار بسته جلوگیری خواهد کرد\&.
.RE
.PP
\fBunhold\fR
.RS 4
.B unhold
برای لغو وضعیت نگه‌داشتن (hold) که قبلاً برای یک بسته تنظیم شده بود استفاده می‌شود تا تمام اقدامات دوباره مجاز شوند\&.
.RE
.PP
\fBshowhold\fR
.RS 4
.B showhold
برای چاپ فهرستی از بسته‌های در حالت نگه‌داری (on hold) به همان شیوه سایر دستورات نمایش استفاده می‌شود\&.
.RE
.SH "زمان‌بندی بسته‌ها برای نصب، حذف و پاک‌سازی کامل (SCHEDULE PACKAGES FOR INSTALL, REMOVE AND PURGE)"
.PP
برخی از رابط‌ها مانند
\fBapt\-get dselect\-upgrade\fR
می‌توانند برای اعمال تغییرات زمان‌بندی‌شده پیشین روی وضعیت نصب بسته‌ها استفاده شوند\&. چنین تغییراتی را می‌توان با دستورات
\fBinstall\fR،
\fBremove\fR
(همچنین شناخته‌شده به عنوان
\fBdeinstall\fR)
و
\fBpurge\fR
زمان‌بندی کرد\&. بسته‌های دارای یک انتخاب خاص را می‌توان به ترتیب با
\fBshowinstall\fR،
\fBshowremove\fR
و
\fBshowpurge\fR
نمایش داد\&. اطلاعات بیشتر درباره این به اصطلاح انتخاب‌های dpkg را می‌توانید در
\fBdpkg\fR(1)
بیابید\&.
.SH "گزینهها (OPTIONS)"
.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 "فایلها (FILES)"
.PP
/var/lib/apt/extended_states
.RS 4
فهرست وضعیت بسته‌های به‌طور خودکار نصب‌شده\&. مولفه پیکربندی:
Dir::State::extended_states\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBapt-get\fR(8),
\fBaptitude\fR(8),
\fBapt.conf\fR(5)
.SH "عیب‌یابی (DIAGNOSTICS)"
.PP
\fBapt\-mark\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
\fBMike O\*(AqConnor\fR
.RS 4
.RE
.PP
\fBAPT team\fR
.RS 4
.RE
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
صفحه باگ‌های APT
.RS 4
\%https://bugs.debian.org/src:apt
.RE