.TH "pw-container" 1 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pw-container \- ابزار کانتینر PipeWire

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

.PP
\fBpw-container\fP [\fIگزینه‌ها\fP] [\fIPROGRAM\fP]

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

.PP
اجرای یک برنامه در یک بافت امنیتی (security context) جدید [1]\&.

.PP
دستور \fBpw-container\fP یک سوکت موقت یونیکس ایجاد کرده و از API افزونهٔ SecurityContext برای راه‌اندازی یک سرور روی این سوکت با مشخصه‌های ارائه‌شده استفاده می‌کند\&. کلاینت‌هایی که از این سوکت سرور ایجاد می‌شوند، مشخصه‌های امنیتی به آن‌ها ضمیمه خواهد شد\&.

.PP
از این ابزار می‌توان برای شبیه‌سازی رفتار Flatpak یا سایر کانتینرها استفاده کرد\&.

.PP
بدون ارائهٔ هرگونه آرگومان، \fBpw-container\fP صرفاً سوکت جدید را ایجاد کرده و نشانی آن را در stdout چاپ می‌کند\&. سپس می‌توان سایر برنامه‌های PipeWire را با \fRPIPEWIRE_REMOTE=<socket-address>\fP اجرا کرد تا از طریق این بافت امنیتی متصل شوند\&.

.PP
هنگامی که \fIPROGRAM\fP مشخص شود، متغیر محیطی \fRPIPEWIRE_REMOTE\fP مقداردهی شده و \fIPROGRAM\fP به ()system ارسال می‌گردد\&. آرگومان‌های ارائه‌شده به \fIPROGRAM\fP باید به‌درستی درون نقل‌قول (کوتیشن) قرار گیرند\&.

.PP
.SH "گزینه‌ها (OPTIONS)"
.PP

.PP
\fB-P | --properties=VALUE\fP
.RS 4
تنظیم ویژگی‌های اضافی بافت به عنوان یک شیء JSON\&.
.RE
.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 "وضعیت خروج (EXIT STATUS)"
.PP

.PP
در صورتی که بافت امنیتی با موفقیت ایجاد شود، \fBpw-container\fP تا زمانی که توسط یک سیگنال متوقف نشود خاتمه نمی‌یابد\&. در این حالت اگر توسط SIGINT یا SIGTERM پایان یابد، با وضعیت 0 خارج می‌شود\&.

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

.PP
.SH "مثال‌ها (EXAMPLES)"
.PP

.PP
\fBpw-container\fP 'pw-dump i 0'

.PP
اجرای pw-dump برای شیء Core\&. به تفاوت دسترسی‌های شیء هنگام اجرای pw-dump با و بدون \fBpw-container\fP دقت کنید\&.

.PP
\fBpw-container\fP 'pw-dump pw-dump'

.PP
اجرای pw-dump از خود برنامه\&. به تفاوت توکن‌های امنیتی کلاینت هنگام اجرای pw-dump با و بدون \fBpw-container\fP دقت کنید\&.

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

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

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

.PP
[1] https://gitlab.freedesktop.org/wayland/wayland-protocols/-/blob/main/staging/security-context/security-context-v1.xml \- ایجاد یک بافت امنیتی