.\" -*- 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 "dpkg-divert 1"
.TH dpkg-divert 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)"
dpkg\-divert \- جایگزینی و تغییر مسیر نسخه بسته از یک فایل
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdpkg\-divert\fR
[\fIگزینه\fR...]
\&\fIدستور\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
\&\fBdpkg\-divert\fR
ابزاری است که برای برپایی و به‌روزرسانی فهرست تغییر مسیرها (انحراف‌ها) استفاده می‌شود.
.PP
\fIتغییر مسیر فایل‌ها\fR روشی است برای وادار کردن
\&\fBdpkg\fR\|(1)
به نصب نکردن یک فایل در مکان اصلی آن، بلکه در یک مکان \fIمنحرف‌شده\fR.
تغییر مسیرها می‌توانند توسط اسکریپت‌های نگه‌دارنده بسته جهت کنار گذاشتن یک فایل هنگام بروز تداخل به کار روند.
همچنین مدیران سیستم می‌توانند از آن برای جایگزینی فایل پیکربندی یک بسته، یا در هر زمانی که لازم است برخی فایل‌ها (که به عنوان \(lqconffiles\(rq علامت‌گذاری نشده‌اند) در حین نصب نسخه جدیدتری از بسته حاوی آن فایل‌ها توسط \fBdpkg\fR دست‌نخورده حفظ شوند، استفاده کنند.
.SH "دستورات (COMMANDS)"
.IX Header "COMMANDS"
.IP "[\fB\-\-add\fR] \fIfile\fR" 4
.IX Item "[--add] file"
افزودن یک تغییر مسیر برای \fIfile\fR.
در حال حاضر نام فایل تغییر داده نمی‌شود، گزینه \fB\-\-rename\fR را ببینید.
.IP "\fB\-\-remove\fR \fIfile\fR" 4
.IX Item "--remove file"
حذف یک تغییر مسیر برای \fIfile\fR.
در حال حاضر نام فایل تغییر داده نمی‌شود، گزینه \fB\-\-rename\fR را ببینید.
.IP "\fB\-\-list\fR [\fIglob\-pattern\fR]" 4
.IX Item "--list [glob-pattern]"
فهرست کردن تمام تغییر مسیرها، یا مواردی که با الگوی \fIglob\-pattern\fR مطابقت دارند.
.IP "\fB\-\-listpackage\fR \fIfile\fR" 4
.IX Item "--listpackage file"
چاپ نام بسته‌ای که \fIfile\fR را تغییر مسیر می‌دهد (از dpkg 1.15.0 به بعد).
اگر \fIfile\fR به‌صورت محلی تغییر مسیر یافته باشد عبارت LOCAL و اگر فایل تغییر مسیر نیافته باشد هیچ چیزی چاپ نمی‌کند.
.IP "\fB\-\-truename\fR \fIfile\fR" 4
.IX Item "--truename file"
چاپ نام واقعی یک فایل تغییرمسیریافته.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-\-admindir\fR \fIdirectory\fR" 4
.IX Item "--admindir directory"
تنظیم دایرکتوری مدیریتی به \fIdirectory\fR.
در صورتی که \fBDPKG_ADMINDIR\fR مقداردهی نشده باشد، مقدار پیش‌فرض \(Fo\fI/var/lib/dpkg\fR\(Fc خواهد بود.
.IP "\fB\-\-instdir\fR \fIdirectory\fR" 4
.IX Item "--instdir directory"
تنظیم دایرکتوری نصب، که به دایرکتوری محل نصب بسته‌ها اشاره دارد (از dpkg 1.19.2 به بعد).
در صورتی که \fBDPKG_ROOT\fR مقداردهی نشده باشد، مقدار پیش‌فرض \(Fo\fI/\fR\(Fc خواهد بود.
.IP "\fB\-\-root\fR \fIdirectory\fR" 4
.IX Item "--root directory"
تنظیم دایرکتوری ریشه به \fBdirectory\fR، که در صورت تعیین نشدن \fBDPKG_ROOT\fR دایرکتوری نصب را روی \(Fo\fIdirectory\fR\(Fc و دایرکتوری مدیریتی را روی \(Fo\fIdirectory\fR\fB/var/lib/dpkg\fR\(Fc تنظیم می‌کند (از dpkg 1.19.2 به بعد).
.IP "\fB\-\-divert\fR \fIdivert\-to\fR" 4
.IX Item "--divert divert-to"
\&\fIdivert\-to\fR مکانی است که نسخه‌های \fIfile\fR، آن‌چنان که توسط بسته‌های دیگر ارائه می‌شوند، به آنجا تغییر مسیر داده خواهند شد.
.IP \fB\-\-local\fR 4
.IX Item "--local"
مشخص می‌کند که نسخه‌های تمام بسته‌ها از این فایل تغییر مسیر داده شوند.
این بدان معناست که هیچ استثنایی وجود ندارد و هر بسته‌ای نصب شود، این فایل منحرف خواهد شد.
مدیر سیستم می‌تواند از این گزینه برای نصب نسخه اصلاح‌شده محلی استفاده کند.
.IP "\fB\-\-package\fR \fIpackage\fR" 4
.IX Item "--package package"
\&\fIpackage\fR نام بسته‌ای است که نسخه آن از \fIfile\fR تغییر مسیر داده نخواهد شد؛
به این معنی که \fIfile\fR برای تمام بسته‌ها به جز \fIpackage\fR تغییر مسیر می‌یابد.
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
حالت بی‌صدا؛ یعنی خروجی پرگویی تولید نشود.
.IP \fB\-\-rename\fR 4
.IX Item "--rename"
فایل را واقعاً به کناری (یا به جای قبلی‌اش) منتقل می‌کند.
در صورتی که فایل مقصد از قبل وجود داشته باشد،
\&\fBdpkg\-divert\fR
عملیات را لغو خواهد کرد.
این رفتار رایجی است که برای تغییر مسیر فایل‌های مربوط به مجموعه بسته‌های غیرضروری (\fBغیر\-Essential\fR) به کار می‌رود (برای جزئیات بیشتر گزینه \fB\-\-no\-rename\fR را ببینید).
.IP \fB\-\-no\-rename\fR 4
.IX Item "--no-rename"
مشخص می‌کند که هنگام افزودن یا حذف تغییر مسیر در پایگاه‌داده، نام فایل نباید تغییر داده شود (از dpkg 1.19.1 به بعد).
این گزینه برای تغییر مسیر فایل‌های مجموعه بسته‌های ضروری (\fBEssential\fR) در نظر گرفته شده است،
جایی که ناپدید شدن موقت فایل اصلی غیرقابل‌قبول است چرا که می‌تواند سیستم را از کار بیندازد.
این رفتار پیش‌فرض است، که پس از پایان استفاده کاربران شناخته‌شده تغییر خواهد کرد،
اما زودتر از چرخه انتشار dpkg 1.23.x نخواهد بود.
.IP \fB\-\-test\fR 4
.IX Item "--test"
حالت آزمایشی؛ تغییری در عمل اعمال نمی‌شود و فقط مراحل به نمایش درمی‌آیند.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
نمایش پیام راهنمای نحوه استفاده و خروج.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش نگارش و خروج.
.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، به عنوان دایرکتوری ریشه سیستم‌فایل استفاده می‌شود (از dpkg 1.19.2 به بعد).
.IP \fBDPKG_ADMINDIR\fR 4
.IX Item "DPKG_ADMINDIR"
در صورت تنظیم شدن و مشخص نشدن گزینه‌های \fB\-\-admindir\fR یا \fB\-\-root\fR، به عنوان دایرکتوری داده‌های \fBdpkg\fR استفاده خواهد شد.
.IP \fBDPKG_MAINTSCRIPT_PACKAGE\fR 4
.IX Item "DPKG_MAINTSCRIPT_PACKAGE"
در صورت تنظیم شدن و مشخص نشدن گزینه‌های \fB\-\-local\fR و \fB\-\-package\fR، برنامه \fBdpkg\-divert\fR از آن به عنوان نام بسته استفاده خواهد کرد.
.IP \fBDPKG_DEBUG\fR 4
.IX Item "DPKG_DEBUG"
ماسک اشکال‌زدایی را از روی یک مقدار در مبنای هشت تنظیم می‌کند (از dpkg 1.21.10 به بعد).
فلگ‌های پذیرفته‌شده فعلی در توضیحات گزینه \fBdpkg \-\-debug\fR آمده‌اند، اما ممکن است همه این فلگ‌ها روی این برنامه تأثیرگذار نباشند.
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
حالت رنگی را تنظیم می‌کند (از dpkg 1.18.5 به بعد).
مقادیر پذیرفته‌شده فعلی عبارتند از: \fBauto\fR (پیش‌فرض)، \fBalways\fR و \fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
در صورت تنظیم، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support) که با عنوان بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود به کار می‌رود (از dpkg 1.22.7 به بعد).
مقادیر پذیرفته‌شده عبارتند از: \fB0\fR و \fB1\fR (پیش‌فرض).
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.IP \fI/var/lib/dpkg/diversions\fR 4
.IX Item "/var/lib/dpkg/diversions"
فایلی که حاوی فهرست کنونی تغییر مسیرهای سیستم است.
این فایل در دایرکتوری مدیریتی \fBdpkg\fR، همراه با دیگر فایل‌های مهم برای \fBdpkg\fR نظیر \fIstatus\fR یا \fIavailable\fR قرار دارد.
.Sp
\&\fBنکته\fR: \fBdpkg\-divert\fR پیش از جایگزینی این فایل با نسخه جدید، نسخه پیشین را با پسوند \fI\-old\fR نگه‌داری می‌کند.
.SH "نکات (NOTES)"
.IX Header "NOTES"
هنگام افزودن، حالت پیش‌فرض \fB\-\-local\fR و \fB\-\-divert\fR \fIoriginal\fR\fB.distrib\fR است.
هنگام حذف، در صورت مشخص شدن \fB\-\-package\fR یا \fB\-\-local\fR و \fB\-\-divert\fR، مقادیر آن‌ها باید مطابقت داشته باشند.
.PP
دایرکتوری‌ها نمی‌توانند توسط \fBdpkg\-divert\fR تغییر مسیر داده شوند.
.PP
هنگام تغییر مسیر کتابخانه‌های مشترک (shared libraries) باید دقت شود؛ چرا که \fBldconfig\fR\|(8) پیوند نمادین را بر اساس فیلد DT_SONAME تعبیه‌شده در کتابخانه ایجاد می‌کند.
از آنجا که \fBldconfig\fR به تغییر مسیرها اهمیتی نمی‌دهد (فقط \fBdpkg\fR از آن‌ها تبعیت می‌کند)، اگر یک کتابخانه تغییرمسیریافته دارای همان SONAME کتابخانه تغییرمسیرنیافته باشد، ممکن است در نهایت پیوند نمادین به کتابخانه تغییرمسیریافته اشاره کند.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
برای تغییر مسیر تمام نسخه‌های \fI/usr/bin/example\fR به \fI/usr/bin/example.foo\fR، یعنی هدایت تمام بسته‌های ارائه‌دهنده \fI/usr/bin/example\fR به نصب آن به عنوان \fI/usr/bin/example.foo\fR، با تغییر نام در صورت نیاز:
.PP
.Vb 1
\& dpkg\-divert \-\-divert /usr/bin/example.foo \-\-rename /usr/bin/example
.Ve
.PP
برای حذف آن تغییر مسیر:
.PP
.Vb 1
\& dpkg\-divert \-\-rename \-\-remove /usr/bin/example
.Ve
.PP
برای تغییر مسیر هر بسته‌ای که قصد نصب \fI/usr/bin/example\fR را دارد به \fI/usr/bin/example.foo\fR، به جز بسته اختصاصی خودتان به نام \fIwibble\fR:
.PP
.Vb 2
\& dpkg\-divert \-\-package wibble \-\-divert /usr/bin/example.foo \e
\&    \-\-rename /usr/bin/example
.Ve
.PP
برای حذف آن تغییر مسیر:
.PP
.Vb 1
\& dpkg\-divert \-\-package wibble \-\-rename \-\-remove /usr/bin/example
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdpkg\fR\|(1).