'\" t
.\"     Title: flatpak run
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak run
.\"    Source: flatpak
.\"  Language: English
.\"
.TH "FLATPAK RUN" "1" "" "flatpak" "flatpak run"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
flatpak-run \- اجرای یک برنامه یا باز کردن شل در یک محیط زمان اجرا (runtime)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ run\fR\ 'u
\fBflatpak run\fR [OPTION...] REF [ARG...]
.SH "توضیحات (DESCRIPTION)"
.PP
اگر
REF
نام یک برنامهٔ نصب‌شده باشد، فلت‌پک برنامه را در یک محیط ایزوله‌شده (سندباکس) اجرا می‌کند\&. آرگومان‌های اضافی به برنامه منتقل می‌شوند\&. شاخه و معماری جاری برنامه استفاده خواهد شد مگر اینکه با گزینه‌های
\fB\-\-branch\fR
یا
\fB\-\-arch\fR
به صورت دیگری مشخص شده باشد\&. نگاه کنید به
\fBflatpak-make-current\fR(1)\&.
.PP
اگر
REF
نام یک محیط زمان اجرا (runtime) باشد، یک شل در آن باز می‌شود\&. این کار برای توسعه و آزمایش مفید است\&. در صورت وجود ابهام در انتخاب شاخه، از شما خواسته می‌شود یکی را انتخاب کنید\&. برای جلوگیری از این حالت از گزینهٔ
\fB\-\-branch\fR
استفاده کنید\&. معماری اصلی استفاده می‌شود مگر اینکه با
\fB\-\-arch\fR
به‌طور دیگری مشخص شده باشد\&.
.PP
به‌طور پیش‌فرض، فلت‌پک ابتدا برنامه یا محیط زمان اجرا را در نصب‌های ویژهٔ کاربر (per\-user) و سپس در تمام نصب‌های سیستمی جستجو می‌کند\&. این رفتار را می‌توان با گزینه‌های
\fB\-\-user\fR،
\fB\-\-system\fR
و
\fB\-\-installation\fR
تغییر داد\&.
.PP
فلت‌پک با سوار کردن (mount) ران‌تایم مناسب در
/usr
و یک دایرکتوری قابل نوشتن در
/var
(که محتوای آن بین اجراهای مختلف برنامه حفظ می‌شود)، یک محیط ایزوله برای اجرای برنامه ایجاد می‌کند\&. خود برنامه نیز در
/app
سوار می‌شود\&.
.PP
جزئیات محیط ایزوله توسط متادیتای برنامه و گزینه‌های مختلفی مانند
\fB\-\-share\fR
و
\fB\-\-socket\fR
که به دستور run ارسال می‌شوند، کنترل می‌گردد: دسترسی مجاز است اگر در فایل متادیتای برنامه یا با یک گزینه درخواست شده باشد و کاربر آن را لغو نکرده باشد\&.
.PP
سایر آرگومان‌ها به دستوری که در محیط ایزوله اجرا می‌شود ارسال می‌شوند\&. برای نحوهٔ مدیریت آرگومان‌های فایل، به گزینهٔ
\fB\-\-file\-forwarding\fR
مراجعه کنید\&.
.PP
متغیرهای محیطی معمولاً با برخی استثناها به برنامهٔ درون محیط ایزوله منتقل می‌شوند، مگر اینکه
\fB\-\-clear\-env\fR
مشخص شده باشد\&. متادیتای برنامه می‌تواند متغیرهای محیطی را بازنویسی کند، همان‌طور که گزینهٔ
\fB\-\-env\fR
می‌تواند\&. علاوه بر این، فلت‌پک همیشه متغیرهای زیر را حذف یا لغو می‌کند، زیرا مقادیر نشست آن‌ها احتمالاً با عملکرد محیط ایزوله تداخل دارند:
.RS 4
PATH
.RE
.RS 4
LD_LIBRARY_PATH
.RE
.RS 4
LD_PRELOAD
.RE
.RS 4
LD_AUDIT
.RE
.RS 4
XDG_CONFIG_DIRS
.RE
.RS 4
XDG_DATA_DIRS
.RE
.RS 4
SHELL
.RE
.RS 4
TEMP
.RE
.RS 4
TEMPDIR
.RE
.RS 4
TMP
.RE
.RS 4
TMPDIR
.RE
.RS 4
XDG_RUNTIME_DIR
.RE
.RS 4
container
.RE
.RS 4
TZDIR
.RE
.RS 4
PYTHONPATH
.RE
.RS 4
PYTHONPYCACHEPREFIX
.RE
.RS 4
PERLLIB
.RE
.RS 4
PERL5LIB
.RE
.RS 4
XCURSOR_PATH
.RE
.RS 4
GST_PLUGIN_PATH_1_0
.RE
.RS 4
GST_REGISTRY
.RE
.RS 4
GST_REGISTRY_1_0
.RE
.RS 4
GST_PLUGIN_PATH
.RE
.RS 4
GST_PLUGIN_SYSTEM_PATH
.RE
.RS 4
GST_PLUGIN_SCANNER
.RE
.RS 4
GST_PLUGIN_SCANNER_1_0
.RE
.RS 4
GST_PLUGIN_SYSTEM_PATH_1_0
.RE
.RS 4
GST_PRESET_PATH
.RE
.RS 4
GST_PTP_HELPER
.RE
.RS 4
GST_PTP_HELPER_1_0
.RE
.RS 4
GST_INSTALL_PLUGINS_HELPER
.RE
.RS 4
KRB5CCNAME
.RE
.RS 4
XKB_CONFIG_ROOT
.RE
.RS 4
GIO_EXTRA_MODULES
.RE
.RS 4
GDK_BACKEND
.RE
.RS 4
VK_ADD_DRIVER_FILES
.RE
.RS 4
VK_ADD_LAYER_PATH
.RE
.RS 4
VK_DRIVER_FILES
.RE
.RS 4
VK_ICD_FILENAMES
.RE
.RS 4
VK_LAYER_PATH
.RE
.RS 4
__EGL_EXTERNAL_PLATFORM_CONFIG_DIRS
.RE
.RS 4
__EGL_EXTERNAL_PLATFORM_CONFIG_FILENAMES
.RE
.RS 4
__EGL_VENDOR_LIBRARY_DIRS
.RE
.RS 4
__EGL_VENDOR_LIBRARY_FILENAMES
.RE
.PP
همچنین چندین متغیر محیطی با پیشوند "GST_" که توسط gstreamer استفاده می‌شوند حذف می‌گردند (از فلت‌پک نسخهٔ 1\&.12\&.5 به بعد)\&.
.PP
فلت‌پک همچنین متغیرهای محیطی XDG را بازنویسی می‌کند تا برنامه‌های ایزوله‌شده به مکان‌های فایل‌سیستم قابل نوشتن خود در زیر مسیر
~/\&.var/app/$APPID/:
اشاره کنند:
.RS 4
XDG_DATA_HOME
.RE
.RS 4
XDG_CONFIG_HOME
.RE
.RS 4
XDG_CACHE_HOME
.RE
.RS 4
XDG_STATE_HOME (since Flatpak 1\&.13)
.RE
.PP
برنامه‌ها می‌توانند از گزینه‌های
\fB\-\-persist=\&.local/state\fR
و
\fB\-\-unset\-env=XDG_STATE_HOME\fR
استفاده کنند تا در نسخه‌های قدیمی‌تر فلت‌پک به مسیر
~/\&.local/state
سازگار با فلت‌پک 1\&.13 دسترسی پیدا کنند\&.
.PP
مقادیر میزبان این متغیرها از طریق متغیرهایی با پیشوند HOST_\- در داخل محیط ایزوله در دسترس هستند:
.RS 4
HOST_XDG_DATA_HOME
.RE
.RS 4
HOST_XDG_CONFIG_HOME
.RE
.RS 4
HOST_XDG_CACHE_HOME
.RE
.RS 4
HOST_XDG_STATE_HOME (since Flatpak 1\&.13)
.RE
.PP
فلت‌پک متغیر محیطی
\fBFLATPAK_ID\fR
را برابر با شناسهٔ برنامهٔ در حال اجرا قرار می‌دهد\&.
.PP
فلت‌پک همچنین فایل
/etc/os\-release
میزبان (در صورت وجود، یا
/usr/lib/os\-release
به عنوان جایگزین) را مطابق با
\m[blue]\fBمشخصات os\-release\fR\m[]\&\s-2\u[1]\d\s+2
به صورت فقط‌خواندنی در مسیر
/run/host/os\-release
سوار (bind\-mount) می‌کند\&.
.PP
اگر پشتیبانی از کنترل‌های والدین فعال باشد، فلت‌پک تنظیمات کنترل والدین کاربر جاری را بررسی می‌کند و در صورتی که برنامه برای کاربر جاری در فهرست سیاه باشد، از اجرای آن خودداری خواهد کرد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-u\fR, \fB\-\-user\fR
.RS 4
جستجوی برنامه و محیط زمان اجرا در نصب‌های ویژهٔ کاربر (per\-user)\&.
.RE
.PP
\fB\-\-system\fR
.RS 4
جستجوی برنامه و محیط زمان اجرا در نصب‌های سراسری پیش‌فرض سیستم\&.
.RE
.PP
\fB\-\-installation=NAME\fR
.RS 4
جستجوی برنامه و محیط زمان اجرا در نصب سراسری مشخص‌شده با
NAME
از میان موارد تعریف‌شده در
/etc/flatpak/installations\&.d/\&.
استفاده از
\fB\-\-installation=default\fR
معادل استفاده از
\fB\-\-system\fR
است\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی در طول پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree در طول پردازش دستور\&.
.RE
.PP
\fB\-\-arch=ARCH\fR
.RS 4
معماری مورد نظر برای اجرا\&. برای دیدن معماری‌های پشتیبانی‌شده توسط سیستم میزبان به
\fBflatpak \-\-supported\-arches\fR
مراجعه کنید\&.
.RE
.PP
\fB\-\-command=COMMAND\fR
.RS 4
دستوری که باید به جای دستور فهرست‌شده در متادیتای برنامه اجرا شود\&.
.RE
.PP
\fB\-\-cwd=DIR\fR
.RS 4
دایرکتوری اجرای دستور\&. توجه داشته باشید که این مسیر باید پوشه‌ای در داخل محیط ایزوله باشد\&.
.RE
.PP
\fB\-\-branch=BRANCH\fR
.RS 4
شاخهٔ مورد استفاده\&.
.RE
.PP
\fB\-d\fR, \fB\-\-devel\fR
.RS 4
استفاده از محیط زمان اجرای توسعه (devel) که در متادیتای برنامه مشخص شده به جای ران‌تایم عادی، و استفاده از پروفایل seccomp که احتمال اختلال آن در ابزارهای توسعه کمتر است\&.
.RE
.PP
\fB\-\-runtime=RUNTIME\fR
.RS 4
استفاده از این محیط زمان اجرا به جای ران‌تایم مشخص‌شده در متادیتای برنامه\&. این یک چندتایی کامل است، مانند
org\&.freedesktop\&.Sdk/x86_64/1\&.2،
اما چندتایی‌های جزئی نیز مجاز هستند\&. هر بخش خالی یا جاافتاده با مقادیر متناظر مشخص‌شده توسط برنامه پر می‌شود\&.
.RE
.PP
\fB\-\-runtime\-version=VERSION\fR
.RS 4
استفاده از این نسخهٔ ران‌تایم به جای نسخهٔ مشخص‌شده در متادیتای برنامه\&. این گزینه بر هر نسخه‌ای که با گزینهٔ \-\-runtime مشخص شده باشد تقدم دارد\&.
.RE
.PP
\fB\-\-share=SUBSYSTEM\fR
.RS 4
اشتراک‌گذاری یک زیرسیستم با نشست میزبان\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
SUBSYSTEM
باید یکی از این موارد باشد: network، ipc\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-unshare=SUBSYSTEM\fR
.RS 4
عدم اشتراک‌گذاری یک زیرسیستم با نشست میزبان\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
SUBSYSTEM
باید یکی از این موارد باشد: network، ipc\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-share\-if=SUBSYSTEM:CONDITION\fR
.RS 4
اشتراک‌گذاری مشروط یک زیرسیستم با نشست میزبان، تنها زمانی که شرط مشخص‌شده در زمان اجرا برآورده شود\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
SUBSYSTEM
باید یکی از موارد network یا ipc باشد\&.
CONDITION
باید یکی از موارد زیر باشد:
\fBtrue\fR,
\fBfalse\fR,
\fBhas\-input\-device\fR,
\fBhas\-wayland\fR,
\fBhas\-usb\-device\fR,
\fBhas\-usb\-portal\fR\&.
شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-input\-device\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. موجود از نسخهٔ 1\&.17 به بعد\&.
.sp
برای جزئیات بیشتر بخش مجوزهای مشروط (Conditional Permissions) را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.RE
.PP
\fB\-\-socket=SOCKET\fR
.RS 4
ارائه و در دسترس قرار دادن سوکت شناخته‌شده به برنامه\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
SOCKET
باید یکی از موارد زیر باشد: x11, wayland, fallback\-x11, pulseaudio, system\-bus, session\-bus, ssh\-auth, pcsc, cups, gpg\-agent, inherit\-wayland\-socket\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-nosocket=SOCKET\fR
.RS 4
عدم ارائه سوکت شناخته‌شده به برنامه\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
SOCKET
باید یکی از موارد زیر باشد: x11, wayland, fallback\-x11, pulseaudio, system\-bus, session\-bus, ssh\-auth, pcsc, cups, gpg\-agent, inherit\-wayland\-socket\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-socket\-if=SOCKET:CONDITION\fR
.RS 4
ارائه مشروط یک سوکت شناخته‌شده به برنامه، تنها زمانی که شرط مشخص‌شده در زمان اجرا برآورده شود\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
SOCKET
باید یکی از موارد زیر باشد: x11, wayland, fallback\-x11, pulseaudio, system\-bus, session\-bus, ssh\-auth, pcsc, cups, gpg\-agent, inherit\-wayland\-socket\&.
CONDITION
باید یکی از موارد زیر باشد:
\fBtrue\fR,
\fBfalse\fR,
\fBhas\-input\-device\fR,
\fBhas\-wayland\fR,
\fBhas\-usb\-device\fR,
\fBhas\-usb\-portal\fR\&.
شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-wayland\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. موجود از نسخهٔ 1\&.17 به بعد\&.
.sp
برای جزئیات بیشتر بخش مجوزهای مشروط (Conditional Permissions) را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.RE
.PP
\fB\-\-device=DEVICE\fR
.RS 4
ارائه یک دستگاه به برنامه\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
DEVICE
باید یکی از این موارد باشد: dri, input, usb, kvm, shm, all\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-nodevice=DEVICE\fR
.RS 4
عدم ارائه یک دستگاه به برنامه\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
DEVICE
باید یکی از این موارد باشد: dri, input, usb, kvm, shm, all\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-device\-if=DEVICE:CONDITION\fR
.RS 4
ارائه مشروط یک دستگاه به برنامه، تنها زمانی که شرط مشخص‌شده در زمان اجرا برآورده شود\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
DEVICE
باید یکی از این موارد باشد: dri, input, usb, kvm, shm, all\&.
CONDITION
باید یکی از موارد زیر باشد:
\fBtrue\fR,
\fBfalse\fR,
\fBhas\-input\-device\fR,
\fBhas\-wayland\fR,
\fBhas\-usb\-device\fR,
\fBhas\-usb\-portal\fR\&.
شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-input\-device\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. موجود از نسخهٔ 1\&.17 به بعد\&.
.sp
برای جزئیات بیشتر بخش مجوزهای مشروط (Conditional Permissions) را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.RE
.PP
\fB\-\-allow=FEATURE\fR
.RS 4
اجازهٔ دسترسی به یک قابلیت مشخص\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
FEATURE
باید یکی از موارد devel، multiarch یا bluetooth باشد\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.sp
برای آشنایی با معانی قابلیت‌های مختلف،
\fBflatpak-build-finish\fR(1)
را ببینید\&.
.RE
.PP
\fB\-\-disallow=FEATURE\fR
.RS 4
عدم اجازهٔ دسترسی به یک قابلیت مشخص\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
FEATURE
باید یکی از موارد devel، multiarch یا bluetooth باشد\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-allow\-if=FEATURE:CONDITION\fR
.RS 4
اجازه دسترسی مشروط به یک قابلیت مشخص، تنها زمانی که شرط مشخص‌شده در زمان اجرا برقرار باشد\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
FEATURE
باید یکی از موارد devel، multiarch یا bluetooth باشد\&.
CONDITION
باید یکی از موارد زیر باشد:
\fBtrue\fR,
\fBfalse\fR,
\fBhas\-input\-device\fR,
\fBhas\-wayland\fR,
\fBhas\-usb\-device\fR,
\fBhas\-usb\-portal\fR\&.
شرط‌ها را می‌توان با
!
نقیض کرد، برای نمونه
\fB!has\-input\-device\fR\&.
این گزینه می‌تواند چندین بار استفاده شود\&. موجود از نسخهٔ 1\&.17 به بعد\&.
.sp
برای جزئیات بیشتر بخش مجوزهای مشروط (Conditional Permissions) را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.RE
.PP
\fB\-\-filesystem=FILESYSTEM\fR
.RS 4
اجازه دسترسی برنامه به زیرمجموعه‌ای از فایل‌سیستم\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&.
FILESYSTEM
می‌تواند یکی از موارد زیر باشد: home, host, host\-os, host\-etc, host\-root, xdg\-desktop, xdg\-documents, xdg\-download, xdg\-music, xdg\-pictures, xdg\-public\-share, xdg\-templates, xdg\-videos, xdg\-run, xdg\-config, xdg\-cache, xdg\-data، یک مسیر مطلق، یا یک مسیر نسبی به پوشهٔ خانگی مانند ~/dir یا مسیرهای نسبی به پوشه‌های xdg مانند xdg\-download/subdir\&. پسوند اختیاری :ro نشان می‌دهد که مسیر فقط‌خواندنی خواهد بود\&. پسوند اختیاری :create نشان می‌دهد که مسیر قابل خواندن/نوشتن بوده و در صورت عدم وجود ایجاد می‌شود\&. این گزینه می‌تواند چندین بار استفاده شود\&. برای جزئیات و معانی این فایل‌سیستم‌ها، فهرست "[Context] filesystems" را در
\fBflatpak-metadata\fR(5)
ببینید\&.
.RE
.PP
\fB\-\-nofilesystem=FILESYSTEM\fR
.RS 4
خنثی کردن اثر گزینهٔ قبلی
\fB\-\-filesystem=\fRFILESYSTEM
در مانیفست برنامه و/یا تغییرات سفارشی تنظیم‌شده با
\fBflatpak-override\fR(1)\&.
این گزینه بخش Context متادیتای برنامه را لغو و بازنویسی می‌کند\&.
FILESYSTEM
می‌تواند مقادیری مشابه با
\fB\-\-filesystem\fR
بپذیرد، اما پسوندهای
:ro
و
:create
در اینجا استفاده نمی‌شوند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.sp
این گزینه مانع از دسترسی به یک
\fB\-\-filesystem\fR
با دامنهٔ محدودتر و مشخص‌تر نمی‌شود\&. برای نمونه، اگر برنامه‌ای در مانیفست خود یا در تنظیمات بازنویسی سراسری سیستم معادل
\fB\-\-filesystem=xdg\-config/MyApp\fR
را داشته باشد، و در تنظیمات بازنویسی کاربری
flatpak override \-\-user \-\-nofilesystem=home
تعیین شده باشد، از دسترسی آن به بیشتر بخش‌های پوشهٔ خانه جلوگیری خواهد شد، اما همچنان اجازه دسترسی به
$XDG_CONFIG_HOME/MyApp
را خواهد داشت\&.
.sp
به عنوان یک مورد خاص،
\fB\-\-nofilesystem=host:reset\fR
علاوه بر داشتن رفتاری مشابه
\fB\-\-nofilesystem=host\fR،
تمام مجوزهای
\fB\-\-filesystem\fR
به‌ارث‌رسیده از مانیفست برنامه یا
\fBflatpak-override\fR(1)
را نادیده می‌گیرد\&.
.RE
.PP
\fB\-\-add\-policy=SUBSYSTEM\&.KEY=VALUE\fR
.RS 4
افزودن گزینهٔ خط‌مشی عمومی (generic policy)\&. برای نمونه، "\-\-add\-policy=subsystem\&.key=v1 \-\-add\-policy=subsystem\&.key=v2" به این متادیتا نگاشت می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
[Policy subsystem]
key=v1;v2;
.fi
.if n \{\
.RE
.\}
.sp
این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-remove\-policy=SUBSYSTEM\&.KEY=VALUE\fR
.RS 4
حذف گزینهٔ خط‌مشی عمومی\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-usb=TYPE[:DATA]\fR
.RS 4
افزودن پرسمان دستگاه USB به متادیتای برنامه\&. این کار اجازهٔ شمارش دستگاه‌ها و استفاده توسط پورتال USB را می‌دهد\&.
TYPE
باید یکی از موارد all، cls، dev یا vnd باشد\&.
.PP
\fBall\fR
.RS 4
تطابق با تمام دستگاه‌ها\&.
.RE
.PP
\fBcls\fR
.RS 4
پرسمان کلاس و زیرکلاس دستگاه\&.
DATA
باید در قالب
CLASS:SUBCLASS
باشد که در آن هر دو مقدار
CLASS
و
SUBCLASS
باید شماره شناسایی کلاس هگزادسیمال معتبر ۲ رقمی باشند\&. همچنین
SUBCLASS
می‌تواند
*
باشد تا با تمام زیرکلاس‌ها تطابق یابد\&.
.RE
.PP
\fBdev\fR
.RS 4
پرسمان شناسه محصول (product id) دستگاه\&.
DATA
باید یک عدد شناسه محصول هگزادسیمال معتبر ۴ رقمی باشد، برای نمونه
\fB0a1b\fR\&.
این گزینه نیازمند فیلتر
\fBvnd\fR
در پرسمان است\&.
.RE
.PP
\fBvnd\fR
.RS 4
پرسمان شناسه سازنده (vendor id) دستگاه\&.
DATA
باید یک شناسه سازنده هگزادسیمال معتبر ۴ رقمی بزرگتر از صفر باشد، برای نمونه
\fB0fab\fR\&.
.RE
.sp
ترکیب چندین پرسمان دستگاه با علامت
+
امکان‌پذیر است، برای نمونه
\fB\-\-usb=vnd:0123+dev:4567\fR\&.
فیلتر
dev
نیازمند
vnd
است\&. موجود از نسخهٔ 1\&.15\&.11 به بعد\&.
.RE
.PP
\fB\-\-nousb=VENDOR_ID:PRODUCT_ID\fR
.RS 4
افزودن پرسمان مسدودسازی دستگاه USB به متادیتای برنامه\&. دستگاه‌های مسدودشده بر دستگاه‌های مجاز اولویت دارند\&. ساختار دستوری دقیقاً مشابه با
\fB\-\-usb\fR
است\&. موجود از نسخهٔ 1\&.15\&.11 به بعد\&.
.RE
.PP
\fB\-\-env=VAR=VALUE\fR
.RS 4
تنظیم یک متغیر محیطی در برنامه\&. این گزینه بخش Context متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-unset\-env=VAR\fR
.RS 4
حذف یک متغیر محیطی در برنامه\&. این گزینه ورودی unset\-environment در گروه [Context] متادیتا و گروه [Environment] را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-env\-fd=\fR\fB\fIFD\fR\fR
.RS 4
خواندن متغیرهای محیطی از توصیف‌گر فایل
\fIFD\fR
و تنظیم آن‌ها همانند گزینهٔ
\fB\-\-env\fR\&.
از این گزینه می‌توان برای جلوگیری از مشاهده متغیرهای محیطی و مقادیر آن‌ها توسط سایر کاربران استفاده کرد\&.
.sp
هر متغیر محیطی در قالب
\fIVAR\fR=\fIVALUE\fR
است که با یک بایت صفر دنبال می‌شود\&. این قالب همان قالبی است که توسط
env \-0
و
/proc/*/environ
استفاده می‌شود\&.
.RE
.PP
\fB\-\-clear\-env\fR
.RS 4
عدم انتقال متغیرهای محیطی از محیط بیرون به برنامهٔ ایزوله‌شده (سندباکس)\&. متغیرهای محیطی که صریحاً تنظیم یا حذف شده‌اند همچنان اعمال خواهند شد\&.
.RE
.PP
\fB\-\-own\-name=NAME\fR
.RS 4
اجازه به برنامه برای در اختیار گرفتن (مالکیت) نام شناخته‌شدهٔ
NAME
در گذرگاه نشست (session bus)\&. اگر
NAME
با \&.* پایان یابد، به برنامه اجازه می‌دهد تمام نام‌های منطبق را در اختیار بگیرد\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-talk\-name=NAME\fR
.RS 4
اجازه به برنامه برای برقراری ارتباط با نام شناخته‌شدهٔ
NAME
در گذرگاه نشست (session bus)\&. اگر
NAME
با \&.* پایان یابد، به برنامه اجازه می‌دهد با تمام نام‌های منطبق ارتباط برقرار کند\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-no\-talk\-name=NAME\fR
.RS 4
عدم اجازه به برنامه برای برقراری ارتباط با نام شناخته‌شدهٔ
NAME
در گذرگاه نشست (session bus)\&. اگر
NAME
با \&.* پایان یابد، به برنامه اجازه می‌دهد با تمام نام‌های منطبق ارتباط برقرار کند\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-own\-name=NAME\fR
.RS 4
اجازه به برنامه برای در اختیار گرفتن (مالکیت) نام شناخته‌شدهٔ
NAME
در گذرگاه سیستم (system bus)\&. اگر
NAME
با \&.* پایان یابد، به برنامه اجازه می‌دهد تمام نام‌های منطبق را در اختیار بگیرد\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-talk\-name=NAME\fR
.RS 4
اجازه به برنامه برای برقراری ارتباط با نام شناخته‌شدهٔ
NAME
در گذرگاه سیستم (system bus)\&. اگر
NAME
با \&.* پایان یابد، به برنامه اجازه می‌دهد با تمام نام‌های منطبق ارتباط برقرار کند\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-no\-talk\-name=NAME\fR
.RS 4
عدم اجازه به برنامه برای برقراری ارتباط با نام شناخته‌شدهٔ
NAME
در گذرگاه سیستم (system bus)\&. اگر
NAME
با \&.* پایان یابد، به برنامه اجازه می‌دهد با تمام نام‌های منطبق ارتباط برقرار کند\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-a11y\-own\-name=NAME\fR
.RS 4
اجازه به برنامه برای در اختیار گرفتن (مالکیت) نام شناخته‌شدهٔ
NAME
در گذرگاه دسترسی‌پذیری (a11y bus)\&. اگر
NAME
با \&.* پایان یابد، به برنامه اجازه می‌دهد تمام نام‌های منطبق را در اختیار بگیرد\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-persist=FILENAME\fR
.RS 4
اگر برنامه به پوشهٔ خانگی واقعی دسترسی ندارد، مسیر (نسبی به پوشهٔ خانگی)
FILENAME
را به مسیر متناظر در پوشهٔ اختصاصی برنامه متصل (bind mount) می‌کند تا بتوان از آن مکان برای داده‌های پایدار استفاده کرد\&. این گزینه بخش Context در متادیتای برنامه را لغو و بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-no\-session\-bus\fR
.RS 4
اجرای این نمونه بدون دسترسی فیلترشده به اتصال dbus نشست\&. توجه داشته باشید که این حالت پیش‌فرض هنگام اجرا با \-\-sandbox است\&.
.RE
.PP
\fB\-\-session\-bus\fR
.RS 4
اجازهٔ دسترسی فیلترشده به اتصال dbus نشست\&. این حالت پیش‌فرض است، مگر زمانی که با \-\-sandbox اجرا شود\&.
.sp
در حالت ایزوله (سندباکس)، حتی اگر دسترسی به گذرگاه نشست را مجاز کنید، سندباکس نمی‌تواند با شناسه‌های برنامه (org\&.the\&.App\&.*) در گذرگاه ارتباط برقرار کرده یا مالک آن‌ها شود (مگر اینکه صراحتاً اضافه شوند)، بلکه فقط با نام‌های موجود در زیرمجموعهٔ \&.Sandboxed (مانند org\&.the\&.App\&.Sandboxed\&.* و org\&.mpris\&.MediaPlayer2\&.org\&.the\&.App\&.Sandboxed\&.*) مجاز است\&.
.RE
.PP
\fB\-\-no\-a11y\-bus\fR
.RS 4
اجرای این نمونه بدون دسترسی به گذرگاه دسترسی‌پذیری (accessibility bus)\&. توجه داشته باشید که این حالت پیش‌فرض هنگام اجرا با \-\-sandbox است\&.
.RE
.PP
\fB\-\-a11y\-bus\fR
.RS 4
اجازه دسترسی به گذرگاه دسترسی‌پذیری\&. این حالت پیش‌فرض است، مگر هنگامی که با \-\-sandbox اجرا شود\&.
.RE
.PP
\fB\-\-sandbox\fR
.RS 4
اجرای برنامه در حالت ایزوله (سندباکس)، که به معنی کنار گذاشتن تمام مجوزهای اضافی است که در غیر این صورت داشت، و همچنین قطع دسترسی به گذرگاه‌های نشست/سیستم/دسترسی‌پذیری و پورتال اسناد\&.
.RE
.PP
\fB\-\-log\-session\-bus\fR
.RS 4
ثبت لاگ ترافیک گذرگاه نشست\&. این گزینه برای مشاهدهٔ دسترسی‌های مورد نیاز در سیاست D\-Bus شما مفید است\&.
.RE
.PP
\fB\-\-log\-system\-bus\fR
.RS 4
ثبت لاگ ترافیک گذرگاه سیستم\&. این گزینه برای مشاهدهٔ دسترسی‌های مورد نیاز در سیاست D\-Bus شما مفید است\&.
.RE
.PP
\fB\-p\fR, \fB\-\-die\-with\-parent\fR
.RS 4
بستن و پایان دادن به کل محیط ایزوله هنگامی که فرآیند راه‌انداز خاتمه می‌یابد\&.
.RE
.PP
\fB\-\-parent\-pid=PID\fR
.RS 4
شناسهٔ فرایند (PID) فلت‌پک «والد» را مشخص می‌کند، که توسط گزینه‌های \-\-parent\-expose\-pids و \-\-parent\-share\-pids استفاده می‌شود\&.
.RE
.PP
\fB\-\-parent\-expose\-pids\fR
.RS 4
فرآیندهای محیط ایزوله جدید را در محیط ایزوله فلت‌پک والد (همان‌طور که با \-\-parent\-pid تعریف شده) قابل مشاهده می‌سازد\&.
.RE
.PP
\fB\-\-parent\-share\-pids\fR
.RS 4
استفاده از فضای نام یکسان برای شناسهٔ فرایندها بین فرآیندهای محیط ایزوله جدید و محیط ایزوله فلت‌پک والد، همان‌طور که با \-\-parent\-pid تعریف شده است\&. این گزینه مستلزم \-\-parent\-expose\-pids است\&.
.RE
.PP
\fB\-\-instance\-id\-fd\fR
.RS 4
نوشتن رشتهٔ شناسهٔ نمونه (instance ID) در توصیف‌گر فایل داده‌شده\&.
.RE
.PP
\fB\-\-file\-forwarding\fR
.RS 4
در صورت مشخص شدن این گزینه، سایر آرگومان‌ها بررسی می‌شوند و تمام آرگومان‌هایی که بین یک جفت آرگومان \*(Aq@@\*(Aq قرار گرفته‌اند به عنوان مسیر فایل تفسیر شده، در مخزن اسناد برون‌ریزی می‌شوند و در قالب مسیر سند حاصل به دستور ارسال می‌گردند\&. آرگومان‌های بین "@@u" و "@@" به عنوان URI در نظر گرفته شده و هر URI با طرح "file:" برون‌ریزی می‌شود\&. این موارد موقتی (غیرپایدار) بوده و دارای مجوز خواندن و نوشتن برای برنامه هستند\&.
.RE
.PP
\fB\-\-app\-path=\fR\fB\fIPATH\fR\fR
.RS 4
به جای سوار کردن محتوای برنامه در مسیر
/app
درون محیط ایزوله، مسیر
\fIPATH\fR
را در
/app
و محتوای اصلی برنامه را در
/run/parent/app
سوار می‌کند\&. اگر برنامه دارای افزونه باشد، آن‌ها نیز به
/run/parent/app
هدایت می‌شوند و در
\fBLD_LIBRARY_PATH\fR
درون محیط ایزوله گنجانده نخواهند شد\&.
.RE
.PP
\fB\-\-app\-path=\fR
.RS 4
به عنوان یک حالت خاص،
\fB\-\-app\-path=\fR
(با یک
\fIPATH\fR
خالی) منجر به سوار شدن یک دایرکتوری خالی در مسیر
/app
می‌شود\&.
.RE
.PP
\fB\-\-usr\-path=\fR\fB\fIPATH\fR\fR
.RS 4
به جای سوار کردن فایل‌های زمان اجرا در مسیر
/usr
درون محیط ایزوله، مسیر
\fIPATH\fR
را در
/usr
و فایل‌های عادی محیط زمان اجرا را در
/run/parent/usr
سوار می‌کند\&. اگر محیط زمان اجرا دارای افزونه باشد، آن‌ها نیز به
/run/parent/usr
هدایت می‌شوند و در
\fBLD_LIBRARY_PATH\fR
درون محیط ایزوله گنجانده نخواهند شد\&.
.sp
این گزینه معمولاً تنها زمانی مفید خواهد بود که با گزینه‌های
\fB\-\-app\-path=\fR
و
\fB\-\-env=LD_LIBRARY_PATH=\fR\fB\fI\&.\&.\&.\fR\fR
ترکیب شود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak run org\&.gnome\&.gedit\fR
.PP
\fB$ flatpak run \-\-devel \-\-command=bash org\&.gnome\&.Builder\fR
.PP
\fB$ flatpak run \-\-command=bash org\&.gnome\&.Sdk\fR
.PP
\fB$ flatpak run org\&.gnome\&.Boxes \-\-nousb=0fd9:*\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-override\fR(1),
\fBflatpak-enter\fR(1)
.SH "نکات (NOTES)"
.IP " 1." 4
مشخصات os-release
.RS 4
\%https://www.freedesktop.org/software/systemd/man/os-release.html
.RE