.TH "pw-cli" 1 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pw-cli \- رابط خط فرمان PipeWire

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

.PP
\fBpw-cli\fP [\fIcommand\fP]

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

.PP
تعامل با یک نمونهٔ PipeWire\&.

.PP
هنگامی که یک دستور داده شود، \fBpw-cli\fP دستور را اجرا کرده و خارج می‌شود\&.

.PP
اگر دستوری مشخص نشود، \fBpw-cli\fP یک نشست تعاملی با نمونهٔ پیش‌فرض PipeWire یعنی \fIpipewire-0\fP آغاز می‌کند\&.

.PP
امکان برقراری اتصال با سایر نمونه‌های دوردست (remote) نیز وجود دارد\&. نام نمونهٔ فعلی در اعلان خط فرمان نمایش داده می‌شود\&.

.PP
توجه داشته باشید که \fBpw-cli\fP همچنین یک نمونهٔ محلی از PipeWire ایجاد می‌کند\&. برخی دستورها بر روی نمونهٔ فعلی (دوردست) و برخی دیگر روی نمونهٔ محلی عمل می‌کنند، مانند بارگذاری ماژول‌ها\&.

.PP
از دستور \(aqhelp\(aq برای مشاهدهٔ فهرست دستورهای موجود استفاده کنید\&.

.PP
.SH "دستورهای عمومی (GENERAL COMMANDS)"
.PP

.PP
\fBhelp | h\fP
.RS 4
نمایش راهنمای سریع دربارهٔ دستورهای موجود\&. این دستور همچنین نام‌های مستعار (alias) بسیاری از دستورها را فهرست می‌کند\&.
.RE
.PP
\fBquit | q\fP
.RS 4
خروج از \fBpw-cli\fP\&.
.RE
.PP
\fBlist-vars\fP
.RS 4
فهرست کردن تمام متغیرهای شناخته‌شدهٔ فعلی و نوع آن‌ها\&. برخی دستورها اشیایی ایجاد می‌کنند که با یک متغیر مشخص می‌شوند\&.
.RE
.PP
.SH "مدیریت ماژول‌ها (MODULE MANAGEMENT)"
.PP

.PP
ماژول‌ها در نمونهٔ محلی (یعنی خود باینری pw-cli) بارگذاری و تخلیه می‌شوند و می‌توانند قابلیت‌ها یا اشیایی را به نمونهٔ محلی بیفزایند\&. در PipeWire امکان بارگذاری ماژول‌ها در نمونه‌ای دیگر وجود ندارد\&.

.PP
\fBload-module \fIname\fP [\fIarguments\&.\&.\&.\fP]\fP
.RS 4
بارگذاری یک ماژول با نام و آرگومان‌های مشخص‌شده در نمونهٔ محلی\&. بارگذاری بیش از یک‌بار برای اکثر ماژول‌ها بدون اشکال است\&.

.PP
این دستور متغیر ماژولی برمی‌گرداند که می‌تواند برای تخلیهٔ ماژول استفاده شود\&.

.PP
ماژول محلی در نمونهٔ دوردست قابل مشاهده \fIنیست\fP\&. در PipeWire امکان بارگذاری ماژول در یک نمونهٔ دوردست وجود ندارد\&. 
.RE
.PP

.PP
\fBunload-module \fImodule-var\fP\fP
.RS 4
تخلیهٔ یک ماژول با مشخص کردن متغیر آن\&.
.RE
.PP
.SH "درون‌نگری اشیاء (OBJECT INTROSPECTION)"
.PP

.PP
\fBlist-objects\fP
.RS 4
فهرست کردن اشیاء نمونهٔ فعلی\&.
.RE
.PP
اشیاء به همراه \fIid\fP، \fItype\fP و \fIversion\fP خود فهرست می‌شوند\&.

.PP
\fBinfo \fIid\fP | \fIall\fP\fP
.RS 4
دریافت اطلاعات دربارهٔ یک شیء مشخص یا همهٔ اشیاء (\fIall\fP)\&.
.RE
.PP
درخواست اطلاعات دربارهٔ یک شیء همچنین شما را از تغییرات آن مطلع خواهد کرد\&.

.PP
.SH "کار با نمونه‌های دوردست (WORKING WITH REMOTES)"
.PP

.PP
\fBconnect [\fIremote-name\fP]\fP
.RS 4
اتصال به یک نمونهٔ دوردست و تبدیل آن به نمونهٔ فعلی\&.

.PP
اگر نام دوردستی مشخص نشود، اتصال به نمونهٔ دوردست پیش‌فرض (معمولاً \fIpipewire-0\fP) برقرار می‌شود\&.

.PP
نام دوردستِ ویژهٔ \fIinternal\fP می‌تواند برای اتصال به نمونهٔ محلی PipeWire در \fBpw-cli\fP به کار رود\&.

.PP
این دستور یک متغیر دوردست (remote var) برمی‌گرداند که می‌تواند برای قطع اتصال یا تغییر نمونهٔ دوردست استفاده شود\&. 
.RE
.PP

.PP
\fBdisconnect [\fIremote-var\fP]\fP
.RS 4
قطع اتصال از یک \fIنمونهٔ دوردست\fP\&.

.PP
اگر نام دوردستی مشخص نشود، اتصال نمونهٔ فعلی قطع می‌شود\&. 
.RE
.PP

.PP
\fBlist-remotes\fP
.RS 4
فهرست کردن تمام \fIنمونه‌های دوردست\fP\&.
.RE
.PP
\fBswitch-remote [\fIremote-var\fP]\fP
.RS 4
تبدیل \fIنمونهٔ دوردست\fP مشخص‌شده به نمونهٔ فعلی\&.

.PP
اگر نام دوردستی مشخص نشود، نخستین نمونه به عنوان نمونهٔ فعلی در نظر گرفته می‌شود\&. 
.RE
.PP

.PP
.SH "مدیریت گره‌ها (NODE MANAGEMENT)"
.PP

.PP
\fBcreate-node \fIfactory-name\fP [\fIproperties\&.\&.\&.\fP]\fP
.RS 4
ایجاد یک گره (node) از یک factory در نمونهٔ فعلی\&.

.PP
ویژگی‌ها (properties) جفت‌های key=value هستند که با نویسهٔ فاصله جدا می‌شوند\&.

.PP
این دستور یک \fIمتغیر گره\fP برمی‌گرداند\&. 
.RE
.PP

.PP
\fBexport-node \fInode-id\fP [\fIremote-var\fP]\fP
.RS 4
برون‌ریزی یک گره از نمونهٔ محلی به نمونهٔ مشخص‌شده\&. در صورتی که نمونه‌ای تعیین نشود، گره به نمونهٔ فعلی صادر خواهد شد\&.
.RE
.PP
.SH "مدیریت دستگاه‌ها (DEVICE MANAGEMENT)"
.PP

.PP
\fBcreate-device \fIfactory-name\fP [\fIproperties\&.\&.\&.\fP]\fP
.RS 4
ایجاد یک دستگاه (device) از یک factory در نمونهٔ فعلی\&.

.PP
ویژگی‌ها جفت‌های key=value هستند که با نویسهٔ فاصله جدا می‌شوند\&.

.PP
این دستور یک \fIمتغیر دستگاه\fP برمی‌گرداند\&. 
.RE
.PP

.PP
.SH "مدیریت پیوندها (LINK MANAGEMENT)"
.PP

.PP
\fBcreate-link \fInode-id\fP \fIport-id\fP \fInode-id\fP \fIport-id\fP [\fIproperties\&.\&.\&.\fP]\fP
.RS 4
ایجاد یک پیوند (link) میان ۲ گره و درگاه (port)\&.

.PP
شناسه‌های درگاه (\fIport-id\fP) و شناسه‌های گره (\fInode-id\fP) را می‌توان روی \fR-\fP تنظیم کرد تا یک گره یا درگاه به طور خودکار انتخاب شود\&.

.PP
شناسه‌های درگاه می‌توانند \fR*\fP باشند تا درگاه‌های منطبق در گره‌ها به طور خودکار به هم پیوند داده شوند\&.

.PP
ویژگی‌ها جفت‌های key=value هستند که با نویسهٔ فاصله جدا می‌شوند\&.

.PP
این دستور یک یا چند \fIمتغیر پیوند\fP برمی‌گرداند\&. 
.RE
.PP

.PP
.SH "مدیریت سراسری‌ها (GLOBALS MANAGEMENT)"
.PP

.PP
\fBdestroy \fIobject-id\fP\fP
.RS 4
از بین بردن یک شیء سراسری (global)\&.
.RE
.PP
.SH "مدیریت پارامترها (PARAMETER MANAGEMENT)"
.PP

.PP
\fBenum-params \fIobject-id\fP \fIparam-id\fP\fP
.RS 4
شمارش و پیمایش پارامترهای یک شیء\&.

.PP
\fIparam-id\fP را می‌توان به عنوان نام کوتاه پارامتر نیز مشخص کرد\&. 
.RE
.PP

.PP
\fBset-param \fIobject-id\fP \fIparam-id\fP \fIparam-json\fP\fP
.RS 4
تنظیم پارامتر یک شیء\&.

.PP
\fIparam-id\fP را می‌توان به عنوان نام کوتاه پارامتر نیز مشخص کرد\&. 
.RE
.PP

.PP
.SH "مدیریت مجوزها (PERMISSION MANAGEMENT)"
.PP

.PP
\fBpermissions \fIclient-id\fP \fIobject-id\fP \fIpermission\fP\fP
.RS 4
تنظیم مجوزها برای یک کلاینت (client)\&.

.PP
\fIobject-id\fP می‌تواند برای تنظیم مجوزهای پیش‌فرض برابر \fI-1\fP باشد\&. 
.RE
.PP

.PP
\fBget-permissions \fIclient-id\fP\fP
.RS 4
دریافت مجوزهای یک کلاینت\&.
.RE
.PP
.SH "مدیریت دستورها (COMMAND MANAGEMENT)"
.PP

.PP
\fBsend-command \fIobject-id\fP\fP
.RS 4
ارسال یک دستور به یک شیء\&.
.RE
.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-mon(1)\fP,