pw-reserve(1) General Commands Manual pw-reserve(1)

pw-reserve - ابزار رزرو دستگاه PipeWire

pw-reserve [گزینه‌ها]

یک دستگاه را با استفاده از طرح رزرو دستگاه DBus با نام org.freedesktop.ReserveDevice1 [1] رزرو کرده و تا زمان خاتمه یافتن توسط SIGINT یا سیگنالی دیگر منتظر می‌ماند.

همچنین می‌تواند از سایر برنامه‌ها درخواست کند که یک دستگاه را آزاد کنند. این قابلیت می‌تواند برای وادار کردن سرورهای صوتی مانند PipeWire، Pulseaudio، JACK یا سایر برنامه‌هایی که از پروتکل رزرو دستگاه پیروی می‌کنند استفاده شود تا یک دستگاه را نادیده بگیرند، یا دستگاه صوتی در حال استفاده را آزاد کنند تا سایر برنامه‌ها بتوانند از آن بهره ببرند.

-r | --release

از هر کلاینتی که در حال حاضر دستگاه را در اختیار دارد درخواست می‌کند تا آن را آزاد کند، و پس از آن برای رزرو آن تلاش می‌نماید. اگر این گزینه داده نشود و دستگاه از قبل در حال استفاده باشد، pw-reserve با وضعیت خطا خارج می‌شود.

-n NAME | --name=NAME

نام دستگاه برای رزرو. طبق قرارداد، این مقدار عبارت است از:
•
AudioN: برای کارت ALSA با شماره N

دستور pw-reserve می‌تواند هر نام دستگاهی را رزرو کند، با این حال در حال حاضر PipeWire از مقادیری به غیر از موارد ذکرشده در بالا پشتیبانی نمی‌کند.

-a NAME | --appname=NAME

نام برنامه‌ای که هنگام رزرو دستگاه استفاده می‌شود.

-p PRIO | --priority=PRIO

اولویت مورد استفاده هنگام رزرو دستگاه.

-m | --monitor

پایش رزروهای یک دستگاه مشخص، به جای رزرو کردن آن.

-h | --help

نمایش راهنما.

--version

نمایش اطلاعات نسخه.

اگر رزرو دستگاه با موفقیت انجام شود، pw-reserve تا زمانی که با یک سیگنال متوقف نشود خاتمه نمی‌یابد. در این حالت، اگر با SIGINT یا SIGTERM پایان یابد، با وضعیت 0 خارج می‌شود.

در غیر این صورت، با وضعیت خروج غیرصفر خارج خواهد شد.

pw-reserve -n Audio0

کارت ALSA شماره 0 را رزرو کرده، و در صورتی که از قبل رزرو شده باشد با خطا خارج می‌شود.

pw-reserve -n Audio0 -r

کارت ALSA شماره 0 را رزرو کرده و از هر برنامه‌ای که دستگاه را رزرو کرده می‌خواهد تا آن را برای ما آزاد کند.

توسعه‌دهندگان PipeWire https://gitlab.freedesktop.org/pipewire/pipewire/issues؛ پروژه PipeWire در https://pipewire.org در دسترس است.

[1] https://git.0pointer.net/reserve.git/tree/reserve.txt - طرحی ساده برای رزرو دستگاه با DBus

1.6.8 PipeWire