git-show-index - Man Page

Show packed archive index

Examples (TL;DR)

Synopsis

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

Description

Read the ​.idx file for a Git packfile (created with git-pack-objects(1) or git-index-pack(1)) from the standard input, and dump its contents​. The output consists of one object per line, with each line containing two or three space-separated columns:

The objects are output in the order in which they are found in the index file, which should be (in a correctly constructed file) sorted by object id​.

Note that you can get more information on a packfile by calling git-verify-pack(1)​. However, as this command considers only the index file itself, it’s both faster and more flexible​.

Options

--object-format=<hash-algorithm>

Specify the given object format (hash algorithm) for the index file​. The valid values are sha1 and (if enabled) sha256​. The default is the algorithm for the current repository (set by extensions​.objectFormat), or sha1 if no value is set or outside a repository​.​.

Note: At present, there is no interoperability between SHA-256 repositories and SHA-1 repositories​.

Historically, we warned that SHA-256 repositories may later need backward incompatible changes when we introduce such interoperability features​. Today, we only expect compatible changes​. Furthermore, if such changes prove to be necessary, it can be expected that SHA-256 repositories created with today’s Git will be usable by future versions of Git without data loss​.

Git

Part of the git(1) suite

Info

09/28/2026 Git 2.56.0 Git Manual