.TH irtestcase "1" "Last change: Oct 2015" "irtestcase 0.10.2" "User Commands"
.SH "نام (NAME)"
irtestcase \- ایجاد یا بررسی موارد آزمون رمزگشایی
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBirtestcase\fR [\fI-l lircrc-file -p prog\fR] <\fIsocket\fR>
.P
\fBirtestcase\fR [\fI-l lircrc-file -p prog\fR] -t \fItestdata\fR <\fIsocket\fR>
.P
\fBirtestcase\fR [\fI-v\fR|\fI-h\fR]

.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBirtestcase\fR ابزاری است که می‌تواند فشردن کلیدها از یک کنترل از راه دور را به همراه مقادیر رمزگشایی‌شده ضبط کند. همچنین با دریافت خروجی از یک نشست دیگر، می‌تواند بررسی کند که آیا رمزگشایی همچنان طبق انتظار کار می‌کند یا خیر.
.P
در حالت اول، irtestcase منتظر ورودی می‌ماند و فایل‌های گزارش را برای آن ایجاد می‌کند. حین انجام این کار، دکمه‌های دریافت‌شده را روی stdout نیز منعکس می‌کند. هیچ راهی برای متوقف کردن تمیز برنامه وجود ندارد؛ پس از پایان کار کافی است از ctrl-C استفاده کنید.
.P
در حالت دوم، داده‌ها را از فایل testdata به lircd تزریق می‌کند و طبق معمول داده‌های رمزگشایی‌شده را به ثبت می‌رساند. بنابراین امکان آزمایش خروجی کنترل از راه دوری که testdata را تولید کرده فراهم می‌شود. در این حالت lircd باید با درایور \(lqfile\(rq در حال اجرا باشد.
.P
سوکت اختیاری، همان سوکت خروجی lircd است (lircd باید در حال اجرا باشد). مقدار پیش‌فرض آن از متغیر محیطی LIRC_SOCKET_PATH گرفته می‌شود و در صورت عدم تنظیم، به مقدار پیش‌فرض هاردکد شده (/var/run/lirc/lircd) بازمی‌گردد.

.SH "گزینه‌ها (OPTIONS)"

.TP 4
\fB-l, --lircrc\fR  \fI<lircrc config file>\fR
ثبت رشته‌های برنامه‌ها (مشابه \fBircat\fR(1)) با استفاده از فایل پیکربندی از نوع lircrc.

.TP 4
\fB-p, --prog\fR \fI<program id>\fR
هنگام استفاده از \fB-l\fR/\fB--lircrc\fR، نام برنامهٔ منطبق با مدخل‌های PROG = در lircrc.

.TP 4
\fB-t, --testdata\fR
استفاده از داده‌های درون فایل به‌جای ورودی «زنده» از کنترل از راه دور. این داده‌ها می‌توانند فایل durations.log از یک اجرای قبلی باشند؛ بخش \fBفایل‌ها (FILES)\fR را ببینید. همچنین می‌تواند خروجی ثبت‌شده از \fBmode2\fR(1) باشد.

.TP 4
\fB-v , --version\fR
نمایش نسخه و خروج.

.TP 4
\fB-h , --help\fR
نمایش پیام راهنما.

.SH "محیط (ENVIRONMENT)"
دستور irtestcase از متغیر محیطی LIRC_SOCKET_PATH تبعیت می‌کند که در صورت تعریف شدن، حاوی مسیر سوکت خروجی lircd برای شنود است.

.SH "فایل‌ها (FILES)"
.TP 4
.B /tmp/irtestcase
دستور irtestcase فایل‌ها را در /tmp/irtestcase ایجاد می‌کند (به‌صورت هاردکد شده). پس از یک اجرای موفق، موارد زیر در این مسیر قرار دارند:
.RS 4
.TP 4
.B durations.log
مدت‌زمان پالس/فاصله قابل چاپ با همان قالبی که در \fBmode2\fR(1) وجود دارد. این فایل به‌عنوان ورودی \fB-t\fR/\fB--testdata\fR قابل استفاده است.
.TP 4
.B codes.log
دکمه‌های رمزگشایی‌شده، با همان قالب \fBirw\fR(1).
.TP 4
.B app_strings.log
رشته‌های برنامه، همان‌گونه که توسط \fBircat\fR(1) ارائه می‌شوند.
.RE
.TP 4
.B ~/.cache/irtestcase.log
گزارش اشکال‌زدایی (Debug log). تنظیم متغیر محیطی XDG_CACHE_HOME این فایل را به $XDG_CACHE_HOME/irtestcase.log منتقل می‌کند. میزان گزارش‌گیری از متغیر محیطی LIRC_LOGLEVEL تبعیت کرده و به‌طور پیش‌فرض از مقدار \fIdebug\fR در بخش \fI[lircd]\fR فایل lirc_options.conf استفاده می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
.P
مستندات مربوط به \fBlirc\fR به‌صورت صفحات html نگهداری می‌شود. این صفحات در مسیر html/ درون پوشهٔ مستندات قرار دارند.