'\" t
.\"     Title: ostree summary
.\"    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 summary
.\"    Source: OSTree
.\"  Language: Persian
.\"
.TH "OSTREE SUMMARY" "1" "" "OSTree" "ostree summary"
.\" -----------------------------------------------------------------
.\" * 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-summary \- بازتولید یا مشاهده فایل فراداده خلاصه
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBostree\ summary\fR\ 'u
\fBostree summary\fR [\-\-gpg\-sign=KEY\-ID] [\-\-gpg\-homedir=HOMEDIR] [\-\-sign=KEYID] [\-\-sign\-type=ENGINE] {\-\-update} [\-\-add\-metadata=\fIKEY\fR=\fIVALUE\fR...]
.HP \w'\fBostree\ summary\fR\ 'u
\fBostree summary\fR {\-\-view | \-\-raw}
.SH "توضیحات (DESCRIPTION)"
.PP
فایل
summary
شکلی اختیاری و سطح‌بالاتر از فراداده مخزن است که شاخه‌های در دسترس را توصیف می‌کند\&. این فایل باید پس از یک سری کامیت به‌طور دستی بازتولید شود\&. از جمله مزایای دیگر آن، امکان به‌روزرسانی چند کامیت به‌صورت اتمیک (atomic) است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-update\fR,\fB\-u\fR
.RS 4
به‌روزرسانی فایل summary\&. این گزینه می‌تواند با
\fB\-\-add\-metadata\fR
ترکیب شود تا فیلدهای فراداده به خلاصه اضافه شوند\&.
.sp
اگر برای مخزن یک شناسه مجموعه (collection ID) پیکربندی شده باشد، شاخه
ostree\-metadata
برای آن شناسه مجموعه نیز با یک کامیت جدید حاوی فراداده داده‌شده به‌روزرسانی خواهد شد؛ که در صورت امضا بودن فایل summary، آن نیز امضا خواهد شد\&.
.RE
.PP
\fB\-\-add\-metadata\fR,\fB\-m\fR=KEY=VALUE
.RS 4
تعیین یک فیلد فراداده اضافی برای افزودن به summary\&. باید در قالب
\fB\fIKEY\fR\fR\fB=\fR\fB\fIVALUE\fR\fR
یا به صورت دو آرگومان مجزا باشد\&. کلیدها باید با استفاده از یک پیشوند نقطه، برای سازمان یا مخزن شما دارای فضای نام (namespace) باشند\&. مقادیر باید در قالب متنی GVariant باشند\&. برای مثال،
\fBexampleos\&.end\-of\-life "@t 1445385600"\fR\&. این گزینه را می‌توان چندین بار استفاده کرد\&.
.RE
.PP
\fB\-\-view\fR,\fB\-v\fR
.RS 4
مشاهده محتویات فایل summary در قالبی خوانا برای انسان\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
مشاهده بایت‌های خام فایل summary\&.
.RE
.PP
\fB\-\-gpg\-sign\fR=KEY\-ID
.RS 4
شناسه کلید GPG برای امضای summary با آن\&.
.sp
برای استفاده از یک زیرکلید خاص، اثرانگشت زیرکلید را به‌همراه یک
!
در انتهای آن وارد کنید\&.
.RE
.PP
\fB\-\-gpg\-homedir\fR=HOMEDIR
.RS 4
دایرکتوری خانگی GPG برای استفاده هنگام جستجوی دسته‌کلیدها (keyrings)\&.
.RE
.PP
\fB\-\-sign\-type\fR=ENGINE
.RS 4
استفاده از یک موتور امضای خاص\&. در حال حاضر انواع امضای
ed25519
و
dummy
در دسترس هستند\&. پیش‌فرض
ed25519
است\&.
.RE
.PP
\fB\-\-sign\fR="KEY\-ID"
.RS 4
در اینجا
KEY\-ID
عبارت است از:
.PP
\fBبرای ed25519:\fR
.RS 4
کلید مخفی کدگذاری‌شده با base64 برای امضای کامیت\&.
.RE
.PP
\fBبرای dummy:\fR
.RS 4
رشته ASCII که به عنوان کلید مخفی استفاده می‌شود\&.
.RE
.sp
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ ostree summary \-u\fR
.PP
\fB$ ostree summary \-u \-m key="\*(Aqvalue\*(Aq"\fR
.PP
\fB$ ostree summary \-v\fR
.sp
.if n \{\
.RS 4
.\}
.nf
* ostree/1/1/0
    Latest Commit (4\&.2 MB):
      9828ab80f357459b4ab50f0629beab2ae3b67318fc3d161d10a89fae353afa90
    Timestamp (ostree\&.commit\&.timestamp): 2017\-11\-21T01:41:10\-08
    Version (ostree\&.commit\&.version): 1\&.2\&.3

Last\-Modified (ostree\&.summary\&.last\-modified): 2018\-01\-12T22:06:38\-08
.fi
.if n \{\
.RE
.\}