نام (NAME)

pw-container - ابزار کانتینر PipeWire

خلاصه دستور (SYNOPSIS)

pw-container [گزینه‌ها] [PROGRAM]

توضیحات (DESCRIPTION)

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

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

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

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

هنگامی که PROGRAM مشخص شود، متغیر محیطی PIPEWIRE_REMOTE مقداردهی شده و PROGRAM به ()system ارسال می‌گردد. آرگومان‌های ارائه‌شده به PROGRAM باید به‌درستی درون نقل‌قول (کوتیشن) قرار گیرند.

گزینه‌ها (OPTIONS)

-P | --properties=VALUE

-r | --remote=NAME

-h | --help

--version

وضعیت خروج (EXIT STATUS)

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

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

مثال‌ها (EXAMPLES)

pw-container 'pw-dump i 0'

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

pw-container 'pw-dump pw-dump'

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

نویسندگان (AUTHORS)

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

همچنین ببینید (SEE ALSO)

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