'\" t
.\"     Title: ostree refs
.\"    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 refs
.\"    Source: OSTree
.\"  Language: Persian
.\"
.TH "OSTREE REFS" "1" "" "OSTree" "ostree refs"
.\" -----------------------------------------------------------------
.\" * 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-refs \- فهرست کردن ارجاع‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBostree\ refs\fR\ 'u
\fBostree refs\fR [OPTIONS...] [PREFIX]
.HP \w'\fBostree\ refs\fR\ 'u
\fBostree refs\fR {EXISTING} {\-\-create=NEWREF}
.SH "توضیحات (DESCRIPTION)"
.PP
تمام ارجاع‌های موجود در میزبان را فهرست می‌کند\&. در صورت تعیین، PREFIX پیشوند refspec را مشخص می‌کند؛ پیشوند پیش‌فرض تهی (null) است که تمام ارجاع‌ها را فهرست می‌کند\&. این دستور همچنین می‌تواند برای ایجاد یا حذف ارجاع‌ها به کار رود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-list\fR
.RS 4
به دلایل تاریخی، دستور
refs
بدون این گزینه، پیشوند مشخص‌شده را از خروجی حذف می‌کند\&. معمولاً کاربر مایل است ارجاع کامل را ببیند، بنابراین تعیین این گزینه تضمین می‌کند که ارجاع‌ها به‌جای بریده شدن، به‌طور کامل چاپ شوند\&.
.RE
.PP
\fB\-\-create\fR=NEWREF
.RS 4
یک ارجاع ایجاد می‌کند که به کامیت EXISTING اشاره دارد\&. NEWREF نباید از قبل وجود داشته باشد و EXISTING باید یک کامیت موجود باشد\&. بیش از یک ارجاع می‌تواند به یک کامیت یکسان اشاره کند\&.
.RE
.PP
\fB\-\-delete\fR
.RS 4
به‌جای فهرست کردن ارجاع‌ها، مواردی را که با PREFIX مطابقت دارند حذف می‌کند\&. اگر قصد آزادسازی فضا را دارید، پس از آن باید دستور
\fBostree prune\fR
یا
\fBostree admin cleanup\fR
را اجرا کنید\&.
.RE
.PP
\fB\-\-revision\fR, \fB\-r\fR
.RS 4
هنگام فهرست کردن ارجاع‌ها، بازبینی‌های (revisions) آن‌ها را نیز چاپ می‌کند\&. بازبینی‌ها با نویسه تب (tab) جدا می‌شوند\&.
.RE
.PP
\fB\-\-alias\fR, \fB\-A\fR
.RS 4
در صورت استفاده همراه با
\fB\-\-create\fR،
یک نام مستعار ایجاد می‌کند\&. در غیر این صورت فقط نام‌های مستعار را فهرست می‌کند\&.
.RE
.PP
\fB\-\-collections\fR, \fB\-c\fR
.RS 4
تعامل با ارجاع‌ها را از طریق ترکیب شناسه‌های مجموعه (collection IDs) و نام‌های ارجاع آن‌ها فعال می‌کند\&. هنگام فهرست کردن ارجاع‌ها، این گزینه قالب خروجی را برای گنجاندن شناسه‌های مجموعه تغییر داده و امکان فهرست‌بندی ارجاع‌های آینه‌شده دوردست را فراهم می‌سازد\&.
.sp
هنگام ایجاد ارجاع‌ها، مقدار refspec ارائه‌شده به گزینه
\fB\-\-create\fR
به‌صورت
COLLECTION\-ID:REF\-NAME
در نظر گرفته شده و یک ارجاع آینه‌شده ایجاد می‌شود\&. (این استفاده‌ای نامتعارف از ساختار نحوی refspec است\&.)
.sp
هنگام حذف ارجاع‌ها، تمام ارجاع‌هایی که شناسه مجموعه آن‌ها برابر با PREFIX است حذف می‌شوند\&.
.RE
.PP
\fB\-\-force\fR
.RS 4
هنگام ایجاد
NEWREF
با گزینه
\fB\-\-create\fR،
اجازه می‌دهد یک ارجاع موجود به‌جای ایجاد خطا به‌روزرسانی شود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fB$ ostree refs\fR
.sp
.if n \{\
.RS 4
.\}
.nf
        my\-branch
        gnome\-ostree/buildmain/x86_64\-runtime
.fi
.if n \{\
.RE
.\}