نام (NAME)

wireplumber - مدیر نشست PipeWire

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

wireplumber [-c|--config-file=FILE] [-p|--profile=PROFILE] [-v|--version]

توضیحات (DESCRIPTION)

wireplumber دیمن WirePlumber است، یک مدیر نشست و خط‌مشی پیمانه‌ای برای PipeWire. این برنامه به خودی خود کاری انجام نمی‌دهد مگر بارگذاری مؤلفه‌های فهرست‌شده در پروفایل انتخاب‌شده؛ تمام منطق مدیریتی واقعی — راه‌اندازی دستگاه‌ها، پیوند دادن جریان‌ها، اعطای مجوزها به کلاینت‌ها — در همان مؤلفه‌ها پیاده‌سازی شده است.

این برنامه معمولاً به جای اجرای دستی، به صورت یک سرویس کاربری systemd اجرا می‌شود:

$ systemctl --user status wireplumber

گزینه‌ها (OPTIONS)

-c, --config-file=FILE: استفاده از FILE به عنوان فایل پیکربندی اصلی به جای wireplumber.conf. پوشه قطعات پیکربندی مربوطه یعنی FILE.d/ نیز بارگذاری می‌شود.
-p, --profile=PROFILE: بارگذاری PROFILE به جای پروفایل پیش‌فرض main. به این ترتیب نمونه دوم تنها با بخشی از قابلیت‌ها راه‌اندازی می‌شود؛ بخش «اجرای چندین نمونه» را در <#daemon-multi-instance> ببینید.
-v, --version: چاپ نسخه برنامه و خروج.

محیط (ENVIRONMENT)

WIREPLUMBER_DEBUG: سطح گزارش‌گیری و سطوح گزارش‌گیری بر پایه موضوع را تعیین می‌کند. بخش «گزارش‌گیری اشکال‌زدایی» را در <#daemon-logging> ببینید.
WIREPLUMBER_CONFIG_DIR: پوشه‌ای را که در ابتدا برای یافتن فایل‌های پیکربندی جستجو می‌شود، لغو و جایگزین می‌کند.
WIREPLUMBER_DATA_DIR: پوشه‌ای را که در ابتدا برای یافتن فایل‌های داده، مانند اسکریپت‌ها، جستجو می‌شود، لغو و جایگزین می‌کند.
WIREPLUMBER_MODULE_DIR: پوشه‌ای را که در ابتدا برای یافتن ماژول‌ها جستجو می‌شود، لغو و جایگزین می‌کند.

بخش «محل‌های فایل‌های WirePlumber» را در <#daemon-file-locations> برای ترتیب کامل جستجوی هر یک از این موارد ببینید.

فایل‌ها (FILES)

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

$XDG_CONFIG_HOME/wireplumber/: پیکربندی کاربر؛ ~/.config/wireplumber/ مگر آن‌که $XDG_CONFIG_HOME تنظیم شده باشد.
$XDG_CONFIG_DIRS/wireplumber/: پیکربندی مختص میزبان؛ /etc/xdg/wireplumber/ مگر آن‌که $XDG_CONFIG_DIRS تنظیم شده باشد.
/etc/wireplumber/: پیکربندی مختص میزبان، در $sysconfdir زمان کامپایل.
$XDG_DATA_DIRS/wireplumber/: پیکربندی ارائه‌شده توسط توزیع؛ /usr/local/share/wireplumber/ و /usr/share/wireplumber/ مگر آن‌که $XDG_DATA_DIRS تنظیم شده باشد.
/usr/share/wireplumber/: پیکربندی عرضه‌شده به همراه WirePlumber، در $datadir زمان کامپایل.

در هر یک از این پوشه‌ها، wireplumber.conf فایل پیکربندی اصلی و wireplumber.conf.d/*.conf قطعاتی هستند که در آن ادغام می‌شوند. تنها نخستین wireplumber.conf یافت‌شده بارگذاری می‌شود، اما قطعات از تمام پوشه‌ها به ترتیب معکوس اولویت بارگذاری می‌شوند، به‌طوری که یک قطعه در پوشه با اولویت بالاتر، موارد پایین‌تر از خود را جایگزین می‌کند.

اسکریپت‌ها و سایر فایل‌های داده در زیرپوشه scripts از پوشه‌های زیر جستجو می‌شوند، مجدداً از بالاترین به پایین‌ترین اولویت:

$XDG_DATA_HOME/wireplumber/: اسکریپت‌های ارائه‌شده توسط کاربر؛ ~/.local/share/wireplumber/ مگر آن‌که $XDG_DATA_HOME تنظیم شده باشد.
$XDG_DATA_DIRS/wireplumber/: اسکریپت‌های مختص میزبان؛ /usr/local/share/wireplumber/ و /usr/share/wireplumber/ مگر آن‌که $XDG_DATA_DIRS تنظیم شده باشد.
/usr/share/wireplumber/: اسکریپت‌های عرضه‌شده به همراه WirePlumber، در $datadir زمان کامپایل.

سایر مکان‌ها بدون ترتیب خاصی جستجو می‌شوند:

/usr/lib/wireplumber-0.5/: ماژول‌های WirePlumber، در $libdir زمان کامپایل. در سیستم‌های چندمعماری (multiarch) این مسیر /usr/lib/<arch-triplet>/wireplumber-0.5/ است. ماژول‌های PipeWire و SPA در عوض از پوشه‌های ماژول خود PipeWire بارگذاری می‌شوند.
$XDG_STATE_HOME/wireplumber/: وضعیت ذخیره‌شده: گره‌های پیش‌فرض، پروفایل‌ها و مسیرهای دستگاه، ویژگی‌های جریان و تنظیماتی که در زمان اجرا تغییر کرده‌اند. این مسیر ~/.local/state/wireplumber/ است مگر آن‌که $XDG_STATE_HOME تنظیم شده باشد.

وضعیت خروج (EXIT STATUS)

کدهای خروج از قراردادهای sysexits.h(3head) پیروی می‌کنند:

0 (EX_OK): موفقیت‌آمیز.
64 (EX_USAGE): خطای نحوه استفاده در خط فرمان.
69 (EX_UNAVAILABLE): یک سرویس مورد نیاز در دسترس نبود؛ معمولاً WirePlumber نتوانسته است به PipeWire متصل شود.
70 (EX_SOFTWARE): خطای داخلی نرم‌افزار.
78 (EX_CONFIG): خطای پیکربندی.

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

wpctl(1), wpexec(1), pipewire(1), pw-cli(1), pw-dump(1), sysexits.h(3head)

مستندات WirePlumber: https://pipewire.pages.freedesktop.org/wireplumber

نویسنده (AUTHOR)

توسعه‌دهندگان WirePlumber

حق نشر (COPYRIGHT)

2020-2025, Collabora & contributors