.TH IREXEC "1" "Last change: Oct 2015" "irexec 0.10.2" "User Commands"
.SH "نام (NAME)"
.P
irexec \- اجرای برنامه‌ها با فشردن یک دکمه
.SH "خلاصه دستور (SYNOPSIS)"
.B irexec
[\fIگزینه‌ها\fR] [\fIconfig_file\fR]
.SH "توضیحات (DESCRIPTION)"
.P
برنامه
\fBirexec\fR
دستورات را با دریافت سیگنال مادون قرمز (IR) که توسط lircd (دیمن LIRC) رمزگشایی شده است، اجرا می‌کند. این برنامه از یک فایل پیکربندی lircrc استفاده می‌کند که در آن مدخل‌های
\fIconfig = \fR
اجرا می‌شوند؛ به‌عنوان مثال، با فرض قطعه کد زیر در فایل پیکربندی:
.nf
    begin
        prog   = irexec
        button = KEY_RED
        config = echo "KEY_RED"
    end
.fi
.P
هنگامی که دکمه متناظر روی ریموت کنترل فشرده شود،
\fBirexec\fR
مقدار
\fIKEY_RED\fR
را در ترمینال چاپ (echo) خواهد کرد. دستور موردنظر یک دستور دلخواه پوسته است که به‌صورت ناهمگام اجرا می‌شود \-
\fBirexec\fR
منتظر اتمام اجرای آن نمی‌ماند.
.SH "آرگومان‌ها (ARGUMENTS)"
.TP 4
.B config_file
فایل پیکربندی lircrc. برنامه
\fBirexec\fR
تنها از مدخل‌های دارای
\fIprog = irexec\fR
استفاده می‌کند. مسیر پیش‌فرض
\fI~/.config/lircrc\fR
است.
.SH "گزینه‌ها (OPTIONS)"
.TP 4
.B -h, --help
نمایش خلاصه نحوه استفاده.
.TP 4
.B -v, --version
نمایش نسخه برنامه.
.TP 4
.B  -d, --daemon
اجرای irexec در پس‌زمینه (fork). در این حالت فایل پیکربندی باید در خط فرمان مشخص شود، زیرا irexec قادر به یافتن دایرکتوری خانگی نخواهد بود.
.TP 4
\fB-D, --loglevel\fR [\fIlevel\fR]
تعیین میزان اطلاعات گزارش‌گیری. [\fIlevel\fR] می‌تواند یکی از سطوح نمادین syslog باشد:
\fIerror\fR, \fIwarning\fR, \fIinfo\fR, \fInotice\fR
یا
\fIdebug\fR.
همچنین lirc سه سطح اضافی دیگر یعنی
\fItrace\fR, \fItrace1\fR
و
\fItrace2\fR
را تعریف می‌کند که پیام‌های بیشتری تولید می‌کنند (که
\fItrace2\fR
بیشترین پیام را به همراه دارد). با این حال، در لاگ این پیام‌ها با برچسب
\fIdebug\fR
مشخص می‌شوند. به‌طور پیش‌فرض هیچ لاگی ثبت نمی‌شود.
.TP 4
\fB-n, --name\fR <\fIname\fR>
استفاده از این نام برنامه به‌جای نام پیش‌فرض
\fIirexec\fR
به‌عنوان شناسه در فایل lircd.conf.
.SH "محیط (ENVIRONMENT)"
.TP 4
.B LIRC_SOCKET_PATH
مسیر سوکت lircd که irexec از آن می‌خواند؛ مقدار پیش‌فرض آن
/var/run/lirc/lircd
است.
.SH "فایل‌ها (FILES)"
.TP 4
.B ~/.config/lircrc
فایل پیکربندی پیش‌فرض.
.TP 4
.B /etc/lirc/lircrc
فایل پیکربندی مورداستفاده توسط سرویس systemd مربوط به irexec.
.TP 4
.B ~/.cache/irexec.log
لاگ اشکال‌زدایی. تنظیم متغیر محیطی XDG_CACHE_HOME مکان این فایل را به
$XDG_CACHE_HOME/irexec.log
تغییر می‌دهد.
.SH "نکات (NOTES)"
.P
تا نسخه 0.9.1، برنامه
\fBirexec\fR
تا زمان پایان برنامه اجراشده منتظر می‌ماند. بنابراین در فایل‌های پیکربندی قدیمی معمولاً یک '&' به انتهای رشته دستور الصاق می‌شد تا از گیر کردن در دستور جلوگیری شود. این کار در نسخه 0.9.2 به بعد که نمی‌تواند منتظر اتمام اجرای دستور بماند، لازم نیست.
.P
برنامه irexec باید به‌صورت یک سرویس اجرا شود. دایرکتوری contrib شامل یک فایل .desktop است که می‌تواند در
~/.local/autostart
قرار داده شود. این کار سرویسی ایجاد می‌کند که توسط ابزارهای معمول میزکار مانند
\fIgnome\-tweak\-tool\fR
در تمام میزکارهای اصلی قابل مدیریت است. اگر اجرای دستورات محدودشده مانند خاموش کردن رایانه لازم باشد، می‌توان از sudo(8) استفاده کرد تا به کاربران عادی اجازه اجرای چنین دستوراتی داده شود.
.P
یک روش جایگزین، استفاده از سرویس systemd با نام irexec.service است که با دسترسی ریشه (root) اجرا می‌شود (و می‌تواند به موازات سرویس دسکتاپ اجرا شود). اجرای برنامه با دسترسی ریشه پیامدهای امنیتی خطیری دارد. راهنمای پیکربندی را در مستندات html مشاهده فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
.TP 4
.B lircrc(5)
فایل پیکربندی lircrc.