'\" t
.\"     Title: ostree commit
.\"    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 commit
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE COMMIT" "1" "" "OSTree" "ostree commit"
.\" -----------------------------------------------------------------
.\" * 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-commit \- ثبت یک بازنگری جدید
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBostree\ commit\fR\ 'u
\fBostree commit\fR [OPTIONS...] \-\-branch= {BRANCH} [PATH]
.SH "توضیحات (DESCRIPTION)"
.PP
این دستور امکان ثبت تغییرات در یک شاخه را فراهم می‌کند\&. مشخص کردن شاخه الزامی است\&. در صورت موفقیت‌آمیز بودن ثبت، چکسام آن چاپ خواهد شد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-subject\fR, \fB\-s\fR="SUBJECT"
.RS 4
موضوع یک‌خطی\&. (اختیاری)
.RE
.PP
\fB\-\-body\fR, \fB\-m\fR="BODY"
.RS 4
توضیحات کامل\&. (اختیاری)
.RE
.PP
\fB\-\-body\-file\fR, \fB\-F\fR="FILE"
.RS 4
توضیحات کامل ثبت از یک فایل\&. (اختیاری)
.RE
.PP
\fB\-\-editor\fR, \fB\-e\fR
.RS 4
باز کردن یک ویرایشگر متن برای توضیحات ثبت\&. این گزینه به ترتیب اولویت نزولی از OSTREE_EDITOR، VISUAL، EDITOR یا vi استفاده می‌کند\&. در صورتی که پیام خالی رها شود، عملیات ثبت لغو خواهد شد\&.
.RE
.PP
\fB\-\-branch\fR, \fB\-b\fR="BRANCH"
.RS 4
شاخه\&. الزامی است، مگر اینکه \-\-orphan مشخص شده باشد\&.
.RE
.PP
\fB\-\-parent\fR="COMMIT"
.RS 4
چکسام والد یا "none" برای عدم استفاده صریح از والد\&. در صورت عدم تعیین،
BRANCH
به عنوان والد استفاده می‌شود (در صورتی که
BRANCH
وجود نداشته باشد، والدی نخواهد بود)\&.
.RE
.PP
\fB\-\-tree\fR="dir=PATH" or "tar=TARFILE" or "ref=COMMIT"
.RS 4
پوشش‌دهی آرگومان داده‌شده به عنوان یک درخت\&. هنگام ثبت یک آرشیو، TARFILE می‌تواند به صورت
\-
مشخص شود تا آرشیو از ورودی استاندارد خوانده شود\&.
.RE
.PP
\fB\-\-base\fR="REV"
.RS 4
شروع از محتوای یک ثبت\&. این گزینه با
\-\-tree=ref=REV
متفاوت است چرا که هیچ اصلاح‌کننده ثبتی اعمال نمی‌شود\&. این حالت معمولاً همان چیزی است که هنگام ایجاد یک ثبت مشتق‌شده مد نظر است\&. همچنین برای
\-\-selinux\-policy\-from\-base
استفاده می‌شود\&.
.RE
.PP
\fB\-\-add\-metadata\-string\fR="KEY=VALUE"
.RS 4
افزودن یک جفت کلید/مقدار به متادیتا\&. می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB\-\-add\-metadata\fR="KEY=VALUE"
.RS 4
افزودن یک جفت کلید/مقدار به متادیتا، که در آن KEY یک رشته و VALUE با قالب ()g_variant_parse است\&. می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB\-\-keep\-metadata\fR="KEY"
.RS 4
نگه‌داشتن KEY متادیتا و VALUE مرتبط با آن از والد\&. می‌تواند چندین بار مشخص شود\&.
.RE
.PP
\fB\-\-add\-detached\-metadata\-string\fR="KEY=VALUE"
.RS 4
افزودن یک جفت کلید/مقدار به متادیتای جداشده\&.
.RE
.PP
\fB\-\-owner\-uid\fR="UID"
.RS 4
تنظیم شناسه کاربری (UID) مالکیت فایل\&.
.RE
.PP
\fB\-\-owner\-gid\fR="GID"
.RS 4
تنظیم شناسه گروهی (GID) مالکیت فایل\&.
.RE
.PP
\fB\-\-no\-xattrs\fR
.RS 4
عدم درون‌ریزی ویژگی‌های گسترش‌یافته (xattrs)\&.
.RE
.PP
\fB\-\-selinux\-labeling\-epoch\fR0 | 1
.RS 4
هنگام فعال بودن برچسب‌گذاری SELinux، مبدا (epoch)
1
تضمین می‌کند که
/usr/etc
به گونه‌ای برچسب‌گذاری شود که گویی
/etc
است\&.
.RE
.PP
\fB\-\-bootable\fR
.RS 4
تزریق متادیتای استاندارد برای یک درخت سیستم‌فایل لینوکس با قابلیت راه‌اندازی (bootable)\&.
.RE
.PP
\fB\-\-link\-checkout\-speedup\fR
.RS 4
بهینه‌سازی برای ثبت درخت‌های متشکل از پیوندهای سخت (hardlinks) به درون مخزن\&.
.RE
.PP
\fB\-\-tar\-autocreate\-parents\fR
.RS 4
هنگام بارگذاری آرشیوهای tar، پوشه‌های والد در صورت نیاز به طور خودکار ایجاد شوند\&.
.RE
.PP
\fB\-\-skip\-if\-unchanged\fR
.RS 4
اگر محتوا نسبت به ثبت قبلی بدون تغییر است، هیچ کاری انجام نشود\&.
.RE
.PP
\fB\-\-consume\fR
.RS 4
هنگام ثبت از یک دایرکتوری محلی (یعنی نه یک آرشیو یا \-\-tree=ref)، مالکیت محتوا بر عهده گرفته می‌شود\&. این ممکن است صرفاً شامل حذف آن باشد، اما در صورت امکان، محتوا ممکن است به سادگی به جای ایجاد یک نسخه جدید، با ()rename به درون مخزن منتقل شود\&.
.RE
.PP
\fB\-\-statoverride\fR="PATH"
.RS 4
فایل شامل فهرستی از تغییرات برای اعمال بر مجوزها (حالت فایل به صورت ده‌دهی، به دنبال آن فاصله، و به دنبال آن مسیر فایل)\&. حالت مشخص‌شده با حالت اصلی فایل OR منطقی می‌شود، مگر اینکه با "=" شروع شده باشد\&.
.RE
.PP
\fB\-\-skip\-list\fR="PATH"
.RS 4
فایل حاوی فهرستی از مسیرهای فایل برای نادیده گرفتن (یک مسیر در هر خط)\&.
.RE
.PP
\fB\-\-table\-output\fR
.RS 4
خروجی دادن اطلاعات بیشتر در قالب KEY: VALUE\&.
.RE
.PP
\fB\-\-generate\-sizes\fR
.RS 4
تولید اطلاعات اندازه همراه با متادیتای ثبت\&.
.RE
.PP
\fB\-\-gpg\-sign\fR="KEY\-ID"
.RS 4
شناسه کلید GPG جهت امضای ثبت (در صورت ساخته شدن با GPGME \- GNU Privacy Guard Made Easy)\&.
.sp
برای استفاده از یک زیرکلید خاص، اثر انگشت زیرکلید را به دنبال
!
ارسال کنید\&.
.RE
.PP
\fB\-\-gpg\-homedir\fR="HOMEDIR"
.RS 4
دایرکتوری خانگی GPG جهت استفاده هنگام جستجوی دسته‌کلیدها (در صورت ساخته شدن با GPGME \- GNU Privacy Guard Made Easy)\&.
.RE
.PP
\fB\-\-timestamp\fR="TIMESTAMP"
.RS 4
بازنویسی برچسب زمانی ثبت با مقدار TIMESTAMP\&.
.RE
.PP
\fB\-\-orphan\fR
.RS 4
ایجاد یک ثبت بدون نوشتن روی یک ارجاع (شاخه)
.RE
.PP
\fB\-\-fsync\fR="POLICY"
.RS 4
مقدار POLICY یک متغیر بولی است که مشخص می‌کند آیا fsync باید استفاده شود یا خیر\&. پیش‌فرض true است\&.
.RE
.PP
\fB\-s, \-\-sign\-type\fR
.RS 4
استفاده از یک موتور امضای خاص\&. انواع امضای موجود در حال حاضر:
ed25519,
spki و
dummy
هستند\&. مقدار پیش‌فرض
ed25519
است\&.
.RE
.PP
\fB\-\-sign\-from\-file\fR="PATH"
.RS 4
این گزینه کلید (متناظر با مقدار مشخص‌شده برای
\-\-sign\-type
) را از مسیر داده‌شده می‌خواند\&. انکودینگ کلید به موتور امضا بستگی دارد\&. برای ed25519 کلید باید با base64 کدگذاری شده باشد، برای spki باید در قالب PEM باشد، و برای dummy باید یک رشته ASCII باشد\&.
.RE
.PP
\fB\-\-sign\fR="KEY\-ID"
.RS 4
در کدهای جدید از استفاده از این گزینه خودداری کنید، زیرا ارسال کلیدهای خصوصی از طریق آرگومان‌های خط فرمان مستعد افشا در لاگ‌ها و فهرست پردازش‌ها است\&.
.sp
مقدار
KEY\-ID
عبارت است از:
.PP
\fBبرای ed25519 و spki:\fR
.RS 4
کلید محرمانه کدگذاری‌شده با base64 برای امضای ثبت\&.
.RE
.PP
\fBبرای dummy:\fR
.RS 4
رشته ASCII به عنوان کلید محرمانه\&.
.RE
.sp
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ ostree commit \-\-branch=my\-branch \-\-subject="Initial commit"\fR
.sp
.if n \{\
.RS 4
.\}
.nf
        67e382b11d213a402a5313e61cbc69dfd5ab93cb07fbb8b71c2e84f79fa5d7dc
.fi
.if n \{\
.RE
.\}