.\"                                      Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2014 Jean-Francois Dockes <dockes@y.dockes.com>,
.\"
.TH UPMPDCLI 1 "10 فوریه 2014"
.\" Please adjust this date whenever revising the manpage.
.\"
.SH "نام (NAME)"
upmpdcli \- رندرکننده و سرور رسانه UPnP
.SH "خلاصه دستور (SYNOPSIS)"
.B upmpdcli
.RI [ گزینه‌ها ]
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fBupmpdcli\fP هم یک UPnP Media Renderer (رندرکننده رسانه) و هم یک Media Server (سرور رسانه) را پیاده‌سازی می‌کند.
.PP
به‌عنوان یک UPnP Media Renderer، برنامه \fBupmpdcli\fP از دیمن پخش‌کننده موسیقی یعنی \fBmpd\fP برای پردازش جریان‌های صوتی (پخش موسیقی) استفاده می‌کند. این ویژگی امکان ادغام \fBMPD\fP باکیفیت و بسیار سازگار را در یک شبکه موسیقی UPnP فراهم کرده و کنترل آن را از یک نقطه کنترل (Control Point) UPnP که معمولاً روی تبلت یا تلفن همراه اجرا می‌شود، ممکن می‌سازد.
.PP
به‌عنوان یک UPnP Media Server، برنامه \fBupmpdcli\fP هم رابطی به کتابخانه رسانه محلی و هم مجموعه‌ای از رابط‌های پروکسی برای منابع خارجی مانند سرویس‌های استریم یا فهرست‌های رادیویی ارائه می‌دهد. تمام عملکردهای پشتیبانی‌شده و فعال‌شده به‌عنوان ورودی‌هایی در دایرکتوری ریشه سرور رسانه نمایش داده می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
این برنامه از گزینه‌های خط فرمان کوتاه استفاده می‌کند. خلاصه‌ای از گزینه‌ها در ادامه آمده است. با این حال، بخش عمده پیکربندی از طریق پارامترهای موجود در یک فایل پیکربندی انجام می‌شود؛ upmpdcli.conf(5) را ببینید. به‌جز گزینه \fI-c\fP که فایل پیکربندی را مشخص می‌کند، گزینه‌های خط فرمان کمتر مورد استفاده قرار می‌گیرند و تنها برای حفظ سازگاری با نسخه‌های پیشین نگه‌داشته شده‌اند.
.TP
.B \-c\fR \fIconfigfile\fP
استفاده از پیکربندی موجود در \fIconfigfile\fP. فایل پیکربندی دارای قالب ساده \fIname = value\fP است و می‌تواند همان مقادیر گزینه‌های خط فرمان را (با اولویت پایین‌تر) تنظیم کند. نام پارامترها عبارتند از:
\fImpdhost\fP، \fImpdport\fP، \fIfriendlyname\fP، \fIlogfilename\fP،
\fIloglevel\fP، \fIupnpiface\fP و \fIupnpport\fP. همچنین از فایل پیکربندی می‌توان برای تنظیم گذرواژه MPD (\fImpdpassword\fP) و نشانی IP مربوط به UPnP (به‌جای نام رابط، \fIupnpip\fP) استفاده کرد. upmpdcli.conf(5) را ببینید.
توجه داشته باشید که اگر این گزینه مشخص نشود، هیچ فایل پیکربندی خوانده نمی‌شود و برنامه کاملاً بر اساس مقادیر پیش‌فرض، گزینه‌های خط فرمان و محیط اجرا می‌شود.
.TP
.B \-h\fR \fIhost\fP
تعیین ماشین میزبانی که \fBmpd\fP روی آن اجرا می‌شود.
.TP
.B \-f\fR \fIfriendly_name\fP
تنظیم نامی که پس از جستجوی شبکه، توسط کنترل‌کننده‌ها برای این نمونه نمایش داده خواهد شد.
.TP
.B \-p\fR \fIport\fP
تعیین پورت IP مورد استفاده توسط \fBmpd\fP.
.TP
.B \-q\fR \fI0|1\fP
تعیین این‌که آیا مالکیت صف MPD در اختیار ما باشد (-q 1) یا خیر (-q 0). به‌طور پیش‌فرض مالکیت صف در اختیار ما است و بدون واهمه آن را پاکسازی می‌کنیم.
.TP
.B \-d\fR \fIlogfilename\fP
ارسال پیام‌های اشکال‌زدایی/ردیابی به \fIlogfilename\fP.
.TP
.B \-l\fR \fIlevel\fP
تنظیم میزان پرگویی گزارش‌ها (0-4).
.TP
.B \-D\fR
تبدیل به دیمن (انشعاب فرایند و اجرا در پس‌زمینه). استفاده از -D برای این منظور برعکس روال معمول است، اما نویسندگان ترجیح دادند تا با ناپدید شدن غیرمنتظره برنامه، از شگفت‌زده شدن کاربران کم‌تجربه جلوگیری کنند...
.TP
.B \-i\fR \fIiface\fP
تعیین رابط شبکه‌ای که باید برای UPnP استفاده شود.
.TP
.B \-O\fR \f1/0\fP
راه‌اندازی سرویس‌های ohMedia مربوط به OpenHome (به‌ویژه PlayList)، یا عدم راه‌اندازی آن‌ها.
.TP
.B \-P\fR \fIport\fP
تعیین پورت IP مورد استفاده برای UPnP.
.SH "همچنین ببینید (SEE ALSO)"
.BR mpd (1), upmpdcli.conf (5)