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

pw-link - دستور پیوند PipeWire

pw-link [options] -o|-i|-l|-t [out-pattern] [in-pattern]

pw-link [options] output input

pw-link [options] -d output input

pw-link [options] -d link-id

فهرست کردن، ایجاد و حذف پیوندها بین درگاه‌های PipeWire.

-r | --remote=NAME

نام نمونهٔ remote جهت پایش. در صورت مشخص نشدن، اتصال به نمونهٔ پیش‌فرض PipeWire برقرار می‌شود.

-h | --help

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

--version

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

یکی از گزینه‌های -o، -i یا -l را برای فهرست کردن درگاه‌های ورودی و خروجی اختیاری مطابق و پیوندهای آن‌ها مشخص کنید.

-o | --output

فهرست کردن درگاه‌های خروجی

-i | --input

فهرست کردن درگاه‌های ورودی

-l | --links

فهرست کردن پیوندها

-t | --latency

فهرست کردن تأخیرهای درگاه

-m | --monitor

پایش پیوندها و درگاه‌ها. pw-link خارج نخواهد شد بلکه درگاه‌ها یا پیوندهای جدید و حذف‌شده را پایش و چاپ می‌کند.

-I | --id

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

-v | --verbose

ویژگی‌های مفصل درگاه. همچنین port-object-path و port-alias را نیز فهرست می‌کند.

بدون هیچ گزینهٔ فهرستی (-i، -o یا -l)، درگاه‌های داده‌شده به یکدیگر پیوند داده می‌شوند. مشخصه‌های معتبر درگاه عبارتند از:

port-id

همان‌طور که با گزینهٔ -I هنگام فهرست کردن درگاه‌ها به دست می‌آید.

node-name:port-name

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

port-object-path

همان‌طور که از نام جایگزین نخست درگاه هنگام فهرست کردن آن‌ها با گزینهٔ -v به دست می‌آید.

port-alias

همان‌طور که از نام جایگزین دوم درگاه هنگام فهرست کردن آن‌ها با گزینهٔ -v به دست می‌آید.

گزینه‌های اضافی هنگام پیوند دادن را می‌توان مشخص کرد:

-L | --linger

ماندگاری (Linger). پیوندی ایجاد می‌کند که پس از خاتمهٔ pw-link نیز باقی می‌ماند. این رفتار پیش‌فرض است، مگر اینکه گزینهٔ -m داده شود.

-P | --passive

پیوند غیرفعال (Passive). یک پیوند غیرفعال هر دو گره متصل‌شده را غیرفعال نگه می‌دارد مگر اینکه پیوند فعال دیگری آن گره‌ها را فعال کند. می‌توانید از این گزینه برای پیوند دادن یک sink به یک فیلتر استفاده کنید تا هر دو زمانی که هیچ چیز دیگری به آن‌ها متصل نیست، در حالت تعلیق قرار گیرند.

-p | --props=PROPS

ویژگی‌ها به صورت شیء JSON. هنگام ایجاد پیوند ویژگی‌های اضافی را مشخص کنید.

هنگامی که گزینهٔ -d داده شود، پیوند موجود میان درگاه‌ها حذف می‌شود.

برای قطع اتصال درگاه، می‌توان یک link-id واحد (همان‌طور که هنگام فهرست کردن پیوندها با گزینهٔ -I به دست می‌آید) یا دو مشخصهٔ درگاه را ارائه داد. برای مشخصه‌های معتبر درگاه، بخش اتصال درگاه‌ها را ببینید.

-d | --disconnect

قطع اتصال درگاه‌ها

pw-link -iol

فهرست کردن تمام درگاه‌ها و پیوندهای آن‌ها.

pw-link -lm

فهرست کردن تمام پیوندها و پایش تغییرات تا زمانی که pw-link متوقف شود.

pw-link paplay:output_FL alsa_output.pci-0000_00_1b.0.analog-stereo:playback_FL

پیوند دادن درگاه خروجی مشخص‌شده به درگاه ورودی.

pw-link -lI

فهرست کردن پیوندها و شناسهٔ آن‌ها.

pw-link -d 89

حذف پیوند با شناسهٔ 89.

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

pipewire(1), pw-cli(1)

1.6.8 PipeWire