'\" t
.\"     Title: flatpak spawn
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/27/2026
.\"    Manual: flatpak spawn
.\"    Source: flatpak
.\"  Language: English
.\"
.TH "FLATPAK SPAWN" "1" "" "flatpak" "flatpak spawn"
.\" -----------------------------------------------------------------
.\" * 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-spawn \- اجرای دستورها در یک محیط ایزوله (سندباکس)
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\-spawn\fR\ 'u
\fBflatpak\-spawn\fR [OPTION...] COMMAND [ARGUMENT...]
.SH "توضیحات (DESCRIPTION)"
.PP
برخلاف سایر دستورهای فلت‌پک،
\fBflatpak\-spawn\fR
برای برنامه‌های داخل محیط ایزوله (سندباکس) در دسترس است\&. این دستور،
COMMAND
را خارج از محیط ایزوله اجرا می‌کند: یا در یک محیط ایزوله دیگر، یا روی میزبان\&.
.PP
هنگامی که بدون
\fB\-\-host\fR
فراخوانی شود،
\fBflatpak\-spawn\fR
از پورتال فلت‌پک برای ایجاد یک کپی از محیط ایزوله‌ای که از آن فراخوانی شده است استفاده می‌کند، با امکان استفادهٔ اختیاری از مجوزهای محدودتر و به‌طور اختیاری آخرین نسخهٔ برنامه و محیط زمان اجرا (نگاه کنید به
\fB\-\-latest\-version\fR)\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش گزینه‌های راهنما و خروج\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی
.RE
.PP
\fB\-\-forward\-fd=FD\fR
.RS 4
ارسال رو به جلو (forward) توصیف‌گر فایل
.RE
.PP
\fB\-\-clear\-env\fR
.RS 4
اجرا در یک محیط تمیز و خالی
.RE
.PP
\fB\-\-watch\-bus\fR
.RS 4
خروج دستور اجراشده هنگامی که خود
\fBflatpak\-spawn\fR
خارج می‌شود؛ به‌ویژه زمانی رخ می‌دهد که اتصال آن به گذرگاه نشست (session bus) قطع شود\&.
.RE
.PP
\fB\-\-env=VAR=VALUE\fR
.RS 4
تنظیم یک متغیر محیطی
.RE
.PP
\fB\-\-latest\-version\fR
.RS 4
استفاده از آخرین نسخهٔ مرجع‌ها (refs) که برای برپایی محیط ایزوله استفاده می‌شوند
.RE
.PP
\fB\-\-no\-network\fR
.RS 4
اجرا بدون دسترسی به شبکه
.RE
.PP
\fB\-\-sandbox\fR
.RS 4
اجرا به‌صورت کاملاً ایزوله‌شده (sandboxed)\&. مستندات مربوط به گزینهٔ
\fB\-\-sandbox\fR
را در
\fBflatpak-run\fR(1)
ببینید\&.
.sp
برای دسترسی انتخابی به فایل‌ها گزینه‌های
\fB\-\-sandbox\-expose\fR
و
\fB\-\-sandbox\-expose\-ro\fR
را ببینید\&.
.RE
.PP
\fB\-\-sandbox\-expose=NAME\fR
.RS 4
ایجاد دسترسی خواندن و نوشتن به یک فایل در محیط ایزوله\&.
.sp
توجه داشته باشید که مسیرهای مطلق یا زیرپوشه‌ها مجاز نیستند\&. فایل‌ها باید در زیرپوشهٔ
sandbox
از پوشهٔ نمونه (یعنی
~/\&.var/app/$APP_ID/sandbox)
قرار داشته باشند\&.
.sp
این گزینه در ترکیب با
\fB\-\-sandbox\fR
مفید است (در غیر این صورت، پوشهٔ نمونه به هر حال قابل دسترسی است)\&.
.RE
.PP
\fB\-\-sandbox\-expose\-ro=NAME\fR
.RS 4
ایجاد دسترسی فقط‌خواندنی به یک فایل در محیط ایزوله\&.
.sp
توجه داشته باشید که مسیرهای مطلق یا زیرپوشه‌ها مجاز نیستند\&. فایل‌ها باید در زیرپوشهٔ
sandbox
از پوشهٔ نمونه (یعنی
~/\&.var/app/$APP_ID/sandbox)
قرار داشته باشند\&.
.sp
این گزینه در ترکیب با
\fB\-\-sandbox\fR
مفید است (در غیر این صورت، پوشهٔ نمونه به هر حال قابل دسترسی است)\&.
.RE
.PP
\fB\-\-host\fR
.RS 4
اجرای دستور خارج از محیط ایزوله روی میزبان\&. این کار نیازمند دسترسی به رابط D\-Bus با شناسهٔ org\&.freedesktop\&.Flatpak است\&.
.RE
.PP
\fB\-\-directory=DIR\fR
.RS 4
دایرکتوری کاری که دستور در آن اجرا می‌شود\&.
.sp
توجه داشته باشید که دایرکتوری داده‌شده باید در محیط ایزوله یا در صورت استفاده همراه با
\fB\-\-host\fR،
روی میزبان وجود داشته باشد\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak\-spawn ls /var/run\fR
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1)