.TH "pw-link" 1 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pw-link \- دستور پیوند PipeWire

.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP

.PP
\fBpw-link\fP [\fIoptions\fP] -o|-i|-l|-t [\fIout-pattern\fP] [\fIin-pattern\fP]

.PP
\fBpw-link\fP [\fIoptions\fP] \fIoutput\fP \fIinput\fP

.PP
\fBpw-link\fP [\fIoptions\fP] -d \fIoutput\fP \fIinput\fP

.PP
\fBpw-link\fP [\fIoptions\fP] -d \fIlink-id\fP

.PP
.SH "توضیحات (DESCRIPTION)"
.PP

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

.PP
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.PP

.PP
\fB-r | --remote=NAME\fP
.RS 4
نام نمونهٔ \fIremote\fP جهت پایش\&. در صورت مشخص نشدن، اتصال به نمونهٔ پیش‌فرض PipeWire برقرار می‌شود\&.
.RE
.PP
\fB-h | --help\fP
.RS 4
نمایش راهنما\&.
.RE
.PP
\fB--version\fP
.RS 4
نمایش اطلاعات نسخه\&.
.RE
.PP
.SH "فهرست کردن درگاه‌ها و پیوندها (LISTING PORTS AND LINKS)"
.PP

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

.PP
\fB-o | --output\fP
.RS 4
فهرست کردن درگاه‌های خروجی
.RE
.PP
\fB-i | --input\fP
.RS 4
فهرست کردن درگاه‌های ورودی
.RE
.PP
\fB-l | --links\fP
.RS 4
فهرست کردن پیوندها
.RE
.PP
\fB-t | --latency\fP
.RS 4
فهرست کردن تأخیرهای درگاه
.RE
.PP
\fB-m | --monitor\fP
.RS 4
پایش پیوندها و درگاه‌ها\&. \fBpw-link\fP خارج نخواهد شد بلکه درگاه‌ها یا پیوندهای جدید و حذف‌شده را پایش و چاپ می‌کند\&.
.RE
.PP
\fB-I | --id\fP
.RS 4
فهرست کردن شناسه‌ها\&. همچنین شناسه‌های یکتای پیوند و درگاه را فهرست می‌کند\&.
.RE
.PP
\fB-v | --verbose\fP
.RS 4
ویژگی‌های مفصل درگاه\&. همچنین port-object-path و port-alias را نیز فهرست می‌کند\&.
.RE
.PP
.SH "اتصال درگاه‌ها (CONNECTING PORTS)"
.PP

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

.PP
\fIport-id\fP

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

.PP
\fInode-name:port-name\fP

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

.PP
\fIport-object-path\fP

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

.PP
\fIport-alias\fP

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

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

.PP
\fB-L | --linger\fP
.RS 4
ماندگاری (Linger)\&. پیوندی ایجاد می‌کند که پس از خاتمهٔ \fBpw-link\fP نیز باقی می‌ماند\&. این رفتار پیش‌فرض است، مگر اینکه گزینهٔ -m داده شود\&.
.RE
.PP
\fB-P | --passive\fP
.RS 4
پیوند غیرفعال (Passive)\&. یک پیوند غیرفعال هر دو گره متصل‌شده را غیرفعال نگه می‌دارد مگر اینکه پیوند فعال دیگری آن گره‌ها را فعال کند\&. می‌توانید از این گزینه برای پیوند دادن یک sink به یک فیلتر استفاده کنید تا هر دو زمانی که هیچ چیز دیگری به آن‌ها متصل نیست، در حالت تعلیق قرار گیرند\&.
.RE
.PP
\fB-p | --props=PROPS\fP
.RS 4
ویژگی‌ها به صورت شیء JSON\&. هنگام ایجاد پیوند ویژگی‌های اضافی را مشخص کنید\&.
.RE
.PP
.SH "قطع اتصال درگاه‌ها (DISCONNECTING PORTS)"
.PP

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

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

.PP
\fB-d | --disconnect\fP
.RS 4
قطع اتصال درگاه‌ها
.RE
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
\fBpw-link\fP -iol

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

.PP
\fBpw-link\fP -lm

.PP
فهرست کردن تمام پیوندها و پایش تغییرات تا زمانی که \fBpw-link\fP متوقف شود\&.

.PP
\fBpw-link\fP paplay:output_FL alsa_output\&.pci-0000_00_1b\&.0\&.analog-stereo:playback_FL

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

.PP
\fBpw-link\fP -lI

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

.PP
\fBpw-link\fP -d 89

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

.PP
.SH "نویسندگان (AUTHORS)"
.PP

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

.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP

.PP
\fBpipewire(1)\fP, \fBpw-cli(1)\fP