.\" $OpenBSD$
.\"
.\" Copyright (c) 2014-2020 Alexandre Ratchov <alex@caoua.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate$
.Dt SNDIOCTL 1
.Os
.Sh "نام (NAME)"
.Nm sndioctl
.Nd دستکاری کنترل‌های دستگاه صوتی
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Bk -words
.Op Fl dimnqv
.Op Fl f Ar device
.Op Ar command ...
.Ek
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
می‌تواند کنترل‌های دستگاه‌های صوتی
.Xr sndio 7
مانند سطح صدای خروجی را نمایش داده یا دستکاری کند.
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl d
فهرست خام کنترل‌های موجود را تخلیه (dump) کرده و خارج می‌شود.
به عنوان ابزار اشکال‌زدایی مفید است.
.It Fl f Ar device
استفاده از این دستگاه صوتی
.Xr sndio 7 .
.It Fl i
نمایش ویژگی‌های کنترل‌های درخواستی به‌جای مقادیر آن‌ها.
.It Fl m
نظارت و نمایش تغییرات کنترل‌های صوتی.
.It Fl n
جلوگیری از چاپ نام متغیر.
.It Fl q
جلوگیری از هرگونه چاپ خروجی هنگام مقداردهی یک متغیر.
.It Fl v
فعال‌سازی حالت پرگو (verbose)، یا همان حالت چندکاناله.
به‌طور پیش‌فرض، کنترل‌هایی که بر کانال‌های مختلف یک استریم یکسان اثر می‌گذارند، در قالب یک کنترل مونو پنهان می‌شوند تا جزئیات غیرضروری نمایش داده نشوند.
.El
.Pp
اگر هیچ فرمانی مشخص نشود، تمام کنترل‌های معتبر روی
.Em stdout
نمایش داده می‌شوند.
مگر در صورتی که از
.Fl d ,
.Fl m ,
.Fl n
یا
.Fl i
استفاده شود، خطوط نمایش داده‌شده دستوراتی معتبر هستند.
مجموعه کنترل‌های در دسترس به دستگاه صوتی بستگی دارد.
.Pp
دستورات به ترتیب از دو قالب زیر برای نمایش و تغییر کنترل‌ها استفاده می‌کنند:
.Pp
.Dl [group/]stream[channel].function
.Dl [group/]stream[channel].function=value
.Pp
در سمت چپ، گروه کنترل (در صورت وجود)، نام استریم مربوطه و شماره کانال اختیاری مشخص می‌شوند.
نمونه‌هایی از عبارت‌های سمت چپ:
.Pp
.Dl output.level
.Dl output[0].level
.Pp
اگر شماره کانال (شامل براکت‌ها) حذف شود، فرمان به تمامی کانال‌ها اعمال می‌شود.
.Pp
مقادیر، اعدادی بین 0 و 1 هستند.
کنترل‌های دووضعیتی (کلیدها) مقادیر 0 یا 1 می‌گیرند که معمولاً به ترتیب متناظر با وضعیت‌های
.Em off
و
.Em on
هستند.
.Pp
اگر در ابتدای یک عدد اعشاری علامت مثبت (منفی) قرار گیرد، مقدار داده‌شده به مقدار فعلی کنترل اضافه (از آن کم) می‌شود.
اگر به‌جای عدد از
.Qq \&!
استفاده شود، وضعیت کلید معکوس می‌شود (تغییر وضعیت می‌دهد).
.Sh "مثال‌ها (EXAMPLES)"
افزایش کنترل
.Cm level
برای تمام کانال‌های
.Cm output
به میزان ۱۰٪ مقدار بیشینه:
.Pp
.Dl $ sndioctl output.level=+0.1
.Pp
بی‌صدا کردن تمام کانال‌های
.Cm output :
.Pp
.Dl $ sndioctl output.mute=1
.Pp
تغییر وضعیت کنترل
.Cm mute
فوق:
.Pp
.Dl $ sndioctl output.mute=!
.Pp
مجاز کردن ضبط صدا و تنظیم تمام کانال‌های
.Cm input
روی ۵۰٪:
.Bd -literal -offset indent
# sysctl kern.audio.record=1
$ sndioctl input.mute=0 input.level=0.5
.Ed
.Sh "همچنین ببینید (SEE ALSO)"
.Xr sioctl_open 3