.\"
.\" XMMS2 - The next generation of the XMMS music player.
.\"
.\" xmms2d.1 - xmms2d (xmms2 daemon) man page
.\"
.\" Copyright (C) 2005-2023 XMMS2 Team
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer
.\"    in this position and unchanged.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. The name of the author may not be used to endorse or promote products
.\"    derived from this software without specific prior written permission
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.TH XMMS2D 1
.SH "نام (NAME)"
xmms2d \- دیمن XMMS2 برای مدیریت پخش موسیقی و ذخیره‌سازی فراداده‌های صوتی
.SH "خلاصه دستور (SYNOPSIS)"
.B xmms2d
.RB [\| \-v \||\| \-q \|]
.RB [\| \-p
.IR dir \|]
.RB [\| \-o
.IR plugin \|]
.RB [\| \-i
.IR url \|]
.RB [\| -c
.IR file \|]
.RB [\| -s
.IR fd \|]
.RB [\| --yes-run-as-root \|]
.br
.B xmms2d -?
.br
.B xmms2d -V
.SH "توضیحات (DESCRIPTION)"
پروژه XMMS2 بازطراحیِ پخش‌کننده موسیقی XMMS (https://en.wikipedia.org/wiki/XMMS) است. این برنامه از مدل کلاینت-سرور بهره می‌برد که امکان استفاده از چندین رابط کاربری متنی و گرافیکی (حتی به صورت هم‌زمان!) را فراهم می‌کند. تمامی قالب‌های صوتی رایج با استفاده از پلاگین‌ها پشتیبانی می‌شوند. علاوه بر این، یک کتابخانه رسانه‌ای منعطف برای سازماندهی موسیقی‌های شما در نظر گرفته شده است.
.PP
.B xmms2d
دیمنی است که کلاینت‌های XMMS2 از طریق آن موسیقی را پخش و مدیریت می‌کنند. کتابخانه کلاینت ارائه‌شده به توسعه‌دهندگان شخص ثالث اجازه می‌دهد به سادگی، به ویژه با استفاده از بایندینگ‌های Python و Ruby، برای XMMS2 کلاینت بنویسند.
.PP
.B xmms2d
برای پخش موسیقی از یک سازوکار سه‌بخشی استفاده می‌کند. دسترسی به داده‌های موسیقی از روی دیسک یا شبکه توسط یک پلاگین انتقال (transport) انجام می‌شود، سپس داده‌ها به یک پلاگین رمزگشا (decoder) تحویل داده می‌شوند تا صوت به قالبی تبدیل شود که توسط یک پلاگین خروجی (output) قابل پخش باشد.
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های عمومی"
.TP
.B \-v, \-\-verbose
افزایش جزئیات خروجی.
.TP
.B \-q, \-\-quiet
کاهش جزئیات خروجی.
.TP
.BI \-p\  dir ,\ \-\-plugindir= dir
استفاده از دایرکتوری پلاگین
.IR dir .
.TP
.BI \-o\  plugin ,\ \-\-output= plugin
استفاده از پلاگین خروجی
.IR plugin .
.TP
.BI \-i\  url ,\ --ipc-socket= url
گوش دادن به سوکت در
.IR url .
می‌توان چندین سوکت را با جدا کردن توسط نویسه
.BR ;
مشخص کرد. بخش
.BR "سوکت IPC (IPC SOCKET)"
را ببینید.
.TP
.BI \-c\  file ,\ \-\-conf= file
استفاده از فایل پیکربندی
.IR file .
.TP
.BI \-s\  fd ,\ \-\-status-fd= fd
نوشتن در توصیف‌گر فایل
.I fd
هنگام آغاز به کار. این گزینه می‌تواند برای انتظار تا زمان برقراری ارتباط بین‌فرآیندی (IPC) استفاده شود، مشابه کاری که
.BR xmms2-launcher (1)
انجام می‌دهد.
.TP
.B \-\-yes\-run\-as\-root
اجازه به
.B xmms2d
برای اجرا با دسترسی ریشه (root).
.SS "دریافت راهنما"
.TP
.B \-h, \-?, \-\-help
نمایش اطلاعات راهنمای اولیه و خروج.
.TP
.B \-V, \-\-version
نمایش اطلاعات نسخه.
.SH "سوکت IPC (IPC SOCKET)"
کلاینت‌های XMMS2 برای ارتباط با
.BR xmms2d
از سوکت‌های IPC استفاده می‌کنند. این سوکت‌های IPC در قالبی مبتنی بر URL و با سه روش انتقال ممکن مشخص می‌شوند: unix، tcp و tcp6.
.PP
روش‌های TCP به کلاینت‌ها امکان می‌دهند از طریق IPv4 و IPv6 به
.B xmms2d
متصل شوند و در نتیجه کنترل از راه دور XMMS2 را ممکن می‌سازند. یک نشانی متداول برای سوکت IPC با استفاده از پروتکل TCP به صورت
.IR tcp://127.0.0.1:9667
است.
.PP
روش انتقال UNIX تنها برای کلاینت‌های محلی است و فایلی ایجاد می‌کند که کلاینت‌های XMMS2 از طریق آن به
.BR xmms2d
دسترسی می‌یابند. یک مسیر متداول برای سوکت IPC با استفاده از روش انتقال UNIX به صورت
.IR unix:///tmp/xmms-ipc-foobar
است.
.SH "فایل‌ها (FILES)"
در ادامه، در سیستم‌های یونیکس در صورتی که متغیر محیطی
.BR XDG_CONFIG_HOME
تنظیم شده باشد،
.I CONFDIR
همان
.I $XDG_CONFIG_HOME/xmms2
است. در غیر این صورت برابر با
.I $HOME/.config/xmms2
(در یونیکس به‌جز Darwin) یا
.I $HOME/Library/xmms2
(در Darwin) خواهد بود.
در Win32 نیز برابر با
.IR %APPDATA%/xmms2
است.
.TP
.IR CONFDIR/xmms2.conf
فایل پیکربندی در قالب XML که امکان تغییر تنظیمات
.BR xmms2d
را فراهم می‌آورد.
.TP
.IR CONFDIR/startup.d/
دایرکتوری شامل برنامه‌هایی که هنگام اجرای
.B xmms2d
فراخوانی می‌شوند.
مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
.TP
.IR CONFDIR/shutdown.d/
دایرکتوری شامل برنامه‌هایی که هنگام متوقف شدن درستِ
.B xmms2d
فراخوانی می‌شوند.
مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
.TP
.IR CONFDIR/medialib.db
یک پایگاه‌داده
.BR sqlite3 (1)
شامل اطلاعات تمام آهنگ‌هایی که به کتابخانه رسانه‌ای XMMS2 افزوده شده‌اند.
مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
.TP
.IR CONFDIR/bindata/
دایرکتوری حاوی فایل‌هایی با داده‌های باینری سپرده‌شده به کتابخانه رسانه‌ای XMMS2، مانند تصویر جلد آلبوم‌ها.
مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
.TP
.I /tmp/xmms-ipc-USER
مکان متداول برای سوکت IPC یونیکس. در اینجا
.I USER
نام کاربری است که
.BR xmms2d
را اجرا کرده است.
.SH "محیط (ENVIRONMENT)"
.TP
.B XDG_CONFIG_HOME
مسیری که فایل‌های پیکربندی و منابع XMMS2 در آن قرار دارند.
.TP
.B XMMS_PATH
نشانی نخستین سوکتی که
.B xmms2d
به آن گوش می‌دهد. این متغیر محیطی برای برنامه‌های موجود در دایرکتوری‌های startup و shutdown تنظیم می‌شود.
.TP
.B XMMS_PATH_FULL
فهرستی جداشده با نویسه
.BR ;
از مسیرهایی که
.B xmms2d
به آن‌ها گوش می‌دهد. این متغیر محیطی برای برنامه‌های موجود در دایرکتوری‌های startup و shutdown تنظیم می‌شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR xmms2 (1),\  xmms2-launcher (1),\  https://github.com/xmms2 .
.SH "تاریخچه (HISTORY)"
پروژه XMMS2 توسط Tobias Rundström و Anders Waldenborg آغاز شد. این پروژه توسط گروه کوچکی از مشارکت‌کنندگان در سراسر جهان توسعه می‌یابد.
.SH "نویسندگان (AUTHORS)"
این صفحه راهنما در ابتدا توسط Alexander Botero-Lowry <alex@foxybanana.com> نوشته شد. سپس ساختاربندی مجدد آن و افزودن پاره‌ای از بخش‌ها توسط Erik Massop <e.massop@hccnet.nl> انجام گرفت.