'\" t
.\"     Title: ostree-state-overlay
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/20/2026
.\"    Manual: ostree-state-overlay
.\"    Source: ostree
.\"  Language: English
.\"
.TH "OSTREE\-STATE\-OVERL" "8" "" "ostree" "ostree-state-overlay"
.\" -----------------------------------------------------------------
.\" * 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)"
ostree-state-overlay@.service \- راه‌اندازی لایه‌های روکش وضعیت (state overlays)
.SH "خلاصه دستور (SYNOPSIS)"
.PP
ostree\-state\-overlay@\&.service
.SH "مدیریت /OPT (DEALING WITH /OPT)"
.PP
\fBنکته:\fR
به‌طور کلی، اولویت در مدیریت نرم‌افزارهای
/opt
استفاده از پیوندهای نمادین برای تنها بخش‌هایی است که نیاز به تغییرپذیری دارند به مکانی در
/var
که می‌تواند مثلاً توسط یک فایل
tmpfiles\&.d
ایجاد شود. برای اطلاعات بیشتر، ببینید:
\m[blue]\fB\%https://bootc-dev.github.io/bootc/building/guidance.html#handling-read-only-vs-writable-locations\fR\m[]\&.
.SH "توضیحات (DESCRIPTION)"
.PP
در برخی موارد، مفید است که بتوان یک دایرکتوری را به عنوان بخشی از کامیت OSTree داشت و در عین حال این دایرکتوری در سمت کلاینت قابل نوشتن باشد. یک نمونه، نرم‌افزاری است که در
/opt
ارائه می‌شود.
/opt
سلسله‌مراتب فایل جایگزین و دارای فضای نام اختصاصی ارائه‌دهنده نرم‌افزار است که ممکن است شامل کد و وضعیت باشد. با لایه‌های روکش وضعیت (state overlays)، می‌توان بخش کد را در OSTree تثبیت کرد، در حالی که همچنان به دایرکتوری اجازه داده می‌شود قابل نوشتن باشد تا وضعیت در آنجا نگهداری شود.
.PP
از آنجا که این دایرکتوری قابل نوشتن است، هیچ چیز مانع از آن نمی‌شود که کد دارای مجوز کافی، محتوای حاصل از کامیت OSTree را تغییر دهد یا حذف کند. این در تضاد آشکار با محتوای
/usr
است و بیشتر با توزیع‌های مبتنی بر مدیر بسته مطابقت دارد.
.PP
نکته حیاتی این است که این وضعیت در طول ارتقاها (یا به‌طور کلی‌تر، هر زمان که کامیت OSTree متفاوتی بوت شود) به‌طور خودکار بازپایه‌ریزی (rebase) می‌شود. معناشناسی بازپایه‌ریزی به این صورت است: هر فایل یا دایرکتوری وضعیتی که محتوای OSTree را تغییر داده باشد حذف می‌شود، در غیر این صورت نگه داشته شده و روی محتوای پایه جدید (با استفاده از overlayfs) ادغام می‌شود. این رفتار عمدتاً با رفتار یک مدیر بسته مطابقت دارد.
.PP
برای فعال‌سازی این قابلیت، کافی است الگوی واحد را نمونه‌سازی کنید و از مسیر هدف (با نشانه‌گذاری مسیر اسکیپ‌شده در systemd) به عنوان نام نمونه استفاده نمایید. برای نمونه، جهت فعال‌سازی آن روی
/opt:
.sp
.if n \{\
.RS 4
.\}
.nf
    $ systemctl enable \-\-now ostree\-state\-overlay@opt\&.service
    
.fi
.if n \{\
.RE
.\}