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

نام (NAME)
       pw-link - دستور پیوند PipeWire


خلاصه دستور (SYNOPSIS)
       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


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


گزینه‌های عمومی (COMMON OPTIONS)
       -r | --remote=NAME
           نام نمونهٔ remote جهت پایش. در صورت مشخص نشدن، اتصال به نمونهٔ پیش‌فرض
           PipeWire برقرار می‌شود.

       -h | --help
           نمایش راهنما.

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

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


       -o | --output
           فهرست کردن درگاه‌های خروجی

       -i | --input
           فهرست کردن درگاه‌های ورودی

       -l | --links
           فهرست کردن پیوندها

       -t | --latency
           فهرست کردن تأخیرهای درگاه

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

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

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

اتصال درگاه‌ها (CONNECTING PORTS)
       بدون هیچ گزینهٔ فهرستی (-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. هنگام ایجاد پیوند ویژگی‌های اضافی را مشخص
           کنید.

قطع اتصال درگاه‌ها (DISCONNECTING PORTS)
       هنگامی که گزینهٔ -d داده شود، پیوند موجود میان درگاه‌ها حذف می‌شود.


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


       -d | --disconnect
           قطع اتصال درگاه‌ها

مثال‌ها (EXAMPLES)
       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.


نویسندگان (AUTHORS)
       توسعه‌دهندگان PipeWire
       <https://gitlab.freedesktop.org/pipewire/pipewire/issues>؛ PipeWire در
       <https://pipewire.org> در دسترس است


همچنین ببینید (SEE ALSO)
       pipewire(1), pw-cli(1)

PipeWire                             1.6.8                          pw-link(1)