IREXEC(1)                        User Commands                       IREXEC(1)

نام (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.

irexec 0.10.2                Last change: Oct 2015                   IREXEC(1)