| JACKD(1) | JACKD(1) |
نام (NAME)
jackd - کارساز صوتی کیت اتصال صوتی جک (JACK Audio Connection Kit)
خلاصه دستور (SYNOPSIS)
jackd [options] -d backend
[backend-parameters]
jackd --help
توضیحات (DESCRIPTION)
jackd دیمِن کارساز صوتی JACK است که به برنامه‌های کلاینت JACK اجازه می‌دهد داده‌های صوتی و MIDI را به‌صورت همگام، با دقت در سطح نمونه (sample-accurate) و با تأخیر پایین (low-latency) پردازش و مسیریابی کنند. اگرچه این برنامه در اصل برای سیستم‌عامل GNU/Linux نوشته شده است، اما بر روی پلتفرم‌های گوناگون Unix، همچنین Mac OS X و MS Windows نیز اجرا می‌شود. JACK می‌تواند چندین برنامه کاربردی کلاینت مختلف را به یک دستگاه صوتی و همچنین به یکدیگر متصل کند. بیشتر کلاینت‌ها خارجی (external) هستند و در فرایندهای مستقل خود به‌عنوان برنامه‌های عادی اجرا می‌شوند. JACK همچنین از کلاینت‌های داخلی (internal) پشتیبانی می‌کند که درون فرایند jackd با استفاده از یک رابط افزونه‌ایِ قابل بارگذاری اجرا می‌شوند.
تفاوت JACK با سایر کارسازهای صوتی در این است که از پایه برای کارهای حرفه‌ای صوتی طراحی شده است. این سیستم بر دو حوزه کلیدی تمرکز دارد: اجرای همگام تمام کلاینت‌ها و عملکرد با تأخیر پایین.
نام JACK برگرفته از روش سنتی اتصالات صوتی با کابل‌های فیزیکی فیش جک (audio jack) است. JACK همچنین یک سرنام بازگشتی است؛ یعنی اختصاری که بخشی از خودش است: JACK Audio Connection Kit.
برای دریافت آخرین اطلاعات پیرامون JACK لطفاً به وب‌سایت زیر مراجعه کنید: http://www.jackaudio.org.
گزینه‌ها (OPTIONS)
- -d, --driver backend [backend-parameters ]
-
بک‌اند واسط صوتی را انتخاب می‌کند. فهرست فعلی بک‌اندهای پشتیبانی‌شده عبارت است از: alsa، coreaudio، dummy، firewire، oss، sun و portaudio. همه آن‌ها روی تمام پلتفرم‌ها در دسترس نیستند. تمام مقادیر backend-parameters اختیاری هستند. - -h, --help
-
پیام کوتاهی درباره نحوه استفاده و گزینه‌های اصلی jackd چاپ می‌کند. این پیام شامل backend-parameters نمی‌شود؛ پارامترهای هر بک‌اند با استفاده از گزینه --help برای همان بک‌اند مشخص فهرست می‌شوند. مثال‌های زیر نحوه فهرست کردن آن‌ها را نشان می‌دهند. - -a, --autoconnect modechar
- نحوه مدیریت درخواست‌های اتصال به خود (self connect) را تعیین می‌کند. این درخواست‌ها می‌توانند نادیده گرفته شوند یا با شکست مواجه شوند، چه در تمام درگاه‌ها و چه تنها در درگاه‌های خارجی. برای اطلاع از گزینه‌های مختص سیستم خود از گزینه --help استفاده کنید. پیش‌فرض، عدم محدودسازی درخواست‌های اتصال به خود است.
- -m, --no-mlock
- برای قفل کردن حافظه تلاش نمی‌کند، حتی اگر --realtime فعال باشد.
- -n, --name server-name
- نام این نمونه از jackd را server-name می‌گذارد. در صورت مشخص نشدن، این نام از متغیر محیطی $JACK_DEFAULT_SERVER گرفته می‌شود. (پیش‌فرض: "default")
- -p, --port-max n
- حداکثر تعداد درگاه‌هایی که کارساز JACK می‌تواند مدیریت کند را تعیین می‌کند. (پیش‌فرض: 256)
- --replace-registry
-
رجیستری حافظه مشترک مورد استفاده توسط تمام نمونه‌های کارساز JACK را پیش از راه‌اندازی حذف می‌کند. از این گزینه باید به ندرت استفاده شود و تنها برای مواقعی در نظر گرفته شده که ساختار این رجیستری به گونه‌ای تغییر کرده باشد که در میان نسخه‌های مختلف JACK ناسازگار باشد (که اتفاق نادری است). - -R, --realtime
-
از زمان‌بندی بلادرنگ (realtime) استفاده می‌کند. این ویژگی برای کارایی مطمئن با تأخیر پایین ضروری است. در بسیاری از سیستم‌ها، اجرای jackd نیازمند امتیازات ویژه زمان‌بند و تخصیص حافظه است که می‌توان به روش‌های مختلفی آن‌ها را به دست آورد. (پیش‌فرض: true) - -r, --no-realtime
-
از زمان‌بندی بلادرنگ استفاده نمی‌کند. - -P, --realtime-priority int
- هنگام اجرا در حالت --realtime، اولویت زمان‌بند را برابر با int قرار می‌دهد.
- --silent
- تمام خروجی‌ها را در حین کار بی‌صدا می‌کند.
- -T, --temporary
- به محض اینکه تمام کلاینت‌ها اتصالات خود را ببندند، خارج می‌شود.
- -t, --timeout int
-
محدودیت مهلت زمانی (timeout) کلاینت را بر حسب میلی‌ثانیه تنظیم می‌کند. در حالت بلادرنگ مهلت زمانی کلاینت باید کمتر از مهلت سگ نگهبان (watchdog timeout برابر ۵۰۰۰ میلی‌ثانیه) باشد. (پیش‌فرض: 500) - -Z, --nozombies
-
از بیرون انداختن کلاینت‌ها توسط JACK به دلیل کند بودن بیش از حد جلوگیری می‌کند. این گزینه اثر هر مقدار تعیین‌شده برای مهلت زمانی را لغو می‌کند، اما JACK و کلاینت‌های آن همچنان تحت نظارت ریسه watchdog یا معادل آن خواهند بود. - -C, --internal-session-file internal-session-file
-
کلاینت‌ها و اتصالات داخلی را از internal-session-file بارگذاری می‌کند. هر خط از این فایل پیکربندی با یک دستور شروع می‌شود. دستورهای زیر در دسترس هستند:
l(oad) client-name lib-name client-args
با این دستور یک کلاینت داخلی JACK نمونه‌سازی می‌شود. client-name و lib-name نمی‌توانند شامل فاصله باشند. باقی خط به عنوان client-args تفسیر شده و به کتابخانه کلاینت ارسال می‌شود.
c(on) source-port destination-port
با این دستور یک درگاه مبدأ به یک درگاه مقصد متصل می‌شود. source-port و destination-port نمی‌توانند شامل فاصله باشند.
نوشتن توضیحات مجاز است و با # آغاز می‌شود.
یک پیکربندی نمونه می‌تواند شبیه زیر باشد:
l inprocess1 inprocess
l amp1 jalv http://lv2plug.in/plugins/eg-amp
c amp:out system:playback_1 - -u, --unlock
-
کتابخانه‌های GTK+، QT، FLTK و Wine را آنلاک می‌کند. - -v, --verbose
- خروجی با جزئیات کامل ارائه می‌دهد.
- -c, --clocksource ( h(pet) | s(ystem) )
- یک ساعت دیواری مشخص را انتخاب می‌کند (تایمر HPET یا تایمر System).
- -V, --version
- شماره نسخه فعلی JACK را چاپ کرده و خارج می‌شود..SS "گزینه‌های پس‌زمینه ALSA (ALSA BACKEND OPTIONS)"
- -C, --capture [ name ]
- تنها درگاه‌های ضبط را فراهم می‌کند، مگر اینکه با -D یا -P ترکیب شود. به صورت اختیاری نام دستگاه ضبط را تعیین می‌کند.
- -d, --device name
-
نام (name) دستگاه pcm در ALSA جهت استفاده. اگر مقداری مشخص نشود، JACK از "hw:0" استفاده خواهد کرد که نخستین کارت سخت‌افزاری تعریف‌شده در /etc/modules.conf است. - -z, --dither [rectangular,triangular,shaped,none]
- تنظیم حالت دیترینگ (dithering). اگر none باشد یا مشخص نشود، دیترینگ خاموش است. تنها حرف اول نام حالت کفایت می‌کند.
- -D, --duplex
- فراهم کردن هم‌زمان درگاه‌های ضبط و بازپخش. به طور پیش‌فرض فعال است مگر اینکه تنها یکی از گزینه‌های -P یا -C مشخص شده باشد. (پیش‌فرض: true)
- -h, --help
- چاپ یک پیام راهنمای مختصر که تنها پارامترهای پس‌زمینه alsa را شرح می‌دهد.
- -M, --hwmeter
-
فعال‌سازی سنجش سخت‌افزاری (hardware metering) برای دستگاه‌هایی که از آن پشتیبانی می‌کنند. در غیر این صورت، از سنجش نرم‌افزاری استفاده می‌شود. - -H, --hwmon
-
فعال‌سازی پایش سخت‌افزاری (hardware monitoring) درگاه‌های ضبط. این روشی برای دستیابی به پایش با «تأخیر صفر» از ورودی صدا است. این قابلیت نیازمند پشتیبانی سخت‌افزاری و همچنین درایور دستگاه ALSA مربوطه است.هنگام فعال بودن، درخواست‌های پایش درگاه‌های ضبط با ایجاد یک مسیر سیگنال مستقیم بین کانکتورهای ورودی و خروجی رابط صوتی، بدون هیچ‌گونه پردازشی توسط رایانه میزبان انجام می‌شود. این سازوکار کمترین تأخیر ممکن را برای سیگنال تحت پایش فراهم می‌آورد.
در حال حاضر (مارس ۲۰۰۳)، تنها سری RME Hammerfall و کارت‌های مبتنی بر تراشه ICE1712 (سری M-Audio Delta، Terratec و سایرین) از --hwmon پشتیبانی می‌کنند. در آینده، ممکن است برخی کارت‌های مصرفی نیز با تغییر تنظیمات میکسر آن‌ها پشتیبانی شوند.
بدون --hwmon، پایش درگاه‌ها مستلزم آن است که JACK صدا را در حافظه سیستم بخواند و سپس دوباره آن را به سخت‌افزار بازنویسی کند، که این امر تأخیر پایه سیستم JACK را تحمیل می‌کند که توسط پارامترهای --period و --nperiods تعیین می‌شود.
- -i, --inchannels int
-
تعداد کانال‌های ضبط. (پیش‌فرض: حداکثر مقدار پشتیبانی‌شده توسط سخت‌افزار) - -I, --input-latency
- تأخیر ورودی اضافی (بر حسب فریم). (پیش‌فرض: 0)
- -n, --nperiods int
-
تعداد دوره‌های تأخیر بازپخش. بر حسب ثانیه، این مقدار معادل حاصل‌ضرب --nperiods در --period تقسیم بر --rate است. مقدار پیش‌فرض ۲ است که حداقل مقدار مجاز می‌باشد. برای بیشتر دستگاه‌ها، با وجود گزینه --realtime نیازی به هیچ مقدار دیگری نیست. بدون امتیازات زمان‌واقعی یا با بردهایی که وقفه‌های غیرقابل اعتمادی ارائه می‌دهند (مانند ymfpci)، مقدار بزرگ‌تر ممکن است به xrunهای کمتری منجر شود. این کار همچنین در صورتی که سیستم برای زمان‌بندی زمان‌واقعی مطمئن تنظیم نشده باشد، می‌تواند کمک‌کننده باشد.برای بیشتر دستگاه‌های ALSA، بافر سخت‌افزاری دقیقاً به اندازه حاصل‌ضرب --period در --nperiods فریم دارد. برخی دستگاه‌ها به بافر بزرگ‌تری نیاز دارند. در این حالت، JACK کوچک‌ترین بافر ممکن را که حداقل شامل --nperiods باشد استفاده می‌کند، اما تأخیر بازپخش افزایش نمی‌یابد.
برای دستگاه‌های صوتی USB توصیه می‌شود از -n 3 استفاده شود. دستگاه‌های Firewire که توسط FFADO (سابقاً FreeBoB) پشتیبانی می‌شوند، به‌طور پیش‌فرض با -n 3 پیکربندی شده‌اند.
- -o, --outchannels int
-
تعداد کانال‌های بازپخش. (پیش‌فرض: حداکثر مقدار پشتیبانی‌شده توسط سخت‌افزار) - -O, --output-latency
- تأخیر خروجی اضافی (بر حسب فریم). (پیش‌فرض: 0)
- -P, --playback [ name ]
- تنها درگاه‌های بازپخش را فراهم می‌کند، مگر اینکه با -D یا -C ترکیب شود. به صورت اختیاری نام دستگاه بازپخش را تعیین می‌کند.
- -p, --period int
-
تعداد فریم‌ها بین فراخوانی‌های process() در JACK. این مقدار باید توانی از ۲ باشد. اگر به تأخیر پایین نیاز دارید، -p را تا جای ممکن و بدون مشاهده xrun کاهش دهید. اندازه دوره بزرگ‌تر باعث تأخیر بالاتری می‌شود، اما احتمال وقوع xrun را کمتر می‌سازد. تأخیر ضبط JACK بر حسب ثانیه برابر است با --period تقسیم بر --rate. (پیش‌فرض: 1024) - -r, --rate int
- نرخ نمونه‌برداری. (پیش‌فرض: 48000)
- -S, --shorts
-
تلاش برای پیکربندی اولیه کارت جهت نمونه‌های ۱۶ بیتی، و در صورت عدم موفقیت، تلاش برای ۳۲ بیتی. (پیش‌فرض: نمونه‌های ۳۲ بیتی) - -s, --softmode
-
نادیده گرفتن xrunهای گزارش‌شده توسط درایور ALSA. این کار باعث می‌شود هنگام اجرا بدون --realtime، احتمال قطع اتصال درگاه‌های غیرپاسخگو توسط JACK کمتر شود. - -X, --midi [seq|raw]
-
تعیین می‌کند که دسترسی به کدام سیستم ALSA MIDI فراهم شود. استفاده از raw مجموعه‌ای از درگاه‌های JACK MIDI متناظر با هر دستگاه خام (raw) متعلق به ALSA روی دستگاه را فراهم می‌کند. استفاده از seq مجموعه‌ای از درگاه‌های JACK MIDI متناظر با هر کلاینت «دنباله‌ساز» (sequencer) در ALSA را فراهم می‌کند (که شامل تک‌تک درگاه‌های سخت‌افزاری MIDI روی دستگاه نیز می‌شود). حالت raw عملکرد اندکی بهتری ارائه می‌دهد، اما اجازه ارتباط JACK MIDI با نرم‌افزارهای نوشته‌شده برای استفاده از رابط برنامه‌نویسی دنباله‌ساز ALSA را نمی‌دهد..SS "پارامترهای پس‌زمینه COREAUDIO (COREAUDIO BACKEND PARAMETERS)" - -c, --channels
- حداکثر تعداد کانال‌ها. (پیش‌فرض: 2)
- -i, --inchannels
- حداکثر تعداد کانال‌های ورودی. (پیش‌فرض: 2)
- -o, --outchannels
- حداکثر تعداد کانال‌های خروجی. (پیش‌فرض: 2)
- -C, --capture
- فعال یا غیرفعال بودن ضبط (capture). (پیش‌فرض: true)
- -P, --playback
- فعال یا غیرفعال بودن پخش (playback). (پیش‌فرض: true)
- -D, --monitor
- ارائهٔ درگاه‌های پایش (monitor) برای خروجی. (پیش‌فرض: false)
- -D, --duplex
- ضبط و پخش هم‌زمان. (پیش‌فرض: true)
- -r, --rate
- نرخ نمونه‌برداری. (پیش‌فرض: 44100)
- -p, --period
- تعداد فریم‌ها در هر دوره (period)، باید توانی از ۲ باشد. (پیش‌فرض: 128)
- -d, --device
- نام دستگاه CoreAudio. (پیش‌فرض: none)
- -I, --input-latency
- تاخیر ورودی اضافی (بر حسب فریم). (پیش‌فرض: 0)
- -O, --output-latency
- تاخیر خروجی اضافی (بر حسب فریم). (پیش‌فرض: 0)
- -l, --list-devices
- نمایش دستگاه‌های CoreAudio موجود. (پیش‌فرض: false)
- -H, --hog
- در دست گرفتن دسترسی انحصاری به دستگاه صوتی. (پیش‌فرض: false)
- -L, --async-latency
- تاخیر خروجی اضافی در حالت ناهمگام (بر حسب درصد). (پیش‌فرض: 100)
- -G, --grain
- دانه‌بندی محاسبات در ریسهٔ بی‌درنگ (RT) (بر حسب درصد). (پیش‌فرض: 100)
- -s, --clock-drift
- جبران یا عدم جبران رانش ساعت (clock drift) در دستگاه تجمیعی پویا. (پیش‌فرض: false)
پارامترهای پس‌زمینه DUMMY (DUMMY BACKEND PARAMETERS)
- -C, --capture int
- تعداد درگاه‌های ضبط. (پیش‌فرض: 2)
- -P, --playback int
- تعداد درگاه‌های پخش. (پیش‌فرض: 2)
- -r, --rate int
- نرخ نمونه‌برداری. (پیش‌فرض: 48000)
- -p, --period int
- تعداد فریم‌ها میان فراخوانی‌های process() در JACK. این مقدار باید توانی از ۲ باشد. اگر به تاخیر پایین نیاز دارید، -p را تا جای ممکن بدون مواجهه با xrun کاهش دهید. اندازهٔ دورهٔ بزرگ‌تر باعث تاخیر بالاتر می‌شود، اما احتمال بروز xrun را کمتر می‌سازد. تاخیر ضبط JACK بر حسب ثانیه برابر است با تقسیم --period بر --rate. (پیش‌فرض: 1024)
- -w, --wait int
- تعداد میکروثانیه‌ها (usec) برای انتظار بین پردازش‌های موتور. (پیش‌فرض: 21333).SS "پارامترهای بک‌اند NETONE (NETONE BACKEND PARAMETERS)"
- -i, --audio-ins int
- تعداد کانال‌های ضبط (capture). (پیش‌فرض: 2)
- -o, --audio-outs int
- تعداد کانال‌های بازپخش (playback). (پیش‌فرض: 2)
- -I, --midi-ins int
- تعداد کانال‌های ضبط midi. (پیش‌فرض: 1)
- -O, --midi-outs int
- تعداد کانال‌های بازپخش midi. (پیش‌فرض: 1)
- -r, --rate int
- نرخ نمونه‌برداری. (پیش‌فرض: 48000)
- -p, --period int
- تعداد فریم‌ها در هر دوره (period). (پیش‌فرض: 1024)
- -n, --num-periods int
- تنظیم تاخیر شبکه بر حسب تعداد دوره‌ها. (پیش‌فرض: 5)
- -l, --listen-port int
- درگاه سوکت برای گوش دادن به بسته‌های همگام‌سازی (sync). (پیش‌فرض: 3000)
- -f, --factor int
- ضریب کاهش نرخ نمونه‌برداری. (پیش‌فرض: 1)
- -u, --upstream-factor int
- ضریب کاهش نرخ نمونه‌برداری در بالادست (upstream). (پیش‌فرض: 0)
- -c, --celt int
- تنظیم کدگذاری celt و تعداد کیلوبیت بر ثانیه در هر کانال. (پیش‌فرض: 0)
- -b, --bit-depth int
- عمق بیتی نمونه‌ها (0 برای float، 8 برای 8bit و 16 برای 16bit). (پیش‌فرض: 0)
- -t, --transport-sync int
- تعیین اینکه آیا ترنسپورت پیرو (slave) ترنسپورت master باشد یا خیر. (پیش‌فرض: true)
- -a, --autoconf int
- استفاده یا عدم استفاده از پیکربندی خودکار (Autoconfig)، یا فقط آغاز به کار. (پیش‌فرض: true)
- -R, --redundancy int
- ارسال N باره بسته‌ها. (پیش‌فرض: 1)
- -e, --native-endian int
- نمونه‌ها به ترتیب بایت شبکه (network byte order) تبدیل نشوند. (پیش‌فرض: false)
- -J, --jitterval int
- مقدار میکرثانیه‌های در نظر گرفته شده برای jitterbuffer در master. (پیش‌فرض: 0)
- -D, --always-deadline int
- همواره از deadline استفاده شود. (پیش‌فرض: false)
پارامترهای بک‌اند OSS (OSS BACKEND PARAMETERS)
- -r, --rate int
- نرخ نمونه‌برداری. (پیش‌فرض: 48000)
- -p, --period int
- تعداد فریم‌ها بین فراخوانی‌های process() در JACK. این مقدار باید توانی از 2 باشد. اگر به تاخیر پایین نیاز دارید، -p را تا جای ممکن بدون مواجهه با xrun کاهش دهید. اندازه دوره بزرگ‌تر تاخیر بیشتری ایجاد می‌کند، اما احتمال بروز xrun را کاهش می‌دهد. تاخیر ضبط JACK بر حسب ثانیه برابر است با --period تقسیم بر --rate. (پیش‌فرض: 1024)
- -n, --nperiods int
- تعداد دوره‌ها در بافر سخت‌افزار. اندازه دوره (-p) ضرب‌در --nperiods ضرب‌در چهار برابر است با اندازه بافر JACK بر حسب بایت. تاخیر خروجی JACK بر حسب ثانیه برابر است با --nperiods ضرب‌در --period تقسیم بر --rate. (پیش‌فرض: 2)
- -w, --wordlength int
- اندازه نمونه بر حسب بیت. (پیش‌فرض: 16)
- -i, --inchannels int
- تعداد کانال‌های ضبط. (پیش‌فرض: 2)
- -o, --outchannels int
- تعداد کانال‌های بازپخش. (پیش‌فرض: 2)
- -C, --capture device_file
- دستگاه ورودی برای ضبط. (پیش‌فرض: /dev/dsp)
- -P, --playback device_file
- دستگاه خروجی برای بازپخش. (پیش‌فرض: /dev/dsp)
- -b, --ignorehwbuf boolean
- نادیده گرفتن یا نگرفتن اندازه دوره سخت‌افزاری. (پیش‌فرض: false)
- -e, --excl boolean
- درخواست دسترسی اختصاصی و مستقیم به دستگاه صوتی. این گزینه از ترکیب (mixing) و تبدیل خودکار صدا در راه‌انداز OSS و تاخیر اضافی ناشی از آن جلوگیری می‌کند. (پیش‌فرض: false)
- -I, --input-latency
- تاخیر ورودی اضافی (بر حسب فریم). (پیش‌فرض: 0)
- -O, --output-latency
- تاخیر خروجی اضافی (بر حسب فریم). (پیش‌فرض: 0).SS "پارامترهای بَک‌اند SUN (SUN BACKEND PARAMETERS)"
- -r, --rate int
- نرخ نمونه‌برداری. (پیش‌فرض: 48000)
- -p, --period int
- تعداد فریم‌ها بین فراخوانی‌های process() در JACK. این مقدار باید توانی از ۲ باشد. اگر به تأخیر کم نیاز دارید، -p را تا جای ممکن بدون مواجهه با xrunها پایین بیاورید. اندازه دوره (period) بزرگ‌تر تأخیر بالاتری ایجاد می‌کند، اما احتمال وقوع xrunها را کمتر می‌سازد. تأخیر ضبط JACK بر حسب ثانیه برابر است با --period تقسیم بر --rate. (پیش‌فرض: 1024)
- -n, --nperiods int
- تعداد دوره‌ها در بافر سخت‌افزار. اندازه دوره (-p) ضرب‌در --nperiods ضرب‌در چهار (با فرض ۲ کانال نمونه‌های ۱۶ بیتی) اندازه بافر JACK بر حسب بایت است. تأخیر خروجی JACK بر حسب ثانیه برابر است با حاصل‌ضرب --nperiods در --period تقسیم بر --rate. (پیش‌فرض: 2)
- -w, --wordlength int
- اندازه نمونه بر حسب بیت. (پیش‌فرض: 16)
- -i, --inchannels int
- تعداد کانال‌های ضبط. (پیش‌فرض: 2)
- -o, --outchannels int
- تعداد کانال‌های پخش. (پیش‌فرض: 2)
- -C, --capture device_file
- دستگاه ورودی برای ضبط. (پیش‌فرض: /dev/audio)
- -P, --playback device_file
- دستگاه خروجی برای پخش. (پیش‌فرض: /dev/audio)
- -b, --ignorehwbuf boolean
- نادیده گرفتن یا نگرفتن اندازه دوره سخت‌افزار. (پیش‌فرض: false)
پارامترهای بَک‌اند PORTAUDIO (PORTAUDIO BACKEND PARAMETERS)
- -c, --channel
- حداکثر تعداد کانال‌ها. (پیش‌فرض: تمام کانال‌های سخت‌افزاری موجود)
- -i, --channelin
- حداکثر تعداد کانال‌های ورودی. (پیش‌فرض: تمام کانال‌های سخت‌افزاری موجود)
- -I, --input-latency
- تأخیر ورودی اضافه (بر حسب فریم). (پیش‌فرض: 0)
- -o, --channelout
- حداکثر تعداد کانال‌های خروجی. (پیش‌فرض: تمام کانال‌های سخت‌افزاری موجود)
- -O, --output-latency
- تأخیر خروجی اضافه (بر حسب فریم). (پیش‌فرض: 0)
- -C, --capture
- فعال یا غیرفعال بودن ضبط. (پیش‌فرض: true)
- -P, --playback
- فعال یا غیرفعال بودن پخش. (پیش‌فرض: true)
- -D, --duplex
- ضبط و پخش هم‌زمان. (پیش‌فرض: true)
- -r, --rate
- نرخ نمونه‌برداری. (پیش‌فرض: 48000)
- -p, --period
- تعداد فریم‌ها در هر دوره؛ باید توانی از ۲ باشد. (پیش‌فرض: 1024)
- -n, --name
- نام درایور. (پیش‌فرض: none)
- -z, --dither
- حالت dithering. (پیش‌فرض: none)
پارامترهای بَک‌اند FIREWIRE (FIREWIRE BACKEND PARAMETERS)
- -d, --device name
-
نام دستگاه Firewire (name) برای استفاده. اگر هیچ دستگاهی مشخص نشود، JACK تلاش می‌کند از "hw:0" استفاده کند. برای دریافت فهرستی از دستگاه‌های Firewire موجود، به ffado-test مراجعه کنید. توصیه می‌شود برای جلوگیری از هرگونه ابهام، از شناسه GUID یک دستگاه Firewire استفاده شود. پس از مشخص شدن GUID دستگاه ("ffado-test ListDevices")، می‌توان آن را مانند -dguid:0xff2584e39b078a2e به کار برد تا به JACK اعلام شود از کدام رابط استفاده کند. در صورت بروز هرگونه مشکل، گاهی اوقات بازنشانی گذرگاه Firewire با دستور ("ffado-test BusReset") می‌تواند مفید باشد. (پیش‌فرض: hw:0) - -p, --period int
-
تعداد فریم‌ها بین فراخوانی‌های process() در JACK. این مقدار باید توانی از ۲ باشد. اگر به تأخیر کم نیاز دارید، -p را تا جای ممکن بدون مواجهه با xrunها پایین بیاورید. اندازه دوره بزرگ‌تر تأخیر بالاتری ایجاد می‌کند، اما احتمال وقوع xrunها را کمتر می‌سازد. تأخیر ضبط JACK بر حسب ثانیه برابر با حاصل تقسیم --period بر --rate است. (پیش‌فرض: 1024) - -n, --nperiods int
-
تعداد دوره‌های تأخیر پخش. این مقدار باید بزرگ‌تر یا مساوی ۲ باشد. بر حسب ثانیه، این معادل حاصل‌ضرب --nperiods در --period تقسیم بر --rate است. (پیش‌فرض: 3) - -r, --rate int
- نرخ نمونه‌برداری. (پیش‌فرض: 48000)
- -C, --capture [ name ]
- فقط ارائه پورت‌های ضبط، مگر اینکه با -D یا -P ترکیب شود. به صورت اختیاری نام دستگاه ضبط را تنظیم می‌کند.
- -P, --playback [ name ]
- فقط ارائه پورت‌های پخش، مگر اینکه با -D یا -C ترکیب شود. به صورت اختیاری نام دستگاه پخش را تنظیم می‌کند.
- -D, --duplex
- ارائه هر دو پورت ضبط و پخش. این گزینه رفتار پیش‌فرض است و معمولاً می‌توان آن را نادیده گرفت. گزینه -D نمی‌تواند با -P یا -C ترکیب شود.
- -I, --input-latency
- تأخیر ورودی اضافه (بر حسب فریم). (پیش‌فرض: 0)
- -O, --output-latency
- تأخیر خروجی اضافه (بر حسب فریم). (پیش‌فرض: 0)
- -v, --verbose
-
سطح پرحرفی (verbose level) در libffado. (پیش‌فرض: 3) - -X, --snoop
-
شنود (snoop) ترافیک Firewire. (پیش‌فرض: false) - -h, --help
- چاپ یک پیام راهنمای مختصر که فقط پارامترهای بَک‌اند firewire را شرح می‌دهد..SH "مثال‌ها (EXAMPLES)"
چاپ پیام نحوه استفاده برای پارامترهای مختص هر بک‌اند.
- jackd -d alsa --help
jackd -d coreaudio --help
jackd -d net --help
jackd -d dummy --help
jackd -d firewire --help
jackd -d oss --help
jackd -d sun --help
jackd -d portaudio --help
اجرای دیمن JACK با اولویت بی‌درنگ (realtime) با استفاده از اولین کارت سخت‌افزاری ALSA تعریف‌شده در /etc/modules.conf.
- jackstart --realtime --driver=alsa
اجرای دیمن JACK با تاخیر کم همراه با خروجی پرجزئیات (verbose)، که می‌تواند برای عیب‌یابی مشکلات تاخیر سیستم مفید باشد. یک سیستم نسبتاً خوب تنظیم‌شده با یک کارت صدای مناسب و یک هسته با تاخیر کم می‌تواند این مقادیر را به شکلی مطمئن مدیریت کند. برخی سیستم‌ها عملکرد بهتری دارند. اگر با پیام‌های xrun مواجه شدید، بافر بزرگ‌تری را امتحان کنید. تنظیم یک سیستم برای تاخیر کم می‌تواند چالش‌برانگیز باشد. لطفاً برای پیشنهادات بیشتر به پرسش‌های متداول (FAQ) مربوط به JACK مراجعه کنید.
- jackstart -Rv -d alsa -p 128 -n 2 -r 44100
اجرای jackd با اولویت بی‌درنگ (realtime) با استفاده از دستگاه ALSA با نام «sblive» که در ~/.asoundrc تعریف شده است. اعمال دیترینگ شکل‌یافته (shaped dithering) بر روی پخش صدا.
- jackd -R -d alsa -d sblive --dither=shaped
اجرای jackd بدون مجوزهای ویژه با استفاده از دومین کارت سخت‌افزاری ALSA تعریف‌شده در /etc/modules.conf. هرگونه xrun گزارش‌شده توسط بک‌اند ALSA نادیده گرفته خواهد شد. بافر بزرگ‌تر به کاهش اتلاف داده‌ها کمک می‌کند. برای پخش از دیترینگ مستطیلی (rectangular dithering) استفاده خواهد شد.
- jackd -d alsa -d hw:1 -p2048 -n3 --softmode -zr
اجرای jackd در حالت دوطرفه کامل (full-duplex) با استفاده از دستگاه ALSA hw:0,0 برای بازپخش و دستگاه hw:0,2 برای ضبط.
- jackd -d alsa -P hw:0,0 -C hw:0,2
اجرای jackd در حالت فقط بازپخش با استفاده از دستگاه ALSA hw:0,0.
- jackd -d alsa -P hw:0,0
محیط (ENVIRONMENT)
JACK در حال توسعه سازوکاری برای راه‌اندازی خودکار سرور در صورت نیاز است. هر کلاینتی که بدون سرور JACK در حال اجرا راه‌اندازی شود، تلاش خواهد کرد تا خودش با استفاده از خط فرمانی که در اولین خط از $HOME/.jackdrc (در صورت وجود) یا /etc/jackdrc (در صورت عدم وجود اولی) آمده است، سرور را راه‌اندازی کند. اگر هیچ‌یک از این فایل‌ها وجود نداشته باشد، از یک فرمان پیش‌فرض توکار استفاده خواهد شد که شامل پرچم -T است؛ این پرچم باعث می‌شود سرور پس از خروج همه کلاینت‌ها خاموش شود.
به عنوان یک مرحله گذار، این عمل تنها زمانی رخ می‌دهد که $JACK_START_SERVER در محیط پردازش فراخواننده تعریف شده باشد. در آینده این رفتار عادی خواهد شد. در هر دو حالت، تعریف کردن $JACK_NO_START_SERVER این ویژگی را غیرفعال می‌کند.
برای تغییر مکانی که JACK در آن به دنبال درایورهای بک‌اند می‌گردد، $JACK_DRIVER_DIR را تنظیم کنید.
متغیر $JACK_DEFAULT_SERVER نام پیش‌فرض سرور را مشخص می‌کند. در صورت عدم تعریف، رشته «default» استفاده می‌شود. در صورت تنظیم در محیط‌های مربوطه، این مقدار بر روی jackd (مگر اینکه پارامتر --name آن تنظیم شده باشد) و همه کلاینت‌های JACK (مگر اینکه نامی صریح را به jack_client_open() ارسال کنند) تاثیر می‌گذارد.
تعریف متغیر $JACK_NO_AUDIO_RESERVATION رزرو دستگاه صوتی از طریق گذرگاه نشست (DBus) را دور می‌زند. این ویژگی می‌تواند زمانی مفید باشد که JACK با پشتیبانی از DBus کامپایل شده باشد اما باید روی یک سیستم بدون رابط گرافیکی و نمایشگر (headless) اجرا شود.
متغیر $JACK_PROMISCUOUS_SERVER روش جایگزینی را برای مدیریت منابع مشترک مختلف (سوکت‌های یونیکس، سمافورها و غیره) فعال می‌کند. در این حالت، نام‌های تولیدشده دیگر حاوی شناسه کاربری (user id) نخواهند بود و محدودیت مجوزهای آن منابع کاسته می‌شود، که به کلاینت‌های کاربران مختلف اجازه می‌دهد با یک سرور مشترک گفتگو کنند. علاوه بر این، در پلتفرم‌هایی که از آن پشتیبانی می‌کنند (همه انواع سازگار با POSIX)، اگر این متغیر روی یک نام یا شناسه گروه یونیکسی معتبر تنظیم شود، مجوزها به آن گروه محدود خواهد شد؛ بنابراین فقط اعضای آن گروه می‌توانند کلاینت‌هایی را راه‌اندازی کنند که با این سرور ارتباط برقرار می‌کنند. نکته مهم: برای اینکه عملکرد مطابق انتظار باشد، این متغیر باید برای هر دو سرور و کلاینت‌ها با مقداری یکسان تنظیم شود.
همچنین ببینید (SEE ALSO)
http://www.jackaudio.org
وبگاه رسمی JACK
شامل
اخبار،
مستندات و
فهرستی از
کلاینت‌های
JACK.
http://www.github.com/jackaudio
مخزن کد
رسمی JACK در
گیت‌هاب.
ارسال
درخواست‌های
ادغام (Pull requests)
مورد
استقبال
قرار
می‌گیرند.
http://lists.jackaudio.org/listinfo.cgi/jack-devel-jackaudio.org
لیست پستی
توسعه‌دهندگان
JACK. برای
مشارکت در
توسعه JACK یا
کلاینت‌های
JACK عضو شوید.
پرسش‌های
کاربران
نیز
پذیرفته
می‌شود،
لیست پستی
جداگانه‌ای
برای
کاربران
وجود
ندارد.
http://www.jackosx.com
ابزارهای
مختص به
نسخه Mac OS X
نرم‌افزار
JACK.
http://www.alsa-project.org
پروژه
معماری
پیشرفته
صوتی
لینوکس (ALSA).
http://www.ffado.org
وبگاه
درایورهای
صوتی آزاد
فایروایر
(FFADO).
<irc.freenode.net#jack>
با کلاینت IRC
دلخواه خود
به جامعه
کاربری JACK
بپیوندید..SH
"گزارش
باگ‌ها (BUGS)"
لطفاً
باگ‌ها را
به‌صورت issue
در مخزن
مربوطه
گزارش دهید:
http://www.github.com/jackaudio
نویسندگان (AUTHORS)
معمار و پیاده‌ساز اصلی: Paul Davis
گروه طراحی اولیه: Paul Davis، David Olofson، Kai Vehmanen، Benno Sennoner، Richard Guenther و دیگر اعضای گروه Linux Audio Developers.
برنامه‌نویسی: Paul Davis، Jack O'Quin، Taybin Rutkin، Stéphane Letz، Fernando Pablo Lopez-Lezcano، Steve Harris، Jeremy Hall، Andy Wingo، Kai Vehmanen، Melanie Thielker، Jussi Laako، Tilman Linneweh، Johnny Petrantoni، Torben Hohn.
صفحه راهنما توسط Stefan Schwandter، Jack O'Quin، Alexandre Prokoudine و Thomas Brand نوشته شده است.
ایجاد یک فایل PDF از این صفحه راهنما:
- man -t jackd | ps2pdf - > jackd.pdf
| February 2026 | 1.9.22 |