'\" t
.\"     Title: git-show-index
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-SHOW\-INDEX" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * 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)"
git-show-index \- نمایش محتویات فایل ایندکس بسته گیت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit show\-index\fR [\-\-object\-format=<hash\-algorithm>] < <pack\-idx\-file>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
فایل \fB\&.idx\fR مربوط به یک فایل بسته گیت (ایجادشده با \fBgit-pack-objects\fR(1) یا \fBgit-index-pack\fR(1)) را از ورودی استاندارد می‌خواند و محتویات آن را نمایش می‌دهد\&. خروجی شامل یک شیء در هر خط است که هر خط دارای دو یا سه ستون جداشده با فاصله است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ستون اول، افست شیء بر حسب بایت در داخل فایل بسته متناظر است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ستون دوم، شناسه شیء (object id) مربوط به شیء است
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر نسخه ایندکس ۲ یا بالاتر باشد، ستون سوم حاوی CRC32 داده‌های شیء است
.RE
.sp
اشیاء به ترتیبی که در فایل ایندکس یافت می‌شوند در خروجی قرار می‌گیرند، که (در یک فایل به‌درستی ایجادشده) باید بر اساس شناسه شیء مرتب شده باشند\&.
.sp
توجه داشته باشید که با فراخوانی \fBgit-verify-pack\fR(1) می‌توانید اطلاعات بیشتری درباره یک فایل بسته کسب کنید\&. با این حال، از آنجا که این دستور تنها خود فایل ایندکس را بررسی می‌کند، هم سریع‌تر و هم منعطف‌تر است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-object\-format=<hash\-algorithm>
.RS 4
قالب شیء مشخص‌شده (الگوریتم هش) را برای فایل ایندکس تعیین می‌کند\&. مقادیر معتبر عبارتند از
\fIsha1\fR
و (در صورت فعال بودن)
\fIsha256\fR\&. مقدار پیش‌فرض، الگوریتم مخزن فعلی است (تنظیم‌شده توسط
\fBextensions\&.objectFormat\fR)، یا
\fIsha1\fR
اگر هیچ مقداری تنظیم نشده باشد یا خارج از یک مخزن باشد\&.
.sp
نکته: در حال حاضر هیچ‌گونه سازگاری متقابل میان مخازن SHA\-256 و مخازن SHA\-1 وجود ندارد\&.
.RE
.sp
از نظر تاریخی، ما هشدار می‌دادیم که مخازن SHA\-256 ممکن است بعداً در زمان معرفی چنین ویژگی‌های تعامل‌پذیری به تغییرات ناسازگار با گذشته نیاز داشته باشند\&. امروزه، ما تنها انتظار تغییرات سازگار را داریم\&. علاوه بر این، در صورتی که چنین تغییراتی ضروری تشخیص داده شوند، می‌توان انتظار داشت که مخازن SHA\-256 ایجادشده با گیت امروزی توسط نسخه‌های آینده گیت بدون از دست رفتن داده‌ها قابل استفاده باشند\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-pack-objects\fR(1), \fBgit-index-pack\fR(1), \fBgit-verify-pack\fR(1)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)