'\" t
.\"     Title: apt-config
.\"    Author: Jason Gunthorpe
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 30\ \&November\ \&2013
.\"    Manual: APT
.\"    Source: APT 3.3.3
.\"  Language: Persian
.\"
.TH "APT\-CONFIG" "8" "30\ \&November\ \&2013" "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-config \- برنامه پرس‌وجوی پیکربندی APT
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBapt\-config\fR\ 'u
\fBapt\-config\fR [\fB\-\-empty\fR] [\fB\-\-format\ \*(Aq\fR\fB\fI%f\ "%v";%n\fR\fR\fB\*(Aq\fR] [\fB\-o=\fR\fB\fIconfig_string\fR\fR] [\fB\-c=\fR\fB\fIconfig_file\fR\fR] {shell | dump | {\-v\ |\ \-\-version} | {\-h\ |\ \-\-help}}
.SH "توضیحات (DESCRIPTION)"
.PP
\fBapt\-config\fR
یک برنامه داخلی است که توسط بخش‌های مختلف مجموعه APT برای ارائه قابلیت پیکربندی یکپارچه استفاده می‌شود\&. این برنامه به فایل پیکربندی اصلی
/etc/apt/apt\&.conf
به روشی که استفاده از آن برای برنامه‌های اسکریپتی آسان باشد دسترسی پیدا می‌کند\&.
.PP
مگر اینکه گزینه
\fB\-h\fR
یا
\fB\-\-help\fR
داده شده باشد، یکی از دستورات زیر باید درج شود\&.
.PP
\fBshell\fR
.RS 4
دستور shell برای دسترسی به اطلاعات پیکربندی از درون یک اسکریپت شل استفاده می‌شود\&. این دستور جفت‌هایی از آرگومان‌ها را دریافت می‌کند که اولی یک متغیر شل و دومی مقدار پیکربندی برای پرس‌وجو است\&. در خروجی، دستورات انتساب شل را برای هر مقدار موجود فهرست می‌کند\&. در یک اسکریپت شل باید به شرح زیر استفاده شود:
.sp
.if n \{\
.RS 4
.\}
.nf
OPTS="\-f"
RES=`apt\-config shell OPTS MyApp::options`
eval $RES
.fi
.if n \{\
.RE
.\}
این کار متغیر محیطی شل $OPTS را با مقدار پیش‌فرض
\fB\-f\fR
روی مقدار MyApp::options تنظیم می‌کند\&.
.sp
آیتم پیکربندی می‌تواند با پسوند /[fdbi] همراه باشد\&. مقدار f نام فایل‌ها، d نام دایرکتوری‌ها، b مقدار درست یا نادرست (true یا false) و i یک عدد صحیح را برمی‌گرداند\&. هر یک از مقادیر برگشتی به‌صورت داخلی اعتبارسنجی و نرمال‌سازی می‌شوند\&.
.RE
.PP
\fBdump\fR
.RS 4
فقط محتویات فضای پیکربندی را نمایش می‌دهد\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
تمام گزینه‌های خط فرمان را می‌توان با استفاده از فایل پیکربندی تنظیم کرد؛ توضیحات، گزینه پیکربندی مربوطه را برای تنظیم نشان می‌دهند\&. برای گزینه‌های بولی می‌توانید فایل پیکربندی را با مواردی مانند
\fB\-f\-\fR،\fB\-\-no\-f\fR،
\fB\-f=no\fR
یا چندین حالت دیگر بازنویسی (override) کنید\&.
.PP
\fB\-\-empty\fR
.RS 4
شامل گزینه‌هایی که مقدار خالی دارند\&. این حالت پیش‌فرض است، بنابراین از \-\-no\-empty برای حذف آن‌ها از خروجی استفاده کنید\&.
.RE
.PP
\fB\-\-format \*(Aq\fR\fB\fI%f "%v";%n\fR\fR\fB\*(Aq\fR
.RS 4
خروجی هر گزینه پیکربندی را تعریف می‌کند\&. %t با نام مجزای آن، %f با نام سلسله‌مراتبی کامل آن و %v با مقدار آن جایگزین خواهد شد\&. از حروف بزرگ استفاده کنید؛ کاراکترهای خاص در مقدار کدگذاری خواهند شد تا اطمینان حاصل شود که مثلاً می‌توان با خیال راحت از آن در یک quoted\-string طبق تعریف RFC822 استفاده کرد\&. علاوه بر این %n با خط جدید و %N با یک نویسه تب (tab) جایگزین می‌شود\&. یک % را می‌توان با استفاده از %% چاپ کرد\&.
.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 "همچنین ببینید (SEE ALSO)"
.PP
\fBapt.conf\fR(5)
.SH "عیب‌یابی (DIAGNOSTICS)"
.PP
\fBapt\-config\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