.\" -*- 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-trigger 1"
.TH dpkg-trigger 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-trigger \- ابزار فراخوانی و فعال‌سازی تریگرهای بسته
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
\&\fBdpkg\-trigger\fR
[\fIگزینه\fR...] \fItrigger\-name\fR
.PP
\&\fBdpkg\-trigger\fR
[\fIگزینه\fR...] \fIدستور\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
دستور
\&\fBdpkg\-trigger\fR
ابزاری برای فعال‌سازی صریح تریگرها و بررسی پشتیبانی از آن‌ها در
\&\fBdpkg\fR
در حال اجرا است.
.PP
این ابزار می‌تواند توسط اسکریپت‌های نگه‌دارنده (maintainer scripts) در شرایط پیچیده و مشروطی که تریگرهای فایلی یا دستورالعمل بیانی
\&\fBactivate\fR
در فایل کنترل تریگرها پاسخگوی نیاز نیستند، به کار رود. همچنین می‌تواند برای آزمایش و توسط مدیران سیستم استفاده شود (اما توجه داشته باشید که تریگرها در واقع توسط
\&\fBdpkg\-trigger\fR
اجرا نخواهند شد).
.PP
نحوهای نامعتبر و ناشناخته برای نام تریگر، برای
\&\fBdpkg\-trigger\fR
خطا محسوب می‌شوند.
.PP
این برنامه در dpkg نسخه 1.14.17 معرفی شد.
.SH "دستورها (COMMANDS)"
.IX Header "دستورها (COMMANDS)"
.IP \fB\-\-check\-supported\fR 4
.IX Item "--check-supported"
بررسی می‌کند که آیا
\&\fBdpkg\fR
در حال اجرا از تریگرها پشتیبانی می‌کند یا خیر (معمولاً از درون اسکریپت postinst فراخوانی می‌شود).
اگر نسخه
\&\fBdpkg\fR
با قابلیت پشتیبانی از تریگر اجرا شده باشد، با وضعیت
\&\fB0\fR
خارج می‌شود، و در غیر این صورت با وضعیت
\&\fB1\fR
همراه با یک پیام خطا در stderr خاتمه می‌یابد. با این حال، در شرایط عادی بهتر است تریگر مورد نظر را مستقیماً با
\&\fBdpkg\-trigger\fR
فعال کنید.
.IP "\fB\-?\fR, \fB\-\-help\fR" 4
.IX Item "-?, --help"
نمایش پیام راهنمای نحوه استفاده و خروج.
.IP \fB\-\-version\fR 4
.IX Item "--version"
نمایش نسخه برنامه و خروج.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP \fB\-\-admindir=\fR\fIdir\fR 4
.IX Item "--admindir=dir"
مکان پایگاه‌داده
\&\fBdpkg\fR
را تغییر می‌دهد. اگر متغیر محیطی
\&\fBDPKG_ADMINDIR\fR
تنظیم نشده باشد، مقدار پیش‌فرض آن
\fI/var/lib/dpkg\fR
خواهد بود.
.IP \fB\-\-root=\fR\fIdirectory\fR 4
.IX Item "--root=directory"
دایرکتوری ریشه را روی
\fIdirectory\fR
تنظیم می‌کند، که موجب می‌شود دایرکتوری مدیریتی روی
\(Fo\fIdirectory\fR/var/lib/dpkg\(Fc
قرار گیرد (از نسخه dpkg 1.21.0).
.IP \fB\-\-by\-package=\fR\fIpackage\fR 4
.IX Item "--by-package=package"
بازنویسی بسته منتظر تریگر (معمولاً توسط
\&\fBdpkg\fR
از طریق متغیر محیطی
\&\fBDPKG_MAINTSCRIPT_PACKAGE\fR
در اسکریپت‌های نگه‌دارنده تنظیم می‌شود که نام بسته‌ای که اسکریپت به آن تعلق دارد را مشخص می‌کند؛ این مقدار به صورت پیش‌فرض استفاده خواهد شد).
.IP \fB\-\-no\-await\fR 4
.IX Item "--no-await"
این گزینه ترتیبی می‌دهد که بسته فراخواننده
\fIT\fR
(در صورت وجود) نیازی به انتظار برای پردازش این تریگر نداشته باشد؛ بسته(های) ذی‌نفع
\fII\fR،
به فهرست بسته‌های منتظر پردازش تریگر برای
\fIT\fR
اضافه نخواهند شد و وضعیت
\fIT\fR
تغییری نمی‌کند. ممکن است
\fIT\fR
نصب‌شده در نظر گرفته شود، حتی اگر
\fII\fR
هنوز تریگر را پردازش نکرده باشد.
.IP \fB\-\-await\fR 4
.IX Item "--await"
این گزینه برعکس
\&\fB\-\-no\-await\fR
عمل می‌کند (از نسخه dpkg 1.17.21).
اگر بسته ذی‌نفع دستورالعمل \(lqnoawait\(rq را اعلان کرده باشد، این گزینه تأثیری نخواهد داشت. این رفتار در حال حاضر رفتار پیش‌فرض است.
.IP \fB\-\-no\-act\fR 4
.IX Item "--no-act"
فقط آزمایش انجام شود، در عمل چیزی تغییر نکند.
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "وضعیت خروج (EXIT STATUS)"
.IP \fB0\fR 4
.IX Item "0"
عملیات درخواستی با موفقیت انجام شد، یا دستور بررسی یا ارزیابی مقدار درست (true) برگرداند.
.IP \fB1\fR 4
.IX Item "1"
دستور بررسی یا ارزیابی مقدار نادرست (false) برگرداند.
.IP \fB2\fR 4
.IX Item "2"
خطای مهلک یا غیرقابل‌بازگشت به دلیل استفاده نامعتبر از خط فرمان، یا تعامل با سیستم، مانند دسترسی به پایگاه‌داده، تخصیص حافظه و غیره.
.SH "محیط (ENVIRONMENT)"
.IX Header "محیط (ENVIRONMENT)"
.IP \fBDPKG_ROOT\fR 4
.IX Item "DPKG_ROOT"
اگر تنظیم شده باشد و گزینه
\&\fB\-\-root\fR
مشخص نشده باشد، به عنوان دایرکتوری ریشه سیستم‌فایل استفاده می‌شود (از نسخه dpkg 1.21.0).
.IP \fBDPKG_ADMINDIR\fR 4
.IX Item "DPKG_ADMINDIR"
اگر تنظیم شده باشد و گزینه
\&\fB\-\-admindir\fR
مشخص نشده باشد، به عنوان دایرکتوری داده‌های
\&\fBdpkg\fR
استفاده می‌شود.
.IP \fBDPKG_DEBUG\fR 4
.IX Item "DPKG_DEBUG"
ماسک اشکال‌زدایی را از یک مقدار هشت‌هشتی (octal) تعیین می‌کند (از نسخه 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 "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
\&\fBdpkg\fR\|(1)،
\&\fBdeb\-triggers\fR\|(5)،
\&\fB/usr/share/doc/dpkg/spec/triggers.txt\fR.