.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "update-alternatives 1"
.TH update-alternatives 1 2026-03-06 1.23.7-dirty "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
update\-alternatives \- مدیریت پیوندهای نمادین تعیین‌کننده دستورات پیش‌فرض
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBupdate\-alternatives\fR
[\fIگزینه\fR...] \fIدستور\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
دستور
\&\fBupdate\-alternatives\fR
اطلاعات مربوط به پیوندهای نمادین تشکیل‌دهنده سیستم جایگزین‌ها را ایجاد، حذف، نگهداری و نمایش می‌دهد.
.PP
این امکان وجود دارد که چندین برنامه با وظایف یکسان یا مشابه به‌طور هم‌زمان بر روی یک سیستم نصب شوند.
به عنوان مثال، در بسیاری از سیستم‌ها چندین ویرایشگر متن به‌طور هم‌زمان نصب هستند.
این امر به کاربران سیستم حق انتخاب می‌دهد و هر کاربر می‌تواند در صورت تمایل از ویرایشگر متفاوتی استفاده کند، اما در صورتی که کاربر اولویت خاصی را مشخص نکرده باشد، تصمیم‌گیری برای اجرای یک ویرایشگر مناسب توسط برنامه‌های دیگر دشوار می‌شود.
.PP
هدف سیستم جایگزین‌ها حل این مشکل است.
یک نام عمومی (generic name) در سیستم‌فایل بین تمام فایل‌هایی که قابلیت‌های تعویض‌پذیر ارائه می‌دهند به اشتراک گذاشته می‌شود.
سیستم جایگزین‌ها و مدیر سیستم با هم تعیین می‌کنند که این نام عمومی به کدام فایل واقعی اشاره کند.
به عنوان مثال، اگر هر دو ویرایشگر متن
\&\fBed\fR\|(1)
و
\&\fBnvi\fR\|(1)
روی سیستم نصب باشند، سیستم جایگزین‌ها باعث می‌شود که نام عمومی
\&\fI/usr/bin/editor\fR
به‌طور پیش‌فرض به
\&\fI/usr/bin/nvi\fR
اشاره کند.
مدیر سیستم می‌تواند این وضعیت را تغییر دهد تا به جای آن به
\&\fI/usr/bin/ed\fR
اشاره کند، و سیستم جایگزین‌ها این تنظیم را تا زمانی که صریحاً درخواست نشود تغییر نخواهد داد.
.PP
نام عمومی یک پیوند نمادین مستقیم به جایگزین انتخاب‌شده نیست؛
بلکه یک پیوند نمادین به نامی در
\&\fIدایرکتوری جایگزین‌ها\fR
است که آن نیز به نوبه خود یک پیوند نمادین به فایل واقعیِ ارجاع‌شده است.
این کار به این دلیل انجام می‌شود تا تغییرات مدیر سیستم به دایرکتوری
\&\fI/etc\fR
محدود شود: استاندارد سلسله‌مراتب سیستم‌فایل (FHS) دلایلی برای چرایی سودمند بودن این روش ارائه می‌دهد.
.PP
هنگامی که هر بسته‌ای که فایلی با کارکرد خاص ارائه می‌دهد نصب، تغییر یا حذف می‌شود،
\&\fBupdate\-alternatives\fR
فراخوانی می‌شود تا اطلاعات مربوط به آن فایل را در سیستم جایگزین‌ها به‌روزرسانی کند.
\&\fBupdate\-alternatives\fR
معمولاً از اسکریپت‌های نگهدارنده بسته دبیان فراخوانی می‌شود:
\&\fBpostinst\fR
(پیکربندی) برای نصب جایگزین، و
\&\fBprerm\fR و \fBpostrm\fR
(حذف) برای حذف جایگزین.
\&\fBتوجه\fR: در بیشتر موارد (اگر نگوییم همه)، هیچ عملیات دیگری از اسکریپت‌های نگهدارنده نباید
\&\fBupdate\-alternatives\fR
را فراخوانی کند؛ به ویژه نه در
\&\fBupgrade\fR
و نه در
\&\fBdisappear\fR،
زیرا هر اقدام دیگری از این دست ممکن است وضعیت دستی (manual) یک جایگزین را از بین ببرد، یا باعث جابه‌جایی موقت جایگزین شود، یا زمانی که چند مورد اولویت یکسانی دارند جایگزین را به کلی تغییر دهد.
.PP
اغلب سودمند است که تعدادی از جایگزین‌ها همگام‌سازی شوند تا به صورت یک گروه تغییر کنند؛ به عنوان مثال، هنگامی که چندین نسخه از ویرایشگر
\&\fBvi\fR\|(1)
نصب شده باشد، صفحه راهنمای ارجاع‌شده توسط
\&\fI/usr/share/man/man1/vi.1\fR
باید با فایل اجرایی ارجاع‌شده توسط
\&\fI/usr/bin/vi\fR
مطابقت داشته باشد.
دستور
\&\fBupdate\-alternatives\fR
این کار را با استفاده از پیوندهای
\&\fIاصلی (master)\fR
و
\&\fIوابسته (slave)\fR
مدیریت می‌کند؛ هنگامی که پیوند اصلی تغییر می‌کند، تمام پیوندهای وابسته به آن نیز تغییر می‌یابند.
یک پیوند اصلی و پیوندهای وابسته به آن یک
\&\fIگروه پیوند (link group)\fR
را تشکیل می‌دهند.
.PP
هر گروه پیوند در هر لحظه در یکی از دو حالت قرار دارد: خودکار (automatic) یا دستی (manual).
هنگامی که یک گروه در حالت خودکار است، سیستم جایگزین‌ها با نصب یا حذف بسته‌ها، به‌طور خودکار تصمیم می‌گیرد که پیوندها چگونه و چه زمانی به‌روزرسانی شوند.
در حالت دستی، سیستم جایگزین‌ها انتخاب مدیر سیستم را حفظ کرده و از تغییر پیوندها خودداری می‌کند (مگر زمانی که پیوندی شکسته یا خراب باشد).
.PP
گروه‌های پیوند زمانی که برای نخستین بار به سیستم معرفی می‌شوند در حالت خودکار هستند.
اگر مدیر سیستم در تنظیمات خودکار سیستم تغییری ایجاد کند، در اجرای بعدی
\&\fBupdate\-alternatives\fR
روی گروهِ پیوندِ تغییریافته این موضوع شناسایی شده و گروه به‌طور خودکار به حالت دستی تغییر وضعیت می‌دهد.
.PP
هر جایگزین دارای یک
\&\fIاولویت (priority)\fR
است.
هنگامی که یک گروه پیوند در حالت خودکار قرار دارد، اعضای گروه به جایگزین‌هایی اشاره خواهند کرد که بالاترین اولویت را دارند.
.PP
هنگام استفاده از گزینه
\&\fB\-\-config\fR،
دستور
\&\fBupdate\-alternatives\fR
تمام انتخاب‌های موجود برای گروه پیوندی را که
\&\fIname\fR
داده‌شده نام جایگزین اصلی آن است، فهرست می‌کند.
انتخاب فعلی با یک علامت «*» مشخص می‌شود.
سپس از شما خواسته می‌شود که انتخاب خود را برای این گروه پیوند وارد کنید.
بسته به انتخاب انجام‌شده، ممکن است گروه پیوند دیگر در حالت
\&\fIخودکار (auto)\fR
نباشد.
برای بازگشت به حالت خودکار باید از گزینه
\&\fB\-\-auto\fR
استفاده کنید (یا می‌توانید دوباره
\&\fB\-\-config\fR
را اجرا کرده و موردی را که به عنوان خودکار علامت‌گذاری شده انتخاب کنید).
.PP
اگر می‌خواهید پیکربندی را به‌صورت غیرتعاملی انجام دهید، می‌توانید به جای آن از گزینه
\&\fB\-\-set\fR
استفاده کنید (به بخش زیر مراجعه کنید).
.PP
بسته‌های مختلفی که فایل یکسانی را ارائه می‌دهند باید این کار را به صورت
\&\fBهمکارانه (cooperatively)\fR
انجام دهند.
به عبارت دیگر، در چنین حالتی استفاده از
\&\fBupdate\-alternatives\fR
برای تمام بسته‌های مربوطه
\&\fBاجباری\fR
است.
جایگزین کردن فایلی در بسته‌ای که از سازوکار
\&\fBupdate\-alternatives\fR
استفاده نمی‌کند ممکن نیست.
.SH "اصطلاحات (TERMINOLOGY)"
.IX Header "TERMINOLOGY"
از آنجا که سازوکار عملکرد
\&\fBupdate\-alternatives\fR
پیچیدگی‌های خاص خود را دارد، تعریف چند اصطلاح مشخص به درک عملکرد آن کمک می‌کند.
.IP "نام عمومی (یا پیوند جایگزین)" 4
.IX Item "generic name (or alternative link)"
نامی مانند
\&\fI/usr/bin/editor\fR
که از طریق سیستم جایگزین‌ها به یکی از چندین فایل با عملکرد مشابه ارجاع می‌دهد.
.IP "نام جایگزین (alternative name)" 4
.IX Item "alternative name"
نام یک پیوند نمادین در دایرکتوری جایگزین‌ها.
.IP "جایگزین (یا مسیر جایگزین)" 4
.IX Item "alternative (or alternative path)"
نام یک فایل خاص در سیستم‌فایل، که می‌توان با استفاده از سیستم جایگزین‌ها از طریق یک نام عمومی به آن دسترسی داشت.
.IP "دایرکتوری جایگزین‌ها (alternatives directory)" 4
.IX Item "alternatives directory"
دایرکتوری‌ای که به‌طور پیش‌فرض
\&\fI/etc/alternatives\fR
است و پیوندهای نمادین را در بر دارد.
.IP "دایرکتوری مدیریتی (administrative directory)" 4
.IX Item "administrative directory"
دایرکتوری‌ای که به‌طور پیش‌فرض
\&\fI/var/lib/dpkg/alternatives\fR
است و اطلاعات وضعیت
\&\fBupdate\-alternatives\fR
را نگهداری می‌کند.
.IP "گروه پیوند (link group)" 4
.IX Item "link group"
مجموعه‌ای از پیوندهای نمادین مرتبط که قرار است به صورت یک گروه به‌روزرسانی شوند.
.IP "پیوند اصلی (master link)" 4
.IX Item "master link"
پیوند جایگزینی در یک گروه پیوند که نحوه پیکربندی سایر پیوندهای گروه را تعیین می‌کند.
.IP "پیوند وابسته (slave link)" 4
.IX Item "slave link"
پیوند جایگزینی در یک گروه پیوند که با تنظیمات پیوند اصلی کنترل می‌شود.
.IP "حالت خودکار (automatic mode)" 4
.IX Item "automatic mode"
هنگامی که یک گروه پیوند در حالت خودکار است، سیستم جایگزین‌ها اطمینان حاصل می‌کند که پیوندهای موجود در گروه به جایگزین دارای بالاترین اولویت متناسب با آن گروه اشاره کنند.
.IP "حالت دستی (manual mode)" 4
.IX Item "manual mode"
هنگامی که یک گروه پیوند در حالت دستی قرار دارد، سیستم جایگزین‌ها هیچ تغییری در تنظیمات مدیر سیستم ایجاد نخواهد کرد.
.SH "دستورات (COMMANDS)"
.IX Header "COMMANDS"
.IP "\fB\-\-install\fR \fIlink name path priority\fR [\fB\-\-slave\fR \fIlink name path\fR]..." 4
.IX Item "--install link name path priority [--slave link name path]..."
یک گروه از جایگزین‌ها را به سیستم اضافه می‌کند.
\&\fIlink\fR
نام عمومی برای پیوند اصلی است،
\&\fIname\fR
نام پیوند نمادین آن در دایرکتوری جایگزین‌هاست، و
\&\fIpath\fR
مسیر جایگزینی است که برای پیوند اصلی معرفی می‌شود.
آرگومان‌های پس از
\&\fB\-\-slave\fR
شامل نام عمومی، نام پیوند نمادین در دایرکتوری جایگزین‌ها و مسیر جایگزین برای یک پیوند وابسته است.
می‌توان صفر یا چند گزینه
\&\fB\-\-slave\fR
را که هر کدام با سه آرگومان دنبال می‌شوند مشخص کرد.
توجه داشته باشید که جایگزین اصلی باید وجود داشته باشد، در غیر این صورت فراخوانی با شکست مواجه می‌شود.
با این حال، اگر جایگزین وابسته وجود نداشته باشد، پیوند جایگزین وابسته متناظر به سادگی نصب نمی‌شود (البته همچنان یک هشدار نمایش داده خواهد شد).
اگر یک فایل واقعی در جایی که باید پیوند جایگزین نصب شود از قبل وجود داشته باشد، نگه‌داشته می‌شود مگر اینکه از
\&\fB\-\-force\fR
استفاده شود.
.Sp
اگر نام جایگزینِ مشخص‌شده از قبل در سوابق سیستم جایگزین‌ها موجود باشد، اطلاعات ارائه‌شده به عنوان یک مجموعه جدید از جایگزین‌ها برای آن گروه اضافه خواهد شد.
در غیر این صورت، یک گروه جدید در حالت خودکار همراه با این اطلاعات اضافه می‌شود.
اگر گروه در حالت خودکار باشد و اولویت جایگزین تازه اضافه‌شده بالاتر از هر جایگزین نصب‌شده دیگری برای این گروه باشد، پیوندهای نمادین به‌روزرسانی می‌شوند تا به جایگزین جدید اشاره کنند.
.IP "\fB\-\-set\fR \fIname\fR \fIpath\fR" 4
.IX Item "--set name path"
برنامه
\&\fIpath\fR
را به عنوان جایگزین برای
\&\fIname\fR
تنظیم می‌کند.
این دستور معادل
\&\fB\-\-config\fR
است اما غیرتعاملی بوده و بنابراین در اسکریپت‌ها قابل استفاده است.
.IP "\fB\-\-remove\fR \fIname\fR \fIpath\fR" 4
.IX Item "--remove name path"
یک جایگزین و تمامی پیوندهای وابسته مرتبط با آن را حذف می‌کند.
\&\fIname\fR
نامی در دایرکتوری جایگزین‌هاست و
\&\fIpath\fR
نام فایل مطلق است که
\&\fIname\fR
می‌تواند به آن پیوند داشته باشد.
اگر
\&\fIname\fR
در واقع به
\&\fIpath\fR
پیوند داده شده باشد،
\&\fIname\fR
به‌روزرسانی خواهد شد تا به جایگزین مناسب دیگری اشاره کند
(و گروه دوباره به حالت خودکار بازگردانده می‌شود)، یا اگر جایگزین دیگری باقی نمانده باشد حذف خواهد شد.
پیوندهای وابسته مرتبط نیز به همین ترتیب به‌روزرسانی یا حذف خواهند شد.
اگر پیوند در حال حاضر به
\&\fIpath\fR
اشاره نکند، هیچ پیوندی تغییر نمی‌یابد؛
فقط اطلاعات مربوط به آن جایگزین حذف می‌شود.
.IP "\fB\-\-remove\-all\fR \fIname\fR" 4
.IX Item "--remove-all name"
تمامی جایگزین‌ها و همه پیوندهای وابسته مرتبط با آن‌ها را حذف می‌کند.
\&\fIname\fR
نامی در دایرکتوری جایگزین‌ها است.
.IP \fB\-\-all\fR 4
.IX Item "--all"
دستور
\&\fB\-\-config\fR
را روی تمامی جایگزین‌ها فراخوانی می‌کند.
می‌توان آن را به‌طور مفیدی با
\&\fB\-\-skip\-auto\fR
ترکیب کرد تا تمام جایگزین‌هایی که در حالت خودکار پیکربندی نشده‌اند بررسی و پیکربندی شوند.
جایگزین‌های خراب یا شکسته نیز نمایش داده می‌شوند.
بنابراین یک روش ساده برای رفع تمام جایگزین‌های شکسته، فراخوانی دستور زیر است:
\&\fByes \*(Aq\*(Aq | update\-alternatives \-\-force \-\-all\fR.
.IP "\fB\-\-auto\fR \fIname\fR" 4
.IX Item "--auto name"
گروه پیوند مرتبط با جایگزین
\&\fIname\fR
را به حالت خودکار تغییر وضعیت می‌دهد.
در این فرآیند، پیوند نمادین اصلی و وابسته‌های آن به‌روزرسانی می‌شوند تا به جایگزین‌های نصب‌شده با بالاترین اولویت اشاره کنند.
.IP "\fB\-\-display\fR \fIname\fR" 4
.IX Item "--display name"
اطلاعات مربوط به گروه پیوند را نمایش می‌دهد.
اطلاعات ارائه‌شده شامل حالت گروه (خودکار یا دستی)،
پیوندهای اصلی و وابسته،
جایگزینی که پیوند اصلی در حال حاضر به آن اشاره دارد،
سایر جایگزین‌های در دسترس (و جایگزین‌های وابسته متناظر آن‌ها)،
و جایگزین دارای بالاترین اولویت که هم‌اکنون نصب شده است می‌باشد.
.IP \fB\-\-get\-selections\fR 4
.IX Item "--get-selections"
تمام نام‌های جایگزین اصلی (آن‌هایی که یک گروه پیوند را کنترل می‌کنند) و وضعیت آن‌ها را فهرست می‌کند (از نسخه 1.15.0).
هر خط شامل حداکثر ۳ فیلد است (که با یک یا چند فاصله از هم جدا شده‌اند).
فیلد اول نام جایگزین، فیلد دوم وضعیت (یا
\&\fBauto\fR
یا
\&\fBmanual\fR)
و فیلد آخر شامل انتخاب فعلی در جایگزین است (توجه: این فیلد نام فایل است و ممکن است حاوی فاصله باشد).
.IP \fB\-\-set\-selections\fR 4
.IX Item "--set-selections"
پیکربندی جایگزین‌ها را از ورودی استاندارد در قالبی که توسط
\&\fB\-\-get\-selections\fR
تولید می‌شود خوانده و آن‌ها را بر این اساس مجدداً پیکربندی می‌کند (از نسخه 1.15.0).
.IP "\fB\-\-query\fR \fIname\fR" 4
.IX Item "--query name"
اطلاعات مربوط به گروه پیوند را مانند
\&\fB\-\-display\fR
اما در قالبی قابل تجزیه توسط ماشین نمایش می‌دهد (از نسخه 1.15.0، به بخش «قالب پرس‌وجو (QUERY FORMAT)» در زیر مراجعه کنید).
.IP "\fB\-\-list\fR \fIname\fR" 4
.IX Item "--list name"
تمام مقصدهای گروه پیوند را نمایش می‌دهد.
.IP "\fB\-\-config\fR \fIname\fR" 4
.IX Item "--config name"
جایگزین‌های موجود برای یک گروه پیوند را نشان داده و به کاربر اجازه می‌دهد تا به‌صورت تعاملی مشخص کند که از کدام‌یک استفاده شود.
گروه پیوند به‌روزرسانی می‌شود.
.IP \fB\-\-help\fR 4
.IX Item "--help"
پیام راهنمای نحوه استفاده را نمایش داده و خارج می‌شود.
.IP \fB\-\-version\fR 4
.IX Item "--version"
اطلاعات نسخه را نمایش داده و خارج می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-\-altdir\fR \fIدایرکتوری\fR" 4
.IX Item "--altdir directory"
دایرکتوری جایگزین‌ها را زمانی که لازم است با حالت پیش‌فرض تفاوت داشته باشد مشخص می‌کند.
مقدار پیش‌فرض آن
\(Fo\fI/etc/alternatives\fR\(Fc
است.
.IP "\fB\-\-admindir\fR \fIدایرکتوری\fR" 4
.IX Item "--admindir directory"
دایرکتوری مدیریتی را زمانی که باید متفاوت از حالت پیش‌فرض باشد مشخص می‌کند.
اگر
\&\fBDPKG_ADMINDIR\fR
تنظیم نشده باشد، مقدار پیش‌فرض آن
\(Fo\fI/var/lib/dpkg/alternatives\fR\(Fc
خواهد بود.
.IP "\fB\-\-instdir\fR \fIدایرکتوری\fR" 4
.IX Item "--instdir directory"
دایرکتوری نصبی را که پیوندهای جایگزین در آن ایجاد می‌شوند مشخص می‌کند (از نسخه 1.20.1).
اگر
\&\fBDPKG_ROOT\fR
تنظیم نشده باشد، مقدار پیش‌فرض آن
\(Fo\fI/\fR\(Fc
است.
.IP "\fB\-\-root\fR \fIدایرکتوری\fR" 4
.IX Item "--root directory"
دایرکتوری ریشه را مشخص می‌کند (از نسخه 1.20.1).
این کار همچنین دایرکتوری‌های جایگزین‌ها، نصب و مدیریت را متناسب با آن تنظیم می‌کند.
اگر
\&\fBDPKG_ROOT\fR
تنظیم نشده باشد، مقدار پیش‌فرض آن
\(Fo\fI/\fR\(Fc
است.
.IP "\fB\-\-log\fR \fIفایل\fR" 4
.IX Item "--log file"
فایل لاگ را زمانی که باید با حالت پیش‌فرض (/var/log/alternatives.log) متفاوت باشد مشخص می‌کند (از نسخه 1.15.0).
.IP \fB\-\-force\fR 4
.IX Item "--force"
امکان جایگزینی یا حذف هر فایل واقعیِ نصب‌شده در مکانی که باید پیوند جایگزین نصب یا حذف شود را فراهم می‌سازد.
.IP \fB\-\-skip\-auto\fR 4
.IX Item "--skip-auto"
از اعلان پیکربندی برای جایگزین‌هایی که به درستی در حالت خودکار پیکربندی شده‌اند صرف‌نظر می‌کند.
این گزینه فقط همراه با
\&\fB\-\-config\fR
یا
\&\fB\-\-all\fR
کاربرد دارد.
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
هیچ پیامی تولید نمی‌کند مگر اینکه خطایی رخ دهد.
.IP \fB\-\-verbose\fR 4
.IX Item "--verbose"
توضیحات و پیام‌های بیشتری درباره اقدامات در حال انجام تولید می‌کند.
.IP \fB\-\-debug\fR 4
.IX Item "--debug"
پیام‌های باز هم بیشتری (مفید برای اشکال‌زدایی) درباره اقدامات در حال انجام ارائه می‌دهد (از نسخه 1.19.3).
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
.IP \fB0\fR 4
.IX Item "0"
عملیات درخواستی با موفقیت انجام شد.
.IP \fB2\fR 4
.IX Item "2"
هنگام تجزیه خط فرمان یا انجام عملیات مشکلی رخ داده است.
.SH "محیط (ENVIRONMENT)"
.IX Header "ENVIRONMENT"
.IP \fBDPKG_ROOT\fR 4
.IX Item "DPKG_ROOT"
در صورت تنظیم بودن و عدم تعیین گزینه‌های
\&\fB\-\-instdir\fR
یا
\&\fB\-\-root\fR،
به عنوان دایرکتوری ریشه سیستم‌فایل استفاده خواهد شد.
.IP \fBDPKG_ADMINDIR\fR 4
.IX Item "DPKG_ADMINDIR"
در صورت تنظیم بودن و عدم تعیین گزینه
\&\fB\-\-admindir\fR،
به عنوان دایرکتوری مدیریتی پایه استفاده خواهد شد.
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.IP \fI/etc/alternatives/\fR 4
.IX Item "/etc/alternatives/"
دایرکتوری پیش‌فرض جایگزین‌ها.
می‌توان آن را با گزینه
\&\fB\-\-altdir\fR
تغییر داد.
.IP \fI/var/lib/dpkg/alternatives/\fR 4
.IX Item "/var/lib/dpkg/alternatives/"
دایرکتوری مدیریتی پیش‌فرض.
می‌توان آن را با گزینه
\&\fB\-\-admindir\fR
تغییر داد.
.SH "قالب پرس‌وجو (QUERY FORMAT)"
.IX Header "QUERY FORMAT"
قالب
\&\fB\-\-query\fR
از یک قالب مسطح شبیه به RFC822 استفاده می‌کند.
این خروجی از
\&\fIn\fR + 1
بند (stanza) تشکیل شده است که در آن
\&\fIn\fR
تعداد جایگزین‌های موجود در گروه پیوند مورد پرس‌وجو است.
نخستین بند شامل فیلدهای زیر است:
.IP "\fBName:\fR \fIname\fR" 4
.IX Item "Name: name"
نام جایگزین در دایرکتوری جایگزین‌ها.
.IP "\fBLink:\fR \fIlink\fR" 4
.IX Item "Link: link"
نام عمومی جایگزین.
.IP "\fBSlaves:\fR \fIlist\-of\-slaves\fR" 4
.IX Item "Slaves: list-of-slaves"
هنگامی که این فیلد وجود داشته باشد، خطوط
\&\fBبعدی\fR
شامل تمام پیوندهای وابسته مرتبط با پیوند اصلی جایگزین خواهند بود.
در هر خط یک پیوند وابسته قرار دارد.
هر خط شامل یک فاصله، نام عمومی جایگزین وابسته، یک فاصله دیگر، و مسیر پیوند وابسته است.
.IP "\fBStatus:\fR \fIstatus\fR" 4
.IX Item "Status: status"
وضعیت جایگزین (شامل
\&\fBauto\fR
یا
\&\fBmanual\fR).
.IP "\fBBest:\fR \fIbest\-choice\fR" 4
.IX Item "Best: best-choice"
مسیر بهترین جایگزین برای این گروه پیوند.
اگر هیچ جایگزینی در دسترس نباشد، این فیلد نمایش داده نمی‌شود.
.IP "\fBValue:\fR \fIcurrently\-selected\-alternative\fR" 4
.IX Item "Value: currently-selected-alternative"
مسیر جایگزینی که هم‌اکنون انتخاب شده است.
همچنین می‌تواند مقدار ویژه
\&\fBnone\fR
را بگیرد که در صورت عدم وجود پیوند استفاده می‌شود.
.PP
سایر بندها جایگزین‌های موجود در گروه پیوند مورد پرس‌وجو را شرح می‌دهند:
.IP "\fBAlternative:\fR \fIpath\-of\-this\-alternative\fR" 4
.IX Item "Alternative: path-of-this-alternative"
مسیر منتهی به جایگزین این بند.
.IP "\fBPriority:\fR \fIpriority\-value\fR" 4
.IX Item "Priority: priority-value"
مقدار اولویت این جایگزین.
.IP "\fBSlaves:\fR \fIlist\-of\-slaves\fR" 4
.IX Item "Slaves: list-of-slaves"
هنگامی که این فیلد وجود داشته باشد، خطوط
\&\fBبعدی\fR
شامل تمام جایگزین‌های وابسته مرتبط با پیوند اصلی جایگزین خواهند بود.
در هر خط یک جایگزین وابسته قرار دارد.
هر خط شامل یک فاصله، نام عمومی جایگزین وابسته، یک فاصله دیگر، و مسیر جایگزین وابسته است.
.SS "مثال (EXAMPLE)"
.IX Subsection "Example"
.Vb 12
\& $ update\-alternatives \-\-query editor
\& Name: editor
\& Link: /usr/bin/editor
\& Slaves:
\&  editor.1.gz /usr/share/man/man1/editor.1.gz
\&  editor.fr.1.gz /usr/share/man/fr/man1/editor.1.gz
\&  editor.it.1.gz /usr/share/man/it/man1/editor.1.gz
\&  editor.pl.1.gz /usr/share/man/pl/man1/editor.1.gz
\&  editor.ru.1.gz /usr/share/man/ru/man1/editor.1.gz
\& Status: auto
\& Best: /usr/bin/vim.basic
\& Value: /usr/bin/vim.basic
\&
\& Alternative: /bin/ed
\& Priority: \-100
\& Slaves:
\&  editor.1.gz /usr/share/man/man1/ed.1.gz
\&
\& Alternative: /usr/bin/vim.basic
\& Priority: 50
\& Slaves:
\&  editor.1.gz /usr/share/man/man1/vim.1.gz
\&  editor.fr.1.gz /usr/share/man/fr/man1/vim.1.gz
\&  editor.it.1.gz /usr/share/man/it/man1/vim.1.gz
\&  editor.pl.1.gz /usr/share/man/pl/man1/vim.1.gz
\&  editor.ru.1.gz /usr/share/man/ru/man1/vim.1.gz
.Ve
.SH "عیب‌یابی (DIAGNOSTICS)"
.IX Header "DIAGNOSTICS"
با گزینه
\&\fB\-\-verbose\fR،
دستور
\&\fBupdate\-alternatives\fR
گزارش‌های مفصلی درباره فعالیت‌های خود در کانال خروجی استاندارد تولید می‌کند.
در صورت بروز مشکل،
\&\fBupdate\-alternatives\fR
پیام‌های خطا را در کانال خطای استاندارد منتشر کرده و وضعیت خروج ۲ را برمی‌گرداند.
این پیام‌های عیب‌یابی باید خودتوضیح‌دهنده باشند؛
اگر آن‌ها را چنین نیافتید، لطفاً این مورد را به عنوان باگ گزارش کنید.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
چندین بسته وجود دارند که ویرایشگر متنی سازگار با
\&\fBvi\fR
ارائه می‌دهند، مانند
\&\fBnvi\fR
و
\&\fBvim\fR.
اینکه کدام‌یک استفاده شود توسط گروه پیوند
\&\fBvi\fR
کنترل می‌شود که شامل پیوندهایی برای خود برنامه و صفحه راهنمای مرتبط با آن است.
.PP
برای نمایش بسته‌های موجود که
\&\fBvi\fR
را ارائه می‌دهند و تنظیمات فعلی آن، از عملیات
\&\fB\-\-display\fR
استفاده کنید:
.Sp
.Vb 1
\& update\-alternatives \-\-display vi
.Ve
.PP
برای انتخاب یک پیاده‌سازی خاص از
\&\fBvi\fR،
این دستور را به عنوان کاربر ریشه اجرا کرده و سپس یک شماره را از فهرست انتخاب کنید:
.Sp
.Vb 1
\& update\-alternatives \-\-config vi
.Ve
.PP
برای بازگشت به حالتی که در آن پیاده‌سازی
\&\fBvi\fR
به‌طور خودکار انتخاب شود، این دستور را به عنوان کاربر ریشه اجرا کنید:
.Sp
.Vb 1
\& update\-alternatives \-\-auto vi
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBln\fR\|(1)،
FHS (استاندارد سلسله‌مراتب سیستم‌فایل).