.TH ALSACTL 1 "07 May 2014"
.SH "نام (NAME)"
alsactl \- کنترل‌های پیشرفته برای راه‌انداز کارت صدای ALSA

.SH "خلاصه دستور (SYNOPSIS)"

\fBalsactl\fP [\fIگزینه‌ها\fP] [\fIstore\fP|\fIrestore\fP|\fIinit\fP] <شماره، شناسه یا دستگاه کارت>
.PP
\fBalsactl\fP \fImonitor\fP <شماره یا شناسه کارت>
.PP
\fBalsactl\fP \fIinfo\fP <شماره یا شناسه کارت>
.PP
\fBalsactl\fP [\fIclean\fP] <شماره، شناسه یا دستگاه کارت> [[\fIشناسه‌های عنصر کنترل\fP]]

.SH "توضیحات (DESCRIPTION)"
دستور \fBalsactl\fP برای کنترل تنظیمات پیشرفته برای راه‌اندازهای کارت صدای ALSA استفاده می‌شود. این ابزار از چندین کارت صدا پشتیبانی می‌کند. اگر کارت صدای شما دارای قابلیت‌هایی است که به نظر نمی‌رسد از طریق یک برنامه میکسر قابل کنترل باشند، به جای درستی آمده‌اید.

.SH "دستورات (COMMANDS)"

.SS "مقدمه (Introduction)"

آرگومان \fI<card>\fP اختیاری است. اگر هیچ کارت صدایی مشخص نشود، پیکربندی تمام کارت‌ها ذخیره، بارگذاری یا پایش خواهد شد.

.SS "store <card>"

این دستور وضعیت فعلی راه‌انداز را برای کارت صدای انتخاب‌شده در فایل پیکربندی ذخیره می‌کند.

.SS "restore <card>"

این دستور وضعیت راه‌انداز را برای کارت صدای انتخاب‌شده از فایل پیکربندی بارگذاری می‌کند. اگر بازیابی ناموفق باشد (یا بخشی از آن با شکست مواجه شود)، عملیات init فراخوانی می‌شود.

.SS "nrestore <card>"

این دستور شبیه به \fIrestore\fP است، اما به دیمن نیز اطلاع می‌دهد تا پویش جدیدی برای کارت‌های صدای موجود انجام دهد.

.SS "init <card>"

این دستور تلاش می‌کند تمام دستگاه‌ها را به حالت پیش‌فرض مقداردهی اولیه کند. اگر دستگاه شناخته‌شده نباشد، کد خطای 99 بازگردانده می‌شود.

.SS "daemon"

این دستور وظیفهٔ ذخیرهٔ دوره‌ای وضعیت صدا را مدیریت می‌کند.

.SS "rdaemon"

این دستور مشابه \fIdaemon\fP است، اما در ابتدا وضعیت صدا را بازیابی می‌کند.

.SS "kill <cmd>"

این دستور به دیمن اطلاع می‌دهد تا عملیات مشخص‌شده را اجرا کند (quit، rescan، save_and_quit).

.SS "monitor <card>"

این دستور برای پایش و نظارت بر رویدادهای دریافتی از دستگاه کنترل مشخص‌شده به کار می‌رود.

.SS "info <card>"

این دستور اطلاعات عمومی جمع‌آوری‌شده از دستگاه کنترل مشخص‌شده (کارت صدا) را در قالب YAML نمایش می‌دهد.

.SS "clean <card> [filter]"

این دستور کنترل‌های ایجادشده توسط برنامه‌های کاربردی را پاکسازی می‌کند.

شناسه‌های اختیاری عناصر به عنوان فیلتر پذیرفته می‌شوند. یک آرگومان اضافی به عنوان شناسهٔ عناصر پردازش می‌شود.
.PP
\fIمثال:\fP alsactl clean 0 "name='PCM'" "name='Mic Phantom'"

.SS "dump-state"

این دستور وضعیت فعلی (تمام کارت‌ها) را در خروجی استاندارد (stdout) می‌ریزد.

.SS "dump-cfg"

این دستور پیکربندی فعلی (تمام کارت‌ها) را در خروجی استاندارد (stdout) می‌ریزد. توجه داشته باشید که قلاب‌های پیکربندی (configuration hooks) ارزیابی می‌شوند.

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

.TP
\fI\-h, \-\-help\fP
راهنما: گزینه‌ها و دستورات در دسترس را نمایش می‌دهد.

.TP
\fI\-d, \-\-debug\fP
استفاده از حالت اشکال‌زدایی: نمایش خروجی با جزئیات بیشتر.

.TP
\fI\-v, \-\-version\fP
شماره نسخه alsactl را چاپ می‌کند.

.TP
\fI\-f, \-\-file\fP
فایل پیکربندی مورد استفاده را انتخاب می‌کند. مقدار پیش‌فرض /var/lib/alsa/asound.state است.

.TP
\fI\-a, \-\-config-dir\fP
دایرکتوری پیکربندی بوت / اتصال گرم (hotplug) مربوط به ALSA را برای استفاده انتخاب می‌کند. مقدار پیش‌فرض /var/lib/alsa است.

.TP
\fI\-l, \-\-lock\fP
استفاده از قفل‌گذاری فایل برای همگام‌سازی دسترسی همزمان به فایل وضعیت (این گزینه برای فایل وضعیت سراسری پیش‌فرض است).

.TP
\fI\-L, \-\-no-lock\fP
از قفل‌گذاری فایل برای همگام‌سازی دسترسی همزمان به فایل وضعیت استفاده نمی‌کند (از جمله برای فایل وضعیت سراسری).

