dpkg-trigger(1)                   dpkg suite                   dpkg-trigger(1)


نام (NAME)
       dpkg-trigger - ابزار فراخوانی و فعال‌سازی تریگرهای بسته

خلاصه دستور (SYNOPSIS)
       dpkg-trigger [گزینه...] trigger-name

       dpkg-trigger [گزینه...] دستور

توضیحات (DESCRIPTION)
       دستور dpkg-trigger ابزاری برای فعال‌سازی صریح تریگرها و بررسی پشتیبانی
       از آن‌ها در dpkg در حال اجرا است.

       این ابزار می‌تواند توسط اسکریپت‌های نگه‌دارنده (maintainer scripts) در
       شرایط پیچیده و مشروطی که تریگرهای فایلی یا دستورالعمل بیانی activate در
       فایل کنترل تریگرها پاسخگوی نیاز نیستند، به کار رود. همچنین می‌تواند برای
       آزمایش و توسط مدیران سیستم استفاده شود (اما توجه داشته باشید که تریگرها
       در واقع توسط dpkg-trigger اجرا نخواهند شد).

       نحوهای نامعتبر و ناشناخته برای نام تریگر، برای dpkg-trigger خطا محسوب
       می‌شوند.

       این برنامه در dpkg نسخه 1.14.17 معرفی شد.

دستورها (COMMANDS)
       --check-supported
           بررسی می‌کند که آیا dpkg در حال اجرا از تریگرها پشتیبانی می‌کند یا
           خیر (معمولاً از درون اسکریپت postinst فراخوانی می‌شود).  اگر نسخه
           dpkg با قابلیت پشتیبانی از تریگر اجرا شده باشد، با وضعیت 0 خارج
           می‌شود، و در غیر این صورت با وضعیت 1 همراه با یک پیام خطا در stderr
           خاتمه می‌یابد. با این حال، در شرایط عادی بهتر است تریگر مورد نظر را
           مستقیماً با dpkg-trigger فعال کنید.

       -?, --help
           نمایش پیام راهنمای نحوه استفاده و خروج.

       --version
           نمایش نسخه برنامه و خروج.

گزینه‌ها (OPTIONS)
       --admindir=dir
           مکان پایگاه‌داده dpkg را تغییر می‌دهد. اگر متغیر محیطی DPKG_ADMINDIR
           تنظیم نشده باشد، مقدار پیش‌فرض آن /var/lib/dpkg خواهد بود.

       --root=directory
           دایرکتوری ریشه را روی directory تنظیم می‌کند، که موجب می‌شود
           دایرکتوری مدیریتی روی «directory/var/lib/dpkg» قرار گیرد (از نسخه
           dpkg 1.21.0).

       --by-package=package
           بازنویسی بسته منتظر تریگر (معمولاً توسط dpkg از طریق متغیر محیطی
           DPKG_MAINTSCRIPT_PACKAGE در اسکریپت‌های نگه‌دارنده تنظیم می‌شود که نام
           بسته‌ای که اسکریپت به آن تعلق دارد را مشخص می‌کند؛ این مقدار به صورت
           پیش‌فرض استفاده خواهد شد).

       --no-await
           این گزینه ترتیبی می‌دهد که بسته فراخواننده T (در صورت وجود) نیازی به
           انتظار برای پردازش این تریگر نداشته باشد؛ بسته(های) ذی‌نفع I، به
           فهرست بسته‌های منتظر پردازش تریگر برای T اضافه نخواهند شد و وضعیت T
           تغییری نمی‌کند. ممکن است T نصب‌شده در نظر گرفته شود، حتی اگر I هنوز
           تریگر را پردازش نکرده باشد.

       --await
           این گزینه برعکس --no-await عمل می‌کند (از نسخه dpkg 1.17.21).  اگر
           بسته ذی‌نفع دستورالعمل “noawait” را اعلان کرده باشد، این گزینه
           تأثیری نخواهد داشت. این رفتار در حال حاضر رفتار پیش‌فرض است.

       --no-act
           فقط آزمایش انجام شود، در عمل چیزی تغییر نکند.

وضعیت خروج (EXIT STATUS)
       0   عملیات درخواستی با موفقیت انجام شد، یا دستور بررسی یا ارزیابی مقدار
           درست (true) برگرداند.

       1   دستور بررسی یا ارزیابی مقدار نادرست (false) برگرداند.

       2   خطای مهلک یا غیرقابل‌بازگشت به دلیل استفاده نامعتبر از خط فرمان، یا
           تعامل با سیستم، مانند دسترسی به پایگاه‌داده، تخصیص حافظه و غیره.

محیط (ENVIRONMENT)
       DPKG_ROOT
           اگر تنظیم شده باشد و گزینه --root مشخص نشده باشد، به عنوان
           دایرکتوری ریشه سیستم‌فایل استفاده می‌شود (از نسخه dpkg 1.21.0).

       DPKG_ADMINDIR
           اگر تنظیم شده باشد و گزینه --admindir مشخص نشده باشد، به عنوان
           دایرکتوری داده‌های dpkg استفاده می‌شود.

       DPKG_DEBUG
           ماسک اشکال‌زدایی را از یک مقدار هشت‌هشتی (octal) تعیین می‌کند (از نسخه
           dpkg 1.21.10).  فلگ‌های پذیرفته‌شده فعلی در توضیح گزینه dpkg --debug
           آمده‌اند، اما ممکن است همه این فلگ‌ها روی این برنامه اثرگذار نباشند.

       DPKG_COLORS
           حالت رنگی را تنظیم می‌کند (از نسخه dpkg 1.18.5).  مقادیر پذیرفته‌شده
           فعلی عبارتند از: auto (پیش‌فرض)، always و never.

       DPKG_NLS
           اگر تنظیم شده باشد، برای تصمیم‌گیری در خصوص فعال‌سازی پشتیبانی از
           زبان بومی (Native Language Support)، که به عنوان پشتیبانی
           بین‌المللی‌سازی (یا i18n) نیز شناخته می‌شود، به کار می‌رود (از نسخه
           dpkg 1.22.7).  مقادیر پذیرفته‌شده عبارتند از: 0 و 1 (پیش‌فرض).

همچنین ببینید (SEE ALSO)
       dpkg(1)، deb-triggers(5)، /usr/share/doc/dpkg/spec/triggers.txt.

1.23.7-dirty                      2026-03-06                   dpkg-trigger(1)