Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GIT-MULTI-PACK-IN(1)		  Git Manual		  GIT-MULTI-PACK-IN(1)

NAME
       git-multi-pack-index - Write and	verify multi-pack-indexes

SYNOPSIS
       git multi-pack-index [--object-dir=<dir>] [--[no-]progress]
	       [--preferred-pack=<pack>] <subcommand>

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

OPTIONS
       --object-dir=<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.

       --[no-]progress
	   Turn	progress on/off	explicitly. If neither is specified, progress
	   is shown if standard	error is connected to a	terminal.

       The following subcommands are available:

       write
	   Write a new MIDX file. The following	options	are available for the
	   write sub-command:

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

       verify
	   Verify the contents of the MIDX file.

       expire
	   Delete the pack-files that are tracked by the MIDX file, but	have
	   no objects referenced by the	MIDX. Rewrite the MIDX file afterward
	   to remove all references to these pack-files.

       repack
	   Create a new	pack-file containing objects in	small pack-files
	   referenced by the multi-pack-index. If the size given by the
	   --batch-size=<size> argument	is zero, then create a pack containing
	   all objects referenced by the multi-pack-index. For a non-zero
	   batch size, Select the pack-files by	examining packs	from
	   oldest-to-newest, computing the "expected size" by counting the
	   number of objects in	the pack referenced by the multi-pack-index,
	   then	divide by the total number of objects in the pack and multiply
	   by the pack size. We	select packs with expected size	below the
	   batch size until the	set of packs have total	expected size at least
	   the batch size, or all pack-files are considered. If	only one
	   pack-file is	selected, then do nothing. If a	new pack-file is
	   created, rewrite the	multi-pack-index to reference the new
	   pack-file. A	later run of git multi-pack-index expire will delete
	   the pack-files that were part of this batch.

	   If repack.packKeptObjects is	false, then any	pack-files with	an
	   associated .keep file will not be selected for the batch to repack.

EXAMPLES
       o   Write a MIDX	file for the packfiles in the current .git folder.

	       $ git multi-pack-index write

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

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

       o   Verify the MIDX file	for the	packfiles in the current .git folder.

	       $ git multi-pack-index verify

SEE ALSO
       See The Multi-Pack-Index	Design Document[1] and The Multi-Pack-Index
       Format[2] for more information on the multi-pack-index feature.

GIT
       Part of the git(1) suite

NOTES
	1. The Multi-Pack-Index	Design Document
	   git-htmldocs/technical/multi-pack-index.html

	2. The Multi-Pack-Index	Format
	   git-htmldocs/technical/pack-format.html

Git 2.32.0			  06/06/2021		  GIT-MULTI-PACK-IN(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | GIT | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=git-multi-pack-index&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help