.TH irdb-get "1" "Last change: Aug 2017" "irdb-get 0.10.2" "User Commands"
.SH "نام (NAME)"
.P
\fBirdb-get\fR \- فهرست‌کردن، جستجو و بارگیری فایل‌های پیکربندی lirc.
.SH "خلاصه دستور (SYNOPSIS)"
\fBirdb-get\fR update
.P
\fBirdb-get\fR find  <\fIstring\fR>
.P
\fBirdb-get\fR info  <\fIid\fR>
.P
\fBirdb-get\fR download <\fIid\fR>
.P
\fBirdb-get\fR list [\fIpattern\fR]
.P
\fBirdb-get\fR find-driver  <\fIstring\fR>
.P
\fBirdb-get\fR yaml-config
.P
\fBirdb-get\fR  <\fI\-h\fR|\fI\-\-help\fR|\fI\-v\fR|\fI\-\-version\fR>

.SH "توضیحات (DESCRIPTION)"
.P
ابزار \fBirdb-get\fR می‌تواند فایل‌های پیکربندی کنترل از راه دور (ریموت) lirc را فهرست، جستجو و بارگیری کند. این ابزار با بارگیری یک فایل نمایه (index) کار می‌کند و در نتیجه تمام عملیات‌ها، به‌جز بارگیری نهایی، به‌صورت محلی انجام می‌شوند.
.P
مدخل‌ها در نمایه با یک \fIid\fR مشخص می‌شوند. این شناسه به شکل
.I dir/remote
است؛ مانند:
.I x10/ati_remote_wonder_III

.SH "دستورها (COMMANDS)"
.TP 4
.B update
بارگیری نمایه از مخزن راه دور.
.TP 4
\fBfind\fR <\fIstring\fR>
فهرست‌کردن تمام مدخل‌های موجود در فایل نمایه که با <string> مطابقت دارند. تطبیق با استفاده از نحو تطبیق معمولی پوسته انجام می‌شود (نه با عبارات باقاعده).
.TP 4
\fBfind-driver\fR <\fIstring\fR>
فهرست‌کردن تمام مدخل‌های نمایه با یک درایور مشخص. تطبیق به‌صورت دقیق انجام می‌شود و نویسه‌های عام (wildcards) اعمال نمی‌شوند.
.TP 4
\fBinfo\fR <\fIid\fR>
چاپ اطلاعات بیشتر درباره یک مدخل مشخص.
.TP 4
\fBdownload\fR <\fIid\fR>
بارگیری فایل پیکربندی برای یک مدخل مشخص. نام فایل در خروجی استاندارد (stdout) چاپ می‌شود.
.TP 4
\fBlist\fR <\fIpattern\fR>
فهرست‌کردن مدخل‌های منطبق با <pattern>. الگوی <pattern> به شکل dir/remote است؛ مانند:
.I x10/ati*
یا
.I */ati_remote_wonder* .

اولین کلمه در فهرست چیزی شبیه به -RL- است که در آن هر حرف نشان‌دهنده یک ویژگی است:
.RS 4
.IP R 4
پیکربندی خام (Raw).
.IP T 4
ریموت دارای اطلاعات زمان‌بندی (timing) است؛ یعنی می‌توان از آن با دستگاه‌های دریافت عمومی سیگنال (capture devices) استفاده کرد.
.IP L 4
ریموت دارای یک فایل پیکربندی lircmd است.
.IP P 4
ریموت دارای تصویر است.
.RE

.TP 4
\fByaml-config\fR
یک فایل YAML را در خروجی استاندارد چاپ می‌کند که درایورها را به فایل‌های ریموت با مشخصه \fIdriver\fR متناظر نگاشت می‌کند. قالب آن ناپایدار است و در درجه اول توسط lirc-setup(1) استفاده می‌شود.

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

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

.TP 4
\fB-v\fR , \fB--version\fR
چاپ اطلاعات نسخه.

.SH "محیط (ENVIRONMENT)"

.TP 4
\fBLIRC_REMOTES_URL\fR
نشانی اینترنتی (URL) پایه‌ای که هنگام بارگیری فایل‌های پیکربندی استفاده می‌شود؛ پیش‌فرض:
\fIhttps://sourceforge.net/p/lirc-remotes/code/ci/master/tree\fR.

.TP 4
\fBLIRC_REMOTES_LIST\fR
نشانی اینترنتی فایلی که تمام ریموت‌ها را فهرست می‌کند، مطابق با آنچه توسط lirc-lsremotes(1) ایجاد شده است.
پیش‌فرض: \fIhttp://lirc-remotes.sourceforge.net/remotes.list\fR.

.TP 4
\fBLIRC_IRDB_CACHE_ID\fR
در صورت تعریف، جایگزین تاریخی می‌شود که در خروجی yaml-config چاپ می‌شود. برای سایر دستورها نادیده گرفته می‌شود. به همراه \fIXDG_CACHE_HOME\fR برای ساخت‌های بازتولیدپذیر (reproducible builds) کاربرد دارد.
.TP 4
\fBXDG_CACHE_HOME\fR
در صورت تعریف، مسیر فایل ذخیره‌شده (کش‌شده) و بارگیری‌شده فهرست ریموت‌ها را به
\fI$XDG_CACHE_HOME/remotes.list\fR
منتقل می‌کند؛ بخش فایل‌ها را ببینید.


.SH "فایل‌ها (FILES)"
.TP 4
.B ~/.cache/remotes.list
فایل نمایه‌ای که بر اساس نیاز یا توسط دستور update بارگیری می‌شود.

.SH "همچنین ببینید (SEE ALSO)"
http://sourceforge.net/projects/lirc-remotes