$manlookup

git-multi-pack-index

(1)

Write and verify multi-pack-indexes

User commands5 optionsgit-man 1:2.47.3-0+deb13u1
git multi-pack-index [--object-dir=<dir>] [--[no-]bitmap] <sub-command>

Options

5
--object-dir

Use given directory for the location of Git objects. We check <dir>/packs/multi-pack-index for the current MIDX file, and <dir>/packs for the pack-files to index. <dir> must be an alternate of the current repository.

--preferred-pack

Optionally specify the tie-breaking pack used when multiple packs contain the same object. <pack> must contain at least one object. If not given, ties are broken in favor of the pack with the lowest mtime.

--stdin-packs

Write a multi-pack index containing only the set of line-delimited pack index basenames provided over stdin.

--refs-snapshot

With --bitmap, optionally specify a file which contains a "refs snapshot" taken prior to repacking. A reference snapshot is composed of line-delimited OIDs corresponding to the reference tips, usually taken by git repack prior to generating a new pack. A line may optionally start with a + character to indicate that the reference which corresponds to that OID is "preferred" (see git-config(1)'s pack.preferBitmapTips.) The file given at <path> is expected to be readable, and can contain duplicates. (If a given OID is given more than once, it is marked as preferred if at least one instance of it

--incremental

Write an incremental MIDX file containing only objects and packs not present in an existing MIDX layer. Migrates non-incremental MIDXs to incremental ones when necessary. Incompatible with --bitmap.

DESCRIPTION

Write or verify a multi-pack-index (MIDX) file.

EXAMPLES

•Write a MIDX file for the packfiles in the current .git directory.

$ git multi-pack-index write

•Write a MIDX file for the packfiles in the current .git directory with a corresponding bitmap.

$ git multi-pack-index write --preferred-pack=<pack> --bitmap

•Write a MIDX file for the packfiles in an alternate object store.

$ git multi-pack-index --object-dir <alt> write

•Verify the MIDX file for the packfiles in the current .git directory.

$ git multi-pack-index verify

GIT

Part of the git(1) suite

NOTES

1.
The Multi-Pack-Index Design Document
file:///usr/share/doc/git/html/technical/multi-pack-index.html

See also