.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH jack-dssi-host 1 "September 18th, 2010"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
jack-dssi-host \- یک میزبان سادهٔ JACK برای افزونه‌های DSSI
.SH "خلاصه دستور (SYNOPSIS)"
.B jack-dssi-host
.I [-v] [-a] [-n] [-p <projdir>] [-c <cname>] [-<i>] <libname>[:<label>] [...]
.SH "توضیحات (DESCRIPTION)"
.B jack-dssi-host
یک میزبان سادهٔ DSSI است که به رویدادهای MIDI روی یک درگاه ALSA sequencer گوش می‌دهد، آن‌ها را به افزونه‌های ساز DSSI تحویل داده و صدای حاصل را از طریق JACK پخش می‌کند.
.br
.B jack-dssi-host
می‌تواند تا ۱۶ نمونه از افزونه‌های ساز DSSI را میزبانی کند که به هر یک از آن‌ها به‌ترتیب یک کانال MIDI از ۱ تا ۱۶ اختصاص داده می‌شود. خروجی‌های افزونه (اگر گزینهٔ
.B \-a
مشخص نشده باشد) به‌ترتیب به درگاه‌های فیزیکی خروجیِ موجود در JACK متصل می‌شوند، و در صورت اتمام درگاه‌های در‌دسترس، اتصال مجدداً از اولین درگاه JACK ادامه می‌یابد. رابط‌های کاربری (UI) افزونه برای هر نمونه اجرا می‌شوند (مگر اینکه گزینهٔ
.B \-n
مشخص شده باشد). برنامهٔ
.B jack-dssi-host
هنگامی که آخرین رابط کاربری افزونه بسته شود، خارج خواهد شد.
.br
به‌عنوان یک حالت خاص، اگر
.B jack-dssi-host
با نامی غیر از «jack-dssi-host» اجرا شود، و اگر آن نام (به‌همراه پسوند
.B .so\c
) در مسیر جستجوی DSSI_PATH (بخش
.B محیط (ENVIRONMENT)
در زیر را ببینید) به‌عنوان یک کتابخانهٔ اشتراکی معتبر افزونه یافت شود، و در صورتی که هیچ آرگومان خط فرمان دیگری داده نشده باشد، اولین افزونه در آن کتابخانه به‌طور خودکار بارگذاری خواهد شد. این قابلیت روشی آسان برای اجرای یک افزونه را با ایجاد یک پیوند نمادین (symlink) از نام پایهٔ افزونه به jack-dssi-host فراهم می‌کند.
.br
.SH "گزینه‌ها (OPTIONS)"
.TP
.B -v
حالت پرگویی (Verbose).
.TP
.B -a
غیرفعال کردن اتصال خودکار خروجی‌ها به خروجی‌های فیزیکی JACK.
.TP
.B -n
غیرفعال کردن اجرای خودکار رابط‌های کاربری افزونه (UIs).
.TP
.B -p <projdir>
دایرکتوری پروژه برای ارسال به افزونه و رابط کاربری.
.TP
.B -c <cname>
نام کلاینت جهت استفاده برای ALSA و JACK.
.TP
.B -<i>
تعداد نمونه‌های افزونهٔ بعدی جهت اجرا (حداکثر ۱۶ در مجموع، پیش‌فرض ۱).
.TP
.B <libname>
نام کتابخانهٔ اشتراکی افزونهٔ DSSI (با پسوند .so) برای بارگذاری. این مقدار می‌تواند یک مسیر مطلق به فایل کتابخانه باشد یا صرفاً نام فایل، که در این صورت مسیر جستجوی DSSI پیمایش می‌شود (بخش محیط در زیر را ببینید).
.TP
.B <label>
برچسب افزونه برای بارگذاری از کتابخانه. در صورت حذف این مقدار، اولین افزونه در کتابخانه استفاده می‌شود.
.TP
.B [...]
تعداد نمونه‌ها، افزونه‌ها و برچسب‌های بیشتر به‌صورت اختیاری.
.br
.SH "مثال‌ها (EXAMPLES)"
.B jack-dssi-host -2 lib1.so -1 lib2.so:fuzzy
.br
دو نمونه از اولین افزونهٔ یافت‌شده در lib1.so را اجرا می‌کند که به کانال‌های MIDI شمارهٔ ۱ و ۲ اختصاص یافته و به اولین خروجی‌های موجود JACK متصل می‌شوند، و یک نمونه از افزونهٔ «fuzzy» در lib2.so روی کانال ۳ MIDI که به خروجیِ موجود بعدی JACK متصل می‌گردد.
.SH "محیط (ENVIRONMENT)"
.B jack-dssi-host
برای یافتن کتابخانه‌های اشتراکی افزونه‌ها، دایرکتوری‌های مشخص‌شده توسط متغیر محیطی
.B DSSI_PATH
را جستجو خواهد کرد؛ این متغیر فهرستی از دایرکتوری‌ها است که با دونقطه (:) از هم جدا شده‌اند. اگر
.B DSSI_PATH
تنظیم نشده باشد، مسیر جستجوی پیش‌فرضی شامل /usr/lib/dssi،
/usr/local/lib/dssi و (به شرط تنظیم بودن متغیر محیطی HOME) $HOME/.dssi استفاده می‌شود.
.br
.SH "نویسندگان (AUTHORS)"
این صفحهٔ راهنما در ابتدا توسط Mark Hymers بر اساس متن راهنمای برنامه و برای پروژهٔ Debian نوشته شده است (اما دیگران نیز می‌توانند آزادانه از آن استفاده کنند).