.TP
\fI\-O, \-\-lock-state-file\fP
مسیر فایل قفل وضعیت را مشخص می‌کند.

.TP
\fI\-F, \-\-force\fP
همراه با دستور restore استفاده می‌شود. تلاش می‌کند تا حد امکان عناصر کنترلی منطبق را بازیابی کند. این گزینه در حال حاضر به صورت پیش‌فرض تنظیم شده است.

.TP
\fI\-g, \-\-ignore\fP
همراه با دستورات store، restore و init استفاده می‌شود. در صورتی که هیچ کارت صدایی نصب نشده باشد، پیام 'No soundcards found' را نمایش نمی‌دهد و کد خروج خطا را تنظیم نمی‌کند.

.TP
\fI\-P, \-\-pedantic\fP
همراه با دستور restore استفاده می‌شود. عناصر کنترلی نامنطبق را بازیابی نمی‌کند. این گزینه رفتار پیش‌فرض پیشین بود.

.TP
\fI\-I, \-\-no\-init\-fallback\fP
در صورت ناموفق بودن بازیابی، کارت‌ها را مقداردهی اولیه نمی‌کند. از نسخه 1.0.18، دستور \fBalsactl\fP به عنوان پیش‌فرض تلاش می‌کند با عملیات restore کارت را مقداردهی اولیه کند. اما این رفتار می‌تواند با نسخه‌های قدیمی‌تر ناسازگاری ایجاد کند؛ زیرا فراخواننده ممکن است انتظار داشته باشد در صورتی که فایل وضعیت وجود ندارد، تغییری در وضعیت ایجاد نشود. این گزینه با جلوگیری از مقداردهی اولیه، رفتار بازیابی را به نسخه قدیمی‌تر بازمی‌گرداند.

.TP
\fI\-r, \-\-runstate\fP
وضعیت‌های restore و init را در این فایل ذخیره می‌کند. این فایل تنها شامل خطاها خواهد بود. خطاها به همراه شناسه کارت صدا به انتهای فایل الحاق می‌شوند.

.TP
\fI\-R, \-\-remove\fP
در ابتدا فایل runstate را حذف می‌کند.

.TP
\fI\-E, \-\-env\fP #=#
یک متغیر محیطی تنظیم می‌کند (برای عملیات init مفید است یا می‌توانید ALSA_CONFIG_PATH را بازنویسی کنید تا پیکربندی متفاوتی یا بهینه‌شده خوانده شود - ممکن است برای اسکریپت‌های "بوت" مفید باشد).

.TP
\fI\-i, \-\-initfile\fP
فایل پیکربندی برای init. به صورت پیش‌فرض، از PREFIX/share/alsa/init/00main استفاده می‌شود.

.TP
\fI\-p, \-\-period\fP
دورهٔ زمانی ذخیره‌سازی بر حسب ثانیه برای دستور daemon.

.TP
\fI\-e, \-\-pid-file\fP
مسیر فایل برای ذخیرهٔ شناسه پردازه (PID) در قالب HDB UUCP (اسکی - ASCII).

.TP
\fI\-b, \-\-background\fP
اجرای وظیفه در پس‌زمینه.

.TP
\fI\-s, \-\-syslog\fP
استفاده از syslog برای پیام‌ها.

.TP
\fI\-n, \-\-nice\fP
اولویت پردازه را تنظیم می‌کند (به 'man nice' مراجعه کنید).

.TP
\fI\-c, \-\-sched-idle\fP
سیاست زمان‌بندی پردازه را روی حالت بیکار (SCHED_IDLE) قرار می‌دهد.

.TP
\fI\-D, \-\-ucm-defaults\fP
بخش 'defaults' را نیز از پیکربندی UCM اجرا می‌کند. رفتار استاندارد تنها اجرای بخش 'once' است.

.TP
\fI\-U, \-\-no-ucm\fP
از مقداردهی اولیه UCM صرف‌نظر می‌کند حتی اگر در دسترس باشد. این گزینه برای آزمودن پیکربندی سنتی (legacy) مقداردهی اولیه می‌تواند مفید باشد.

.SH "فایل‌ها (FILES)"
فایل \fI/var/lib/alsa/asound.state\fP (یا هر فایلی که با گزینه \fB\-f\fP مشخص کنید) برای ذخیره تنظیمات فعلی کارت‌های صدای شما به کار می‌رود. این تنظیمات شامل تمام تنظیمات معمول میکسر کارت صدا است. مهم‌تر از همه، \fBalsactl\fP قادر است سایر قابلیت‌های خاص کارت را که برنامه‌های میکسر معمولاً از آن‌ها بی‌اطلاع هستند، کنترل کند.
.PP
فایل پیکربندی با اجرای دستور \fBalsactl store\fP به طور خودکار تولید می‌شود. ممکن است ویرایش دستی فایل پیکربندی برای برخی از قابلیت‌های کارت صدا ضروری باشد (مانند فعال/غیرفعال کردن بهره خودکار میکروفون، خروجی دیجیتال، پورت‌های جوی‌استیک/بازی، برخی گزینه‌های آینده مسیریابی MIDI و غیره).

.SH "همچنین ببینید (SEE ALSO)"
\fB
amixer(1),
alsamixer(1),
aplay(1),
alsactl_init(7)
\fP

.SH "باگ‌ها (BUGS)"
موردی شناخته نشده است.

.SH "نویسندگان (AUTHORS)"
برنامهٔ \fBalsactl\fP توسط Jaroslav Kysela <perex@perex.cz> و Abramo Bagnara <abramo@alsa\-project.org> توسعه یافته است. این سند توسط Paul Winkler <zarmzarm@erols.com> نگاشته شده است.