.TH MODE2 "1" "Last change: Aug 2015" "mode2 0.10.2" "User Commands"
.SH "نام (NAME)"
xmode2 \- نمایش گرافیکی طول پالس و فاصله سیگنال‌های مادون قرمز
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBxmode2\fR [\fIگزینه‌ها\fR]

.SH "توضیحات (DESCRIPTION)"
.P
هدف اصلی
\fBxmode2\fR
بررسی عملکرد سخت‌افزار گیرنده دست‌ساز LIRC و مشاهده شکل موج مادون قرمز (IR) کنترل از راه دور بدون نیاز به اسیلوسکوپ گران‌قیمت است. این برنامه برای اشکال‌زدایی بسیار کاربردی است. البته این برنامه روی سخت‌افزارهایی که سیگنال‌ها را به صورت خودکار رمزگشایی می‌کنند (مانند کارت‌های تلویزیون یا Irman) کار نمی‌کند؛ به این معنی که تنها با درایورهای نوع LIRC_MODE_MODE2 کار می‌کند.
.P
دستور
\fBxmode2\fR
یک نمایش گرافیکی ساده از طول پالس‌ها و فاصله‌ها ارائه می‌دهد. این ابزار از چند دستور از جمله تغییرات پایه زمانی پشتیبانی می‌کند؛ برای اطلاعات بیشتر به خروجی
.B xmode2 \-h
مراجعه کنید.
.P
ابزار
.BR lirc\-lsplugins (1)
امکان بررسی اینکه آیا یک درایور از نوع LIRC_MODE2 است یا خیر را فراهم می‌کند.


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

.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش خلاصه نحوه استفاده
.TP
\fB\-v\fR, \fB\-\-version\fR
نمایش نگارش برنامه
.TP
\fB\-d\fR, \fB\-\-device\fR=\fIدستگاه\fR
خواندن از دستگاه مشخص‌شده
.TP
\fB\-H\fR, \fB\-\-driver\fR=\fIدرایور\fR
استفاده از درایور مشخص‌شده
.TP
\fB\-m\fR, \fB\-\-mode\fR
فعال‌سازی حالت نمایش جایگزین
.TP
\fB\-r\fR, \fB\-\-raw\fR
دسترسی مستقیم به دستگاه

.SH "اجرا به عنوان ریشه (RUNNING AS ROOT)"
در بسیاری از موارد
.B xmode2
برای دسترسی به دستگاه‌هایی که در دسترس کاربران عادی نیست، نیاز به اجرا با دسترسی کاربر ریشه (root) دارد. از سوی دیگر، اجرا با دسترسی ریشه مشکلاتی مانند ایجاد فایل‌های لاگ متعلق به ریشه، دغدغه‌های امنیتی و غیره ایجاد می‌کند.
.P
برای مقابله با این موضوع،
.B xmode2
به صورت پیش‌فرض پس از باز کردن دستگاه ورودی، دسترسی‌های ریشه را لغو می‌کند. این سازوکار مبتنی بر آن است که مجوزهای ریشه با استفاده از
.BR sudo (1)
کسب شده باشند؛ به عنوان مثال:
.nf

        $ sudo xmode2 --driver default --device /dev/lirc0

.fi
در صورت عدم استفاده از sudo، رفتار مشابهی را می‌توان با استفاده از متغیر محیطی
.B SUDO_USER
انجام داد؛ به عنوان مثال:
.nf

        # SUDO_USER=$LOGNAME xmode2 --raw /dev/lirc0

.fi
گزینه
.B \-\-keep\-root
باعث می‌شود
.B xmode2
دسترسی‌های ریشه خود را در تمام مدت اجرا حفظ کند.


.SH "بارگذاری درایور (DRIVER LOADING)"
درایورها به صورت پویا بارگذاری می‌شوند. مسیر جستجوی مورد استفاده برای این کار با اولویت نزولی زیر تعیین می‌شود:
.IP \- 2
گزینه
.BR \-\-plugindir .
.IP \- 2
مدخل «plugindir» در بخش [lircd] از فایل lirc_options.conf.
.IP \- 2
متغیر محیطی
.BR LIRC_PLUGINDIR .
.IP \- 2
مقدار پیش‌فرض کامپایل‌شده (معمولاً /usr/lib[64]/lirc/plugins).

.SH "فایل‌ها (FILES)"

.TP 4
.B ~/.cache/xmode2.log
خروجی اشکال‌زدایی. تنظیم متغیر محیطی XDG_CACHE_HOME این فایل را به مسیر $XDG_CACHE_HOME/mode2.log منتقل می‌کند.

.SH "همچنین ببینید (SEE ALSO)"
.BR mode2 (1)
.br
.BR lirc\-lsplugins (1)
.PP
مستندات
.B lirc
به صورت صفحات HTML نگهداری می‌شوند. این مستندات در دایرکتوری مستندات تحت پوشه html قرار دارند.