.\" -*- 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 "deb-triggers 5"
.TH deb-triggers 5 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)"
deb\-triggers \- تریگرهای بسته
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBdebian/triggers\fR, \fBdebian/\fR\fIbinary\-package\fR\fB.triggers\fR,
\&\fBDEBIAN/triggers\fR
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
یک بسته با گنجاندن یک فایل \fItriggers\fR در بایگانی کنترلی خود (یعنی \fIDEBIAN/triggers\fR در طول ساخت بسته)، رابطه خود با یک یا چند تریگر را اعلان می‌کند.
.PP
این فایل حاوی دستورالعمل‌ها، یکی در هر خط، است.
فاصله‌های خالی ابتدا و انتهای خط و هر چیزی پس از اولین \fB#\fR در هر خط حذف شده و خطوط خالی نادیده گرفته می‌شوند.
.PP
دستورالعمل‌های کنترلی تریگر که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.IP "\fBinterest\fR \fItrigger\-name\fR" 4
.IX Item "interest trigger-name"
.PD 0
.IP "\fBinterest\-await\fR \fItrigger\-name\fR" 4
.IX Item "interest-await trigger-name"
.IP "\fBinterest\-noawait\fR \fItrigger\-name\fR" 4
.IX Item "interest-noawait trigger-name"
.PD
مشخص می‌کند که بسته به تریگر نام‌برده علاقه‌مند است (به آن نیاز دارد).
تمام تریگرهایی که یک بسته به آن‌ها علاقه‌مند است باید با استفاده از این دستورالعمل در فایل کنترلی تریگرها فهرست شوند.
.Sp
گونه‌های \(lqawait\(rq، بسته به نحوه فعال‌سازی تریگر، بسته فعال‌کننده را در وضعیت triggers\-awaited (در انتظار تریگر) قرار می‌دهند.
گونه \(lqnoawait\(rq بسته‌های فعال‌کننده را در وضعیت triggers\-awaited قرار نمی‌دهد، حتی اگر بسته فعال‌کننده یک فعال‌سازی \(lqawait\(rq را اعلان کرده باشد (خواه با یک دستورالعمل \fBactivate\-await\fR یا \fBactivate\fR، یا با استفاده از گزینه خط فرمان \fB\-\-no\-await\fR در \fBdpkg\-trigger\fR).
گونه \(lqnoawait\(rq باید زمانی استفاده شود که قابلیت ارائه‌شده توسط تریگر حیاتی نیست.
.IP "\fBactivate\fR \fItrigger\-name\fR" 4
.IX Item "activate trigger-name"
.PD 0
.IP "\fBactivate\-await\fR \fItrigger\-name\fR" 4
.IX Item "activate-await trigger-name"
.IP "\fBactivate\-noawait\fR \fItrigger\-name\fR" 4
.IX Item "activate-noawait trigger-name"
.PD
ترتیبی می‌دهد که تغییرات در وضعیت این بسته، تریگر مشخص‌شده را فعال کند.
تریگر در ابتدای عملیات‌های زیر فعال خواهد شد: unpack (استخراج)، configure (پیکربندی)، remove (حذف، از جمله به سود بسته‌ای دارای تعارض)، purge (پاکسازی کامل) و deconfigure (لغو پیکربندی).
.Sp
گونه‌های \(lqawait\(rq بسته فعال‌کننده را تنها در صورتی در وضعیت triggers\-awaited قرار می‌دهند که دستورالعمل interest نیز \(lqawait\(rq باشد.
گونه \(lqnoawait\(rq هرگز بسته‌های فعال‌کننده را در وضعیت triggers\-awaited قرار نمی‌دهد.
گونه \(lqnoawait\(rq باید زمانی استفاده شود که قابلیت ارائه‌شده توسط تریگر حیاتی نیست.
.Sp
اگر این بسته در حین استخراج بسته‌ای دیگر ناپدید شود (disappear)، تریگر هنگامی فعال خواهد شد که این ناپدید شدن در اواخر عملیات استخراج ثبت شود.
پردازش تریگر و انتقال از وضعیت triggers\-awaited به installed، باعث فعال‌سازی تریگر نمی‌شود.
در مورد unpack (استخراج)، تریگرهای ذکرشده در هر دو نسخه قدیمی و جدید بسته فعال خواهند شد.
.PP
دستورالعمل‌های ناشناخته به عنوان خطا در نظر گرفته می‌شوند و از نصب بسته جلوگیری خواهند کرد.
.PP
در صورت امکان، همواره باید گونه‌های \(lq\-noawait\(rq ترجیح داده شوند؛ زیرا بسته‌های فعال‌کننده در وضعیت triggers\-awaited قرار نمی‌گیرند و در نتیجه می‌توانند بلافاصله و بدون نیاز به پردازش تریگر پیکربندی شوند.
اگر بسته‌های فعال‌کننده از وابستگی‌های بسته‌های ارتقایافته دیگر باشند، این کار از اجرای زودهنگام پردازش تریگر جلوگیری کرده و این امکان را فراهم می‌سازد که تریگر فقط یک‌بار به عنوان یکی از مراحل پایانی ارتقا اجرا شود.
.PP
گونه‌های \(lq\-noawait\(rq از dpkg نسخه 1.16.1 پشتیبانی می‌شوند و در صورت استفاده با نسخه‌های قدیمی‌تر dpkg با خطا مواجه خواهند شد.
.PP
گونه‌های نام مستعار \(lq\-await\(rq از dpkg نسخه 1.17.21 پشتیبانی می‌شوند و در صورت استفاده با نسخه‌های قدیمی‌تر dpkg با خطا مواجه خواهند شد.
.PP
هنگامی که یک بسته دستورالعمل \fBinterest\-noawait\fR را ارائه می‌دهد، هرگونه فعال‌سازی، بسته فعال‌کننده را صرف‌نظر از حالت انتظار درخواست‌شده توسط فعال‌سازی (خواه \(lqawait\(rq یا \(lqnoawait\(rq) در حالت \(lqnoawait\(rq قرار می‌دهد.
هنگامی که یک بسته دستورالعمل \fBinterest\fR یا \fBinterest\-await\fR را ارائه می‌دهد، هرگونه فعال‌سازی بسته فعال‌کننده را بسته به نحوه فعال‌سازی آن در حالت \(lqawait\(rq یا \(lqnoawait\(rq قرار می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBdpkg\-trigger\fR\|(1),
\&\fBdpkg\fR\|(1),
\&\fB/usr/share/doc/dpkg/spec/triggers.txt\fR.