'\" t
.\"     Title: ostree
.\"    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
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE" "1" "" "OSTree" "ostree"
.\" -----------------------------------------------------------------
.\" * 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 \- مدیریت چندین درخت سیستم‌فایل نسخه‌دار و قابل راه‌اندازی
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBostree\fR\ 'u
\fBostree\fR {COMMAND} [OPTIONS...]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار OSTree سامانه‌ای برای مدیریت چندین درخت سیستم‌فایل نسخه‌دار و قابل راه‌اندازی (بوت) است، که به اختصار «درخت» (tree) نیز نامیده می‌شود\&. در مدل OSTree، سیستم‌های عامل دیگر در دایرکتوری ریشه فیزیکی "/" قرار نمی‌گیرند\&. در عوض، آن‌ها به صورت موازی در دایرکتوری سطح‌بالای جدید
/ostree
نصب می‌شوند\&. هر سیستم نصب‌شده دایرکتوری
/ostree/deploy/\fIstateroot\fR
مخصوص به خود را دریافت می‌کند\&. (stateroot
اصطلاح جدیدتر برای
osname
است)\&.
.PP
برخلاف
rpm
یا
dpkg، ابزار OSTree تنها از کل درخت‌های سیستم‌فایل آگاه است\&. این ابزار هیچ دانش درونی از اینکه چه مؤلفه‌هایی در ایجاد درخت سیستم‌فایل به کار رفته‌اند ندارد\&.
.PP
امکان استفاده از OSTree در چندین حالت وجود دارد؛ پایه‌ای‌ترین شکل، همتاسازی درخت‌های از پیش ساخته‌شده از یک سرور ساخت است\&. معمولاً این درخت‌های از پیش ساخته‌شده از بسته‌ها مشتق می‌شوند\&. همچنین ممکن است از OSTree در زیر لایه یک ابزار سطح‌بالاتر استفاده کنید که درخت‌های سیستم‌فایل را به صورت محلی محاسبه می‌کند\&.
.PP
باید تأکید شود که OSTree تنها از درخت‌های
\fIفقط‌خواندنی\fR
پشتیبانی می‌کند\&. برای تغییر به یک درخت دیگر (ارتقا، تنزل نسخه، نصب نرم‌افزار)، یک درخت جدید واکشی (checked out) می‌شود و یک ادغام ۳\-طرفه در پیکربندی انجام می‌گیرد\&. درخت در حال اجرای فعلی هرگز تغییر داده نمی‌شود؛ درخت جدید پس از راه‌اندازی مجدد سیستم فعال خواهد شد\&.
.PP
برای مشاهده صفحه راهنمای یک دستور اجرا کنید:
\fBman ostree \fR\fB\fICOMMAND\fR\fR
یا
\fBman ostree\-admin \fR\fB\fICOMMAND\fR\fR
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-repo\fR
.RS 4
برای بیشتر دستورات، تعیین یک مخزن الزامی است\&. در صورت عدم تعیین، چنانچه دایرکتوری جاری یک مخزن OSTree باشد، از آن استفاده می‌شود\&. اگر چنین نباشد، یا از متغیر محیطی
\fBOSTREE_REPO\fR
استفاده می‌شود، یا از مخزن سیستمی واقع در
/sysroot/ostree/repo\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
تولید خروجی در سطح اشکال‌زدایی (debug)\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
چاپ اطلاعات نسخه، از جمله قابلیت‌های فعال‌شده در زمان کامپایل، و خروج\&.
.RE
.SH "دستورات (COMMANDS)"
.PP
مدیران سیستم عمدتاً از طریق زیردستور
\fBostree admin\fR
با OSTree تعامل دارند\&.
.PP
\fBostree-admin-cleanup\fR(1)
.RS 4
حذف استقرارهای بدون برچسب و اشیاء مخزن\&.
.RE
.PP
\fBostree-admin-config-diff\fR(1)
.RS 4
مشاهده تغییرات
/etc
در مقایسه با پیش‌فرض فعلی (از
/usr/etc)\&.
.RE
.PP
\fBostree-admin-deploy\fR(1)
.RS 4
یک کامیت یا بازنگری (revision) خاص را می‌گیرد و آن را برای راه‌اندازی (بوت) بعدی آماده می‌کند\&.
.RE
.PP
\fBostree-admin-init-fs\fR(1)
.RS 4
راه‌اندازی اولیه یک سیستم‌فایل ریشه در مسیر مشخص‌شده\&.
.RE
.PP
\fBostree-admin-instutil\fR(1)
.RS 4
توابع کاربردی که عمدتاً برای برنامه‌های نصب سیستم‌عامل در نظر گرفته شده‌اند\&.
.RE
.PP
\fBostree-admin-os-init\fR(1)
.RS 4
راه‌اندازی اولیه مکان استقرار برای یک سیستم‌عامل با نام مشخص\&.
.RE
.PP
\fBostree-admin-status\fR(1)
.RS 4
نمایش و فهرست کردن استقرارها\&.
.RE
.PP
\fBostree-admin-switch\fR(1)
.RS 4
انتخاب یک ارجاع (ref) متفاوت برای ردیابی از همان ریموتِ درخت فعلی\&.
.RE
.PP
\fBostree-admin-undeploy\fR(1)
.RS 4
حذف درخت قبلیِ مستقرشده در
\fIINDEX\fR
از پیکربندی بوت‌لودر\&.
.RE
.PP
\fBostree-admin-upgrade\fR(1)
.RS 4
بارگیری آخرین نسخه برای ارجاع فعلی، و استقرار آن\&.
.RE
.PP
هم مدیران و هم سازندگان سیستم‌عامل می‌توانند از طریق دستورات معمولی دستکاری سیستم‌فایل با OSTree تعامل داشته باشند\&.
.PP
\fBostree-cat\fR(1)
.RS 4
پیوستن و نمایش محتوای فایل‌ها\&.
.RE
.PP
\fBostree-checkout\fR(1)
.RS 4
واکشی یک کامیت در یک درخت سیستم‌فایل\&.
.RE
.PP
\fBostree-checksum\fR(1)
.RS 4
ارائه چک‌سام هر فایل\&.
.RE
.PP
\fBostree-commit\fR(1)
.RS 4
ایجاد یک کامیت جدید با استفاده از محتوای یک یا چند درخت مشخص‌شده\&.
.RE
.PP
\fBostree-config\fR(1)
.RS 4
تغییر تنظیمات\&.
.RE
.PP
\fBostree-create-usb\fR(1)
.RS 4
قرار دادن ارجاع‌های مشخص‌شده روی یک درایو خارجی برای توزیع همتابه‌همتا (P2P)\&.
.RE
.PP
\fBostree-diff\fR(1)
.RS 4
فهرست کردن مختصر تفاوت‌های میان ارجاع‌های ارائه‌شده\&.
.RE
.PP
\fBostree-find-remotes\fR(1)
.RS 4
یافتن ریموت‌ها برای ارائه ارجاع‌های مشخص‌شده\&.
.RE
.PP
\fBostree-fsck\fR(1)
.RS 4
بررسی یکپارچگی و سازگاری یک مخزن\&.
.RE
.PP
\fBostree-init\fR(1)
.RS 4
راه‌اندازی اولیه یک مخزن جدید\&.
.RE
.PP
\fBostree-log\fR(1)
.RS 4
نمایش گزارش بازنگری‌ها (revision log)\&.
.RE
.PP
\fBostree-ls\fR(1)
.RS 4
فهرست کردن محتویات یک کامیت مشخص\&.
.RE
.PP
\fBostree-prune\fR(1)
.RS 4
جستجو برای اشیاء غیرقابل‌دسترس و پاکسازی آن‌ها\&.
.RE
.PP
\fBostree-pull-local\fR(1)
.RS 4
کپی داده‌ها از یک مخزن مبدأ (source\-repo)\&.
.RE
.PP
\fBostree-pull\fR(1)
.RS 4
بارگیری داده‌ها از مخزن راه دور (remote repo)، در صورت نصب بودن libsoup\&.
.RE
.PP
\fBostree-refs\fR(1)
.RS 4
فهرست کردن ارجاع‌ها (refs)\&.
.RE
.PP
\fBostree-remote\fR(1)
.RS 4
دستکاری پیکربندی آرشیو راه دور\&.
.RE
.PP
\fBostree-reset\fR(1)
.RS 4
بازنشانی یک ارجاع به یک کامیت قبلی\&.
.RE
.PP
\fBostree-rev-parse\fR(1)
.RS 4
نمایش SHA256 متناظر با یک بازنگری مشخص\&.
.RE
.PP
\fBostree-show\fR(1)
.RS 4
نمایش محتویات یک چک‌سام SHA256 ارائه‌شده از OSTree\&.
.RE
.PP
\fBostree-static-delta\fR(1)
.RS 4
مدیریت فایل‌های دلتای ایستا\&.
.RE
.PP
\fBostree-summary\fR(1)
.RS 4
تولید مجدد متادیتای خلاصه مخزن\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
برای مثال‌های دقیق، لطفاً صفحه راهنمای مربوط به دستور خاص ostree را ببینید\&. به عنوان مثال:
.PP
\fBman ostree init\fR
یا
\fBman ostree\-admin status\fR
.SH "اعتبارسنجی GPG (GPG VERIFICATION)"
.PP
ابزار OSTree از امضای کامیت‌ها با GPG پشتیبانی می‌کند\&. عملیات روی مخزن سیستم به‌طور پیش‌فرض از فایل‌های دسته‌کلید (keyring) در
/usr/share/ostree/trusted\&.gpg\&.d
استفاده می‌کند\&. هر کلید عمومی در یک فایل دسته‌کلید در آن دایرکتوری توسط کلاینت مورد اعتماد خواهد بود\&. هیچ کلید خصوصی نباید در این دایرکتوری قرار داشته باشد\&.
.PP
علاوه بر مخزن سیستم، OSTree از دو مسیر دیگر نیز پشتیبانی می‌کند\&. نخست، گزینه
gpgkeypath
برای ریموت‌ها وجود دارد که باید به نام فایل یک کلید GPG با پوشش اسکی (ASCII\-armored)، یا دایرکتوری حاوی کلیدهای GPG با پوشش اسکی برای وارد کردن (import) اشاره کند\&. می‌توان چندین مسیر فایل و دایرکتوری را به صورت فهرستی از مسیرها که با کاما از هم جدا شده‌اند، تعیین کرد\&. این گزینه را می‌توان با استفاده از
\fB\-\-set\fR
در
\fBostree remote add\fR
مشخص کرد\&.
.PP
دوم، پشتیبانی از یک فایل
\fIremotename\fR\&.trustedkeys\&.gpg
به ازای هر ریموت وجود دارد که در بالاترین سطح مخزن (در کنار
objects/
و موارد دیگر) ذخیره می‌شود\&. این مورد به‌ویژه هنگام بارگیری محتوایی که ممکن است کاملاً مورد اعتماد نباشد (مثلاً می‌خواهید آن را بازرسی کنید اما به عنوان سیستم‌عامل مستقر نکنید) یا برای استفاده در کانتینرها مفید است\&. این فایل از طریق
\fBostree remote add \-\-gpg\-import\fR
نوشته می‌شود\&.
.SH "اصطلاحات (TERMINOLOGY)"
.PP
اصطلاحات زیر معمولاً در سراسر صفحات راهنما استفاده می‌شوند\&. اصطلاحات با حروف بزرگ مقادیر مستقیمی هستند که در آرگومان‌های خط فرمان به کار می‌روند\&.
.PP
BRANCH
.RS 4
نام شاخه\&. بخشی از یک
REF\&.
.RE
.PP
CHECKSUM
.RS 4
هش SHA256 از یک شیء ذخیره‌شده در مخزن OSTree\&. این می‌تواند یک شیء محتوا (content)، یک درخت دایرکتوری (dirtree)، متادیتای دایرکتوری (dirmeta) یا یک شیء کامیت باشد\&. اگر منظور هش SHA256 از یک شیء کامیت باشد، اصطلاح
COMMIT
به کار می‌رود\&.
.RE
.PP
COMMIT
.RS 4
هش SHA256 از یک شیء کامیت\&.
.RE
.PP
REF
.RS 4
ارجاع به یک کامیت خاص\&. ارجاع‌ها فایل‌های متنی ذخیره‌شده در
refs/
هستند که به یک کامیت مشخص نام‌گذاری می‌کنند (ارجاع می‌دهند)\&. ارجاع می‌تواند تنها بخش نام شاخه باشد که در این حالت از یک ارجاع محلی استفاده می‌شود (مثلاً
mybranch/stable)\&.
اگر به یک شاخه دوردست ارجاع داده شود، باید نام ریموت به همراه دو‌نقطه و سپس نام شاخه استفاده شود (مثلاً
myremote:mybranch/stable)\&.
.RE
.PP
REV, REFSPEC
.RS 4
یک بازنگری خاص، یک کامیت\&. این می‌تواند هر چیزی باشد که به یک کامیت حل (resolve) شود، مثلاً یک
REF
یا یک
COMMIT\&.
.RE
.PP
SHA256
.RS 4
یک تابع هش رمزنگاری که برای ذخیره اشیاء در مخزن OSTree به کار می‌رود\&. این هش‌ها ۲۵۶ بیت طول دارند و معمولاً با نمایش هگزادسیمال ۶۴ نویسه‌ای اسکی به ostree ارسال و توسط آن نمایش داده می‌شوند (مثلاً 0fc70ed33cfd7d26fe99ae29afb7682ddd0e2157a4898bd8cfcdc8a03565b870)\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBostree.repo\fR(5)