'\" t
.\"     Title: flatpak override
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/27/2026
.\"    Manual: flatpak override
.\"    Source: flatpak
.\"  Language: Persian
.\"
.TH "FLATPAK OVERRIDE" "1" "" "flatpak" "flatpak override"
.\" -----------------------------------------------------------------
.\" * 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-override \- بازنویسی و تغییر دسترسی‌های برنامه فلت‌پک
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBflatpak\ override\fR\ 'u
\fBflatpak override\fR [OPTION...] [APP]
.SH "توضیحات (DESCRIPTION)"
.PP
نیازمندی‌های زمان اجرای مشخص‌شده توسط برنامه را بازنویسی و تغییر می‌دهد\&. این قابلیت می‌تواند برای اعطای منابع کمتر یا بیشتر از آنچه برنامه درخواست کرده است به یک برنامهٔ سندباکس‌شده استفاده شود\&.
.PP
به‌طور پیش‌فرض، برنامه در هنگام شروع به منابعی که درخواست کرده است دسترسی پیدا می‌کند\&. اما کاربر می‌تواند این دسترسی‌ها را برای یک اجرای خاص با مشخص کردن آرگومان‌های اضافی برای
\fBflatpak run\fR،
یا برای همیشه با استفاده از
\fBflatpak override\fR
بازنویسی و لغو کند\&.
.PP
تنظیمات بازنویسی برنامه در حالت کاربری در فایل‌های متنی واقع در مسیر $XDG_DATA_HOME/flatpak/overrides ذخیره می‌شوند\&.
.PP
اگر شناسهٔ برنامه
APP
مشخص نشود، بازنویسی‌ها روی تمام برنامه‌ها اعمال می‌شوند، اما بازنویسی‌های مختص هر برنامه می‌توانند بازنویسی‌های سراسری را لغو کرده و اولویت داشته باشند\&.
.PP
مگر اینکه با گزینه‌های
\fB\-\-user\fR
یا
\fB\-\-installation\fR
بازنویسی شود، این دستور نصب پیش‌فرض سراسری سیستم (system\-wide) را تغییر می‌دهد\&.
.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
به‌روزرسانی نصب پیش‌فرض سراسری سیستم (system\-wide)\&.
.RE
.PP
\fB\-\-installation=NAME\fR
.RS 4
نصب سراسری سیستم مشخص‌شده با
NAME
را از میان موارد تعریف‌شده در
/etc/flatpak/installations\&.d/
به‌روزرسانی می‌کند\&. استفاده از
\fB\-\-installation=default\fR
معادل استفاده از
\fB\-\-system\fR
است\&.
.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
باید یکی از موارد زیر باشد: true, false, has\-input\-device, has\-wayland, has\-usb\-device, has\-usb\-portal\&.
شرط‌ها را می‌توان با
!
نقیض کرد، به عنوان مثال
\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
باید یکی از موارد زیر باشد: true, false, has\-input\-device, has\-wayland, has\-usb\-device, has\-usb\-portal\&.
شرط‌ها را می‌توان با
!
نقیض کرد، به عنوان مثال
\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, canbus, per\-app\-dev\-shm\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.sp
برای معنای ویژگی‌های مختلف به
\fBflatpak-build-finish\fR(1)
مراجعه کنید\&.
.RE
.PP
\fB\-\-disallow=FEATURE\fR
.RS 4
غیرمجاز کردن دسترسی به یک ویژگی مشخص\&. این گزینه گروه [Context] در فراداده‌ها را به‌روزرسانی می‌کند\&.
FEATURE
باید یکی از موارد زیر باشد: devel, multiarch, bluetooth, canbus, per\-app\-dev\-shm\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.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
قبلی در مانیفست برنامه یا در یک لایهٔ بازنویسی با اولویت پایین‌تر را خنثی می‌کند، و/یا یک
\fB\-\-filesystem=\fRFILESYSTEM
قبلی را از این لایهٔ بازنویسی‌ها حذف می‌نماید\&. این گزینه بخش 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
به‌ارث‌رسیده از مانیفست برنامه یا لایهٔ بازنویسی با اولویت کمتر را نادیده می‌گیرد\&.
.RE
.PP
\fB\-\-add\-policy=SUBSYSTEM\&.KEY=VALUE\fR
.RS 4
افزودن گزینهٔ خط‌مشی عمومی (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
حذف گزینهٔ خط‌مشی عمومی (policy)\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.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\-\-own\-name=NAME\fR
.RS 4
اجازه به برنامه برای در اختیار داشتن نام شناخته‌شدهٔ (well\-known name)
NAME
روی گذرگاه نشست (session bus)\&. این گزینه بخش Context فراداده‌های برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-talk\-name=NAME\fR
.RS 4
اجازه به برنامه برای ارتباط با نام شناخته‌شدهٔ (well\-known name)
NAME
روی گذرگاه نشست (session bus)\&. این گزینه بخش Context فراداده‌های برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-no\-talk\-name=NAME\fR
.RS 4
عدم اجازه به برنامه برای ارتباط با نام شناخته‌شدهٔ (well\-known name)
NAME
روی گذرگاه نشست (session bus)\&. این گزینه بخش Context فراداده‌های برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-own\-name=NAME\fR
.RS 4
اجازه به برنامه برای در اختیار داشتن نام شناخته‌شدهٔ (well\-known name)
NAME
روی گذرگاه سیستم (system bus)\&. اگر
NAME
با \&.* خاتمه یابد، به برنامه اجازه می‌دهد تا تمام نام‌های منطبق را در اختیار داشته باشد\&. این گزینه بخش Context فراداده‌های برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-talk\-name=NAME\fR
.RS 4
اجازه به برنامه برای ارتباط با نام شناخته‌شدهٔ (well\-known name)
NAME
روی گذرگاه سیستم (system bus)\&. اگر
NAME
با \&.* خاتمه یابد، به برنامه اجازه می‌دهد با تمام نام‌های منطبق ارتباط برقرار کند\&. این گزینه بخش Context فراداده‌های برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-system\-no\-talk\-name=NAME\fR
.RS 4
عدم اجازه به برنامه برای ارتباط با نام شناخته‌شدهٔ (well\-known name)
NAME
روی گذرگاه سیستم (system bus)\&. اگر
NAME
با \&.* خاتمه یابد، به برنامه اجازه ارتباط با هیچ‌کدام از نام‌های منطبق را نمی‌دهد\&. این گزینه بخش Context فراداده‌های برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-persist=FILENAME\fR
.RS 4
اگر برنامه به دایرکتوری خانگی واقعی دسترسی ندارد، مسیر (نسبت به دایرکتوری خانگی)
FILENAME
را به مسیر متناظر در دایرکتوری مختص برنامه متصل (bind mount) می‌کند و اجازه می‌دهد از آن مکان برای داده‌های پایدار استفاده شود\&. این گزینه بخش Context فراداده‌های برنامه را بازنویسی می‌کند\&. این گزینه می‌تواند چندین بار استفاده شود\&.
.RE
.PP
\fB\-\-reset\fR
.RS 4
حذف بازنویسی‌ها\&. اگر یک
APP
مشخص شده باشد، بازنویسی‌های مربوط به آن برنامه حذف می‌شوند؛ در غیر این صورت بازنویسی‌های سراسری حذف خواهند شد\&.
.RE
.PP
\fB\-\-show\fR
.RS 4
نمایش بازنویسی‌ها\&. اگر یک
APP
مشخص شده باشد، بازنویسی‌های مربوط به آن برنامه را نمایش می‌دهد؛ در غیر این صورت بازنویسی‌های سراسری را نمایش خواهد داد\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی حین پردازش دستور\&.
.RE
.PP
\fB\-\-ostree\-verbose\fR
.RS 4
چاپ اطلاعات اشکال‌زدایی OSTree حین پردازش دستور\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ flatpak override \-\-nosocket=wayland org\&.gnome\&.gedit\fR
.PP
\fB$ flatpak override \-\-filesystem=home org\&.mozilla\&.Firefox\fR
.PP
\fB$ flatpak override \-\-socket\-if=x11:!has\-wayland org\&.example\&.App\fR
.PP
اعطای دسترسی به سوکت X11 تنها در زمانی که برنامه در یک نشست ویلند (Wayland) اجرا نمی‌شود\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBflatpak\fR(1),
\fBflatpak-run\fR(1)