نام (NAME)

libao.conf - پیکربندی برای libao.

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

/etc/libao.conf

~/.libao

توضیحات (DESCRIPTION)

libao.conf و .libao فایل‌های پیکربندی برای libao (کتابخانه خروجی صوتی) هستند. این فایل‌ها گزینه‌های مختلفی را برای libao مشخص می‌کنند، همان‌گونه که در ادامه شرح داده شده است. libao.conf گزینه‌ها را در سطح کل سیستم تنظیم می‌کند، در حالی که ~/.libao گزینه‌های مختص کاربر را تنظیم می‌نماید. هنگامی که یک گزینه در هر دو مکان تنظیم شده باشد، گزینه موجود در ~/.libao اولویت دارد.

قالب فایل (FILE FORMAT)

این فایل از کامنت‌ها و جفت‌های کلید-مقدار تشکیل شده است. کامنت‌ها در خطوطی جداگانه قرار دارند که با نماد # آغاز می‌شوند. جفت‌های کلید-مقدار به صورت زیر هستند:

key=value

که در آن key شامل هیچ فاصله خالی و هیچ علامت مساوی نیست. value شامل تمام متن پس از علامت مساوی تا انتهای خط (بدون احتساب خط جدید پایانی) خواهد بود. مراقب فاصله‌های اضافی در انتهای خط باشید! این فاصله‌ها احتمالا به عنوان بخشی از مقدار گزینه تفسیر خواهند شد.

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

default_driver: نام کوتاه درایوری که libao باید به طور پیش‌فرض استفاده کند. مقادیر معتبر عبارتند از (همه آن‌ها در هر پلتفرمی در دسترس نیستند): pulse, oss, esd, arts, alsa, nas, irix, sun, roar و sndio. توجه داشته باشید که "sun" در بسیاری از سیستم‌های BSD و همچنین Solaris استفاده می‌شود.
debug (مقدار اختیاری است/نادیده گرفته می‌شود): تمامی درایورها و همچنین خود AO را در حالت خروجی اشکال‌زدایی (debugging) قرار می‌دهد. برخلاف ارسال گزینه debug به یک درایور، debug اطلاعات اشکال‌زدایی حاصل از بارگذاری و آزمایش درایور را نیز چاپ خواهد کرد.
quiet (مقدار اختیاری است/نادیده گرفته می‌شود): تمامی درایورها و همچنین خود AO را در حالت خاموش (silent) قرار می‌دهد. در صورت بروز خطا تنها کدهای خطا بازگردانده می‌شوند؛ نه ao و نه درایورها هیچ خروجی در خروجی استاندارد خطا (stderr) چاپ نخواهند کرد.
verbose (مقدار اختیاری است/نادیده گرفته می‌شود): تمامی درایورها و همچنین خود AO را در حالت پرگویی (verbose) قرار می‌دهد.

مثال‌ها (EXAMPLES)

در اینجا نمونه‌ای از libao.conf آورده شده است که استفاده از درایور OSS را به صورت پیش‌فرض اجباری می‌کند:

# This is a comment.
default_driver=oss

گزارش باگ‌ها (BUGS)

libao.conf فاقد تعدادی از گزینه‌های بالقوه کاربردی است.

نویسندگان (AUTHORS)

Stan Seibert <volsung@xiph.org>