نام (NAME)

irexec - اجرای برنامه‌ها با فشردن یک دکمه

خلاصه دستور (SYNOPSIS)

irexec [گزینه‌ها] [config_file]

توضیحات (DESCRIPTION)

برنامه irexec دستورات را با دریافت سیگنال مادون قرمز (IR) که توسط lircd (دیمن LIRC) رمزگشایی شده است، اجرا می‌کند. این برنامه از یک فایل پیکربندی lircrc استفاده می‌کند که در آن مدخل‌های config = اجرا می‌شوند؛ به‌عنوان مثال، با فرض قطعه کد زیر در فایل پیکربندی:

begin
    prog   = irexec
    button = KEY_RED
    config = echo "KEY_RED"
end

هنگامی که دکمه متناظر روی ریموت کنترل فشرده شود، irexec مقدار KEY_RED را در ترمینال چاپ (echo) خواهد کرد. دستور موردنظر یک دستور دلخواه پوسته است که به‌صورت ناهمگام اجرا می‌شود - irexec منتظر اتمام اجرای آن نمی‌ماند.

آرگومان‌ها (ARGUMENTS)

config_file: فایل پیکربندی lircrc. برنامه irexec تنها از مدخل‌های دارای prog = irexec استفاده می‌کند. مسیر پیش‌فرض ~/.config/lircrc است.

گزینه‌ها (OPTIONS)

-h, --help: نمایش خلاصه نحوه استفاده.
-v, --version: نمایش نسخه برنامه.
-d, --daemon: اجرای irexec در پس‌زمینه (fork). در این حالت فایل پیکربندی باید در خط فرمان مشخص شود، زیرا irexec قادر به یافتن دایرکتوری خانگی نخواهد بود.
-D, --loglevel [level]: تعیین میزان اطلاعات گزارش‌گیری. [level] می‌تواند یکی از سطوح نمادین syslog باشد: error, warning, info, notice یا debug. همچنین lirc سه سطح اضافی دیگر یعنی trace, trace1 و trace2 را تعریف می‌کند که پیام‌های بیشتری تولید می‌کنند (که trace2 بیشترین پیام را به همراه دارد). با این حال، در لاگ این پیام‌ها با برچسب debug مشخص می‌شوند. به‌طور پیش‌فرض هیچ لاگی ثبت نمی‌شود.
-n, --name <name>: استفاده از این نام برنامه به‌جای نام پیش‌فرض irexec به‌عنوان شناسه در فایل lircd.conf.

محیط (ENVIRONMENT)

LIRC_SOCKET_PATH: مسیر سوکت lircd که irexec از آن می‌خواند؛ مقدار پیش‌فرض آن /var/run/lirc/lircd است.

فایل‌ها (FILES)

~/.config/lircrc: فایل پیکربندی پیش‌فرض.
/etc/lirc/lircrc: فایل پیکربندی مورداستفاده توسط سرویس systemd مربوط به irexec.
~/.cache/irexec.log: لاگ اشکال‌زدایی. تنظیم متغیر محیطی XDG_CACHE_HOME مکان این فایل را به $XDG_CACHE_HOME/irexec.log تغییر می‌دهد.

نکات (NOTES)

تا نسخه 0.9.1، برنامه irexec تا زمان پایان برنامه اجراشده منتظر می‌ماند. بنابراین در فایل‌های پیکربندی قدیمی معمولاً یک '&' به انتهای رشته دستور الصاق می‌شد تا از گیر کردن در دستور جلوگیری شود. این کار در نسخه 0.9.2 به بعد که نمی‌تواند منتظر اتمام اجرای دستور بماند، لازم نیست.

برنامه irexec باید به‌صورت یک سرویس اجرا شود. دایرکتوری contrib شامل یک فایل .desktop است که می‌تواند در ~/.local/autostart قرار داده شود. این کار سرویسی ایجاد می‌کند که توسط ابزارهای معمول میزکار مانند gnome-tweak-tool در تمام میزکارهای اصلی قابل مدیریت است. اگر اجرای دستورات محدودشده مانند خاموش کردن رایانه لازم باشد، می‌توان از sudo(8) استفاده کرد تا به کاربران عادی اجازه اجرای چنین دستوراتی داده شود.

یک روش جایگزین، استفاده از سرویس systemd با نام irexec.service است که با دسترسی ریشه (root) اجرا می‌شود (و می‌تواند به موازات سرویس دسکتاپ اجرا شود). اجرای برنامه با دسترسی ریشه پیامدهای امنیتی خطیری دارد. راهنمای پیکربندی را در مستندات html مشاهده فرمایید.

همچنین ببینید (SEE ALSO)

lircrc(5): فایل پیکربندی lircrc.