نام (NAME)

git-show-index - نمایش محتویات فایل ایندکس بسته گیت

خلاصه دستور (SYNOPSIS)

git show-index [--object-format=<hash-algorithm>] < <pack-idx-file>

توضیحات (DESCRIPTION)

فایل .idx مربوط به یک فایل بسته گیت (ایجادشده با git-pack-objects(1) یا git-index-pack(1)) را از ورودی استاندارد می‌خواند و محتویات آن را نمایش می‌دهد. خروجی شامل یک شیء در هر خط است که هر خط دارای دو یا سه ستون جداشده با فاصله است:

•ستون اول، افست شیء بر حسب بایت در داخل فایل بسته متناظر است

•ستون دوم، شناسه شیء (object id) مربوط به شیء است

•اگر نسخه ایندکس ۲ یا بالاتر باشد، ستون سوم حاوی CRC32 داده‌های شیء است

اشیاء به ترتیبی که در فایل ایندکس یافت می‌شوند در خروجی قرار می‌گیرند، که (در یک فایل به‌درستی ایجادشده) باید بر اساس شناسه شیء مرتب شده باشند.

توجه داشته باشید که با فراخوانی git-verify-pack(1) می‌توانید اطلاعات بیشتری درباره یک فایل بسته کسب کنید. با این حال، از آنجا که این دستور تنها خود فایل ایندکس را بررسی می‌کند، هم سریع‌تر و هم منعطف‌تر است.

گزینه‌ها (OPTIONS)

--object-format=<hash-algorithm>

قالب شیء مشخص‌شده (الگوریتم هش) را برای فایل ایندکس تعیین می‌کند. مقادیر معتبر عبارتند از sha1 و (در صورت فعال بودن) sha256. مقدار پیش‌فرض، الگوریتم مخزن فعلی است (تنظیم‌شده توسط extensions.objectFormat)، یا sha1 اگر هیچ مقداری تنظیم نشده باشد یا خارج از یک مخزن باشد.

نکته: در حال حاضر هیچ‌گونه سازگاری متقابل میان مخازن SHA-256 و مخازن SHA-1 وجود ندارد.

از نظر تاریخی، ما هشدار می‌دادیم که مخازن SHA-256 ممکن است بعداً در زمان معرفی چنین ویژگی‌های تعامل‌پذیری به تغییرات ناسازگار با گذشته نیاز داشته باشند. امروزه، ما تنها انتظار تغییرات سازگار را داریم. علاوه بر این، در صورتی که چنین تغییراتی ضروری تشخیص داده شوند، می‌توان انتظار داشت که مخازن SHA-256 ایجادشده با گیت امروزی توسط نسخه‌های آینده گیت بدون از دست رفتن داده‌ها قابل استفاده باشند.

همچنین ببینید (SEE ALSO)

git-pack-objects(1), git-index-pack(1), git-verify-pack(1)

گیت (GIT)

بخشی از مجموعه git(1)