.\" -*- 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-statoverride 1"
.TH dpkg-statoverride 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\-statoverride \- تغییر و لغو مالکیت و مجوزهای فایل‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdpkg\-statoverride\fR
[\fIگزینه\fR...] \fIدستور\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
«\fBجایگزینی‌های وضعیت (stat overrides)\fR» راهکاری است برای گفتن به
\&\fBdpkg\fR\|(1)
جهت استفاده از مالک یا حالت دسترسی (mode) متفاوت برای یک مسیر هنگام نصب یک بسته (این موضوع برای هر شیء سیستم‌فایلی که
\&\fBdpkg\fR
با آن سر و کار دارد، از جمله دایرکتوری‌ها، دستگاه‌ها و غیره اعمال می‌شود).
از این قابلیت می‌توان برای وادار کردن برنامه‌هایی که معمولاً setuid هستند به نصب بدون پرچم setuid، یا قابلیت اجرا تنها توسط یک گروه خاص استفاده کرد.
.PP
ابزار
\&\fBdpkg\-statoverride\fR
ابزاری برای مدیریت فهرست جایگزینی‌های وضعیت است.
این ابزار سه عملکرد پایه دارد: افزودن، حذف و فهرست کردن جایگزینی‌ها.
.SH "دستورات (COMMANDS)"
.IX Header "COMMANDS"
.IP "\fB\-\-add\fR \fIuser group mode path\fR" 4
.IX Item "--add user group mode path"
افزودن یک جایگزینی برای
\&\fIpath\fR.
هنگام استفاده از این دستور، نیازی نیست
\&\fIpath\fR
وجود داشته باشد یا برای
\&\fBdpkg\fR
شناخته‌شده باشد؛ جایگزینی ذخیره شده و بعداً استفاده خواهد شد.
کاربران و گروه‌ها را می‌توان با نامشان (به عنوان مثال
\&\fBroot\fR
یا
\&\fBnobody\fR)،
یا با شماره‌شان با قرار دادن پیشوند
\(oq\fB#\fR\(cq
قبل از شماره (برای نمونه
\&\fB#0\fR
یا
\&\fB#65534\fR)
مشخص کرد.
حالت دسترسی
\&\fImode\fR
باید در مبنای هشت (اکتال) مشخص شود.
.Sp
اگر گزینه
\&\fB\-\-update\fR
مشخص شده باشد و
\&\fIpath\fR
موجود باشد، بلافاصله به مالک و حالت دسترسی جدید تنظیم می‌شود.
.IP "\fB\-\-remove\fR \fIpath\fR" 4
.IX Item "--remove path"
حذف یک جایگزینی برای
\&\fIpath\fR؛
وضعیت فعلی
\&\fIpath\fR
توسط این دستور بدون تغییر باقی می‌ماند.
.IP "\fB\-\-list\fR [\fIglob\-pattern\fR]" 4
.IX Item "--list [glob-pattern]"
فهرست کردن تمام جایگزینی‌ها.
اگر یک الگوی تطبیق (glob) مشخص شود، خروجی به جایگزینی‌هایی که با الگو مطابقت دارند محدود می‌شود.
.IP \fB\-\-help\fR 4
.IX Item "--help"
نمایش پیام راهنمای استفاده و خروج.
.IP \fB\-\-force\-help\fR 4
.IX Item "--force-help"
ارائه راهنما درباره گزینه‌های
\&\fB\-\-force\-\fR\fIthing\fR
(از نسخه 1.19.5 dpkg).
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش نسخه و خروج.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-\-admindir\fR \fIdirectory\fR" 4
.IX Item "--admindir directory"
تنظیم دایرکتوری مدیریتی به
\&\fIdirectory\fR.
اینجا محلی است که فایل
\&\fIstatoverride\fR
در آن ذخیره می‌شود.
اگر
\&\fBDPKG_ADMINDIR\fR
تنظیم نشده باشد، مقدار پیش‌فرض
\(Fo\fI/var/lib/dpkg\fR\(Fc
است.
.IP "\fB\-\-instdir\fR \fIdirectory\fR" 4
.IX Item "--instdir directory"
تنظیم دایرکتوری نصب، که به دایرکتوری محل نصب بسته‌ها اشاره دارد (از نسخه 1.19.2 dpkg).
اگر
\&\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
تنظیم می‌کند (از نسخه 1.19.2 dpkg).
.IP \fB\-\-force\-\fR\fIthings\fR 4
.IX Item "--force-things"
.PD 0
.IP "\fB\-\-no\-force\-\fR\fIthings\fR, \fB\-\-refuse\-\fR\fIthings\fR" 4
.IX Item "--no-force-things, --refuse-things"
.PD
اجبار یا رد کردن (عبارت‌های
\&\fBno\-force\fR
و
\&\fBrefuse\fR
معنای یکسانی دارند) انجام برخی امور (از نسخه 1.19.5 dpkg).
\&\fIthings\fR
فهرستی از موارد جداشده با کاما است که در زیر مشخص شده‌اند.
گزینه
\&\fB\-\-force\-help\fR
پیامی حاوی شرح آن‌ها نمایش می‌دهد.
موارد نشانه‌گذاری‌شده با (*) به طور پیش‌فرض اجباری هستند.
.Sp
\&\fBهشدار\fR: این گزینه‌ها اغلب فقط برای استفاده افراد متخصص در نظر گرفته شده‌اند.
استفاده از آن‌ها بدون درک کامل اثراتشان ممکن است کل سیستم شما را مختل کند.
.RS 4
.IP \fBall\fR: 4
.IX Item "all:"
فعال (یا غیرفعال) کردن تمام گزینه‌های اجبار.
.IP \fBstatoverride\-add\fR: 4
.IX Item "statoverride-add:"
بازنویسی روی یک جایگزینی وضعیت موجود هنگام افزودن آن (از نسخه 1.19.5 dpkg).
.IP \fBstatoverride\-remove\fR: 4
.IX Item "statoverride-remove:"
نادیده گرفتن نبود جایگزینی وضعیت هنگام حذف آن (از نسخه 1.19.5 dpkg).
.IP \fBsecurity\-mac\fR(*): 4
.IX Item "security-mac(*):"
استفاده از امنیت مبتنی بر کنترل‌های دسترسی اجباری (MAC) ویژه پلتفرم هنگام نصب فایل‌ها در سیستم‌فایل (از نسخه 1.19.5 dpkg).
در سیستم‌های لینوکس این پیاده‌سازی از SELinux استفاده می‌کند.
.IP \fBnot\-root\fR: 4
.IX Item "not-root:"
تلاش برای نصب یا حذف موارد حتی در صورتی که کاربر ریشه نباشد (از نسخه 1.21.8 dpkg).
.RE
.RS 4
.RE
.IP \fB\-\-force\fR 4
.IX Item "--force"
اجبار انجام یک عملیات، حتی اگر بررسی‌های صحت‌سنجی از انجام آن جلوگیری کنند.
این گزینه برای بازنویسی روی یک جایگزینی موجود لازم است.
این گزینه منسوخ شده است (از نسخه 1.19.5 dpkg) و با
\&\fB\-\-force\-all\fR
جایگزین شده است.
.IP \fB\-\-update\fR 4
.IX Item "--update"
تلاش فوری برای تغییر مالک و دسترسی
\&\fIpath\fR
به مقادیر جدید در صورت موجود بودن آن.
.IP \fB\-\-quiet\fR 4
.IX Item "--quiet"
ارائه توضیحات کمتر درباره عملیات در حال انجام (کاهش پرگویی).
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
.IP \fB0\fR 4
.IX Item "0"
عملیات درخواستی با موفقیت انجام شد.
.IP \fB1\fR 4
.IX Item "1"
برای
\&\fB\-\-list\fR،
اگر هیچ جایگزینی وجود نداشته باشد یا هیچ‌کدام با الگوی داده‌شده تطابق نداشته باشند.
.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
مشخص نشده باشند، به عنوان دایرکتوری ریشه سیستم‌فایل استفاده خواهد شد (از نسخه 1.19.2 dpkg).
.IP \fBDPKG_ADMINDIR\fR 4
.IX Item "DPKG_ADMINDIR"
اگر تنظیم شده باشد و گزینه‌های
\&\fB\-\-admindir\fR
یا
\&\fB\-\-root\fR
مشخص نشده باشند، به عنوان دایرکتوری داده‌های
\&\fBdpkg\fR
استفاده خواهد شد.
.IP \fBDPKG_DEBUG\fR 4
.IX Item "DPKG_DEBUG"
تنظیم ماسک اشکال‌زدایی (از نسخه 1.21.10 dpkg) بر اساس یک مقدار هشت‌هشتی (اکتال).
پرچم‌های پذیرفته‌شده فعلی در گزینه
\&\fBdpkg \-\-debug\fR
شرح داده شده‌اند، اما ممکن است همه این پرچم‌ها روی این برنامه اثر نداشته باشند.
.IP \fBDPKG_FORCE\fR 4
.IX Item "DPKG_FORCE"
اگر تنظیم شده باشد و هیچ‌یک از گزینه‌های
\&\fB\-\-force\-\fR\fI...\fR
مشخص نشده باشند، به عنوان گزینه‌های اجبار برای استفاده در نظر گرفته خواهد شد (از نسخه 1.19.5 dpkg).
.IP \fBDPKG_COLORS\fR 4
.IX Item "DPKG_COLORS"
تنظیم حالت رنگی (از نسخه 1.18.5 dpkg).
مقادیر پذیرفته‌شده فعلی عبارتند از:
\&\fBauto\fR
(پیش‌فرض)،
\&\fBalways\fR
و
\&\fBnever\fR.
.IP \fBDPKG_NLS\fR 4
.IX Item "DPKG_NLS"
اگر تنظیم شود، برای تصمیم‌گیری در مورد فعال‌سازی پشتیبانی از زبان بومی (Native Language Support)، که به عنوان پشتیبانی بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، استفاده خواهد شد (از نسخه 1.22.7 dpkg).
مقادیر پذیرفته‌شده عبارتند از:
\&\fB0\fR
و
\&\fB1\fR
(پیش‌فرض).
.IP \fBDPKG_PATH_PASSWD\fR 4
.IX Item "DPKG_PATH_PASSWD"
تنظیم مسیر فایل
\&\fIpasswd\fR
سیستم.
این مسیر نسبت به دایرکتوری
\&\fB\-\-root\fR
است.
مقدار پیش‌فرض
\&\fI/etc/passwd\fR
است.
.Sp
از نسخه 1.22.16 dpkg.
.IP \fBDPKG_PATH_GROUP\fR 4
.IX Item "DPKG_PATH_GROUP"
تنظیم مسیر فایل
\&\fIgroup\fR
سیستم.
این مسیر نسبت به دایرکتوری
\&\fB\-\-root\fR
است.
مقدار پیش‌فرض
\&\fI/etc/group\fR
است.
.Sp
از نسخه 1.22.16 dpkg.
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
.IP \fI/var/lib/dpkg/statoverride\fR 4
.IX Item "/var/lib/dpkg/statoverride"
فایلی که شامل فهرست فعلی جایگزینی‌های وضعیت در سیستم است.
این فایل در دایرکتوری مدیریتی
\&\fBdpkg\fR،
در کنار سایر فایل‌های مهم برای
\&\fBdpkg\fR
مانند
\&\fIstatus\fR
یا
\&\fIavailable\fR
قرار دارد.
.Sp
\&\fBنکته\fR:
\&\fBdpkg\-statoverride\fR
پیش از جایگزین کردن این فایل با فایل جدید، نسخه قدیمی آن را با پسوند
\(lq\-old\(rq
حفظ می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdpkg\fR\|(1).