نام (NAME)

pulse-client.conf - فایل پیکربندی کلاینت پالس‌آدیو (PulseAudio)

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

~/.config/pulse/client.conf

~/.config/pulse/client.conf.d/*.conf

/etc/pulse/client.conf

/etc/pulse/client.conf.d/*.conf

توضیحات (DESCRIPTION)

کتابخانه کلاینت PulseAudio هنگام راه‌اندازی دستورالعمل‌های پیکربندی را از یک فایل پیکربندی می‌خواند. اگر فایل ویژه کاربر در مسیر ~/.config/pulse/client.conf وجود داشته باشد، از آن استفاده می‌شود؛ در غیر این صورت فایل پیکربندی سیستمی /etc/pulse/client.conf به کار می‌رود. علاوه بر این فایل‌های اصلی، دستورالعمل‌های پیکربندی را می‌توان در فایل‌های موجود در دایرکتوری‌های ~/.config/pulse/client.conf.d/ و /etc/pulse/client.conf.d/ نیز قرار داد. این فایل‌ها باید دارای پسوند نام فایل .conf باشند، اما نام آن‌ها به جز پسوند آزادانه انتخاب می‌شود. فایل‌های درون client.conf.d به ترتیب حروف الفبا پردازش می‌شوند. در صورتی که گزینه‌ای یکسان در چندین فایل تنظیم شده باشد، آخرین فایلی که آن را تنظیم کرده بر فایل‌های قبلی اولویت دارد. فایل اصلی client.conf ابتدا پردازش می‌شود، بنابراین گزینه‌های تنظیم‌شده در فایل‌های زیر client.conf.d فایل اصلی را بازنویسی می‌کنند.

فایل پیکربندی مجموعه‌ای ساده از تعریف متغیرها است. اگر مفسر فایل پیکربندی با نویسه‌های ; یا # مواجه شود، باقی خط را تا پایان نادیده می‌گیرد.

برای تنظیماتی که یک آرگومان بولی (boolean) می‌پذیرند، مقادیر true، yes، on و 1 هم‌ارز یکدیگر بوده و به همین ترتیب مقادیر false، no، off و 0 نیز معادل هم هستند.

دستورالعمل‌ها (DIRECTIVES)

default-sink= سینک پیش‌فرض برای اتصال. در صورت تعیین، تنظیمات دیمن را بازنویسی می‌کند. با این حال، متغیر محیطی $PULSE_SINK اولویت بالاتری دارد.

default-source= منبع (source) پیش‌فرض برای اتصال. در صورت تعیین، تنظیمات دیمن را بازنویسی می‌کند. با این حال، متغیر محیطی $PULSE_SOURCE اولویت بالاتری دارد.

default-server= کارساز (سرور) پیش‌فرض برای اتصال. متغیر محیطی $PULSE_SERVER اولویت بالاتری دارد.

autospawn= اجرای خودکار (autospawn) دیمن PulseAudio در صورت نیاز. یک مقدار بولی می‌پذیرد و پیش‌فرض آن yes است. توجه داشته باشید که تنظیم این گزینه روی «no» سرویس systemd را غیرفعال نمی‌کند. گزینه autospawn فقط برای استفاده در سیستم‌های فاقد systemd در نظر گرفته شده است. اگر برای اجرای PulseAudio از systemd استفاده می‌کنید، دستور «systemctl --user stop pulseaudio.service pulseaudio.socket» را برای توقف موقت دیمن، یا «systemctl --user mask pulseaudio.service pulseaudio.socket» را برای غیرفعال‌سازی دائمی واحدها به کار ببرید (دستور «disable» در systemctl احتمالاً کار نخواهد کرد، زیرا واحد pulseaudio.socket معمولاً در مسیر /usr/lib/systemd/user/sockets.target.wants/ نصب می‌شود که غیرفعال کردن واحد را با دستور disable غیرممکن می‌سازد).

daemon-binary= مسیر باینری دیمن PulseAudio برای اجرا هنگام اجرای خودکار. مقدار پیش‌فرض آن مسیری است که در زمان کامپایل پیکربندی شده است.

extra-arguments= آرگومان‌های اضافی برای ارسال به دیمن PulseAudio هنگام اجرای خودکار. مقدار پیش‌فرض --log-target=syslog است.

cookie-file= تعیین مسیر کوکی احراز هویت PulseAudio. مقدار پیش‌فرض ~/.config/pulse/cookie است.

enable-shm= فعال‌سازی انتقال داده از طریق حافظه اشتراکی POSIX یا memfd. یک آرگومان بولی می‌پذیرد و پیش‌فرض آن yes است. در صورت تنظیم روی no، ارتباط با سرور منحصراً از طریق کپی داده‌ها روی سوکت‌ها انجام خواهد شد.

enable-memfd= فعال‌سازی انتقال داده از طریق حافظه اشتراکی memfd. یک آرگومان بولی می‌پذیرد و پیش‌فرض آن yes است.

shm-size-bytes= تنظیم اندازه قطعه حافظه اشتراکی برای کلاینت‌ها، بر حسب بایت. اگر تعیین نشود یا روی 0 تنظیم گردد، از پیش‌فرض سیستم (معمولاً ۶۴ مبی‌بایت) استفاده می‌شود. لطفاً توجه داشته باشید که معمولاً نیازی به تغییر این مقدار نیست، مگر اینکه کرنل سیستم‌عاملی را اجرا کنید که بیش‌تخصیص حافظه (memory overcommit) را انجام نمی‌دهد.

auto-connect-localhost= تلاش خودکار برای اتصال به localhost از طریق IP. فعال‌سازی این مورد یک رخنه امنیتی بالقوه است زیرا اتصالات فقط به صورت یک‌طرفه احراز هویت می‌شوند و یک سرور مخرب می‌تواند کلاینت را فریب دهد تا داده‌های خصوصی خود (مانند داده‌های تماس VoIP) را برای آن ارسال کند. این گزینه در نسخه 0.9.21 و قدیمی‌تر PulseAudio به طور پیش‌فرض فعال بود. پیش‌فرض no است.

auto-connect-display= تلاش خودکار برای اتصال به میزبان تنظیم‌شده در متغیر $DISPLAY مربوط به X11. مسائل امنیتی مشابه با auto-connect-localhost= در اینجا نیز صدق می‌کند. پیش‌فرض no است.

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

توسعه‌دهندگان PulseAudio <pulseaudio-discuss (at) lists (dot) freedesktop (dot) org>؛ پالس‌آدیو از نشانی http://pulseaudio.org در دسترس است.

همچنین ببینید (SEE ALSO)

pulse-daemon.conf(5), pulseaudio(1)