2005-10-12 21:01:31 +02:00
|
|
|
git-index-pack(1)
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
git-index-pack - Build pack index file for an existing packed archive
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
2007-05-18 15:39:34 +02:00
|
|
|
[verse]
|
2008-06-30 08:09:04 +02:00
|
|
|
'git index-pack' [-v] [-o <index-file>] <pack-file>
|
|
|
|
|
'git index-pack' --stdin [--fix-thin] [--keep] [-v] [-o <index-file>]
|
2007-05-18 15:39:34 +02:00
|
|
|
[<pack-file>]
|
2005-10-12 21:01:31 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
Reads a packed archive (.pack) from the specified file, and
|
|
|
|
|
builds a pack index file (.idx) for it. The packed archive
|
|
|
|
|
together with the pack index can then be placed in the
|
|
|
|
|
objects/pack/ directory of a git repository.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
-------
|
2006-10-26 05:32:59 +02:00
|
|
|
-v::
|
|
|
|
|
Be verbose about what is going on, including progress status.
|
|
|
|
|
|
2005-10-12 21:01:31 +02:00
|
|
|
-o <index-file>::
|
|
|
|
|
Write the generated pack index into the specified
|
|
|
|
|
file. Without this option the name of pack index
|
|
|
|
|
file is constructed from the name of packed archive
|
|
|
|
|
file by replacing .pack with .idx (and the program
|
|
|
|
|
fails if the name of packed archive does not end
|
|
|
|
|
with .pack).
|
|
|
|
|
|
2006-10-23 20:50:18 +02:00
|
|
|
--stdin::
|
|
|
|
|
When this flag is provided, the pack is read from stdin
|
|
|
|
|
instead and a copy is then written to <pack-file>. If
|
|
|
|
|
<pack-file> is not specified, the pack is written to
|
|
|
|
|
objects/pack/ directory of the current git repository with
|
2006-10-29 10:41:59 +01:00
|
|
|
a default name determined from the pack content. If
|
|
|
|
|
<pack-file> is not specified consider using --keep to
|
|
|
|
|
prevent a race condition between this process and
|
2008-07-03 07:41:41 +02:00
|
|
|
'git-repack'.
|
2005-10-12 21:01:31 +02:00
|
|
|
|
2006-10-26 05:28:17 +02:00
|
|
|
--fix-thin::
|
2008-07-03 07:41:41 +02:00
|
|
|
It is possible for 'git-pack-objects' to build
|
2006-10-26 05:28:17 +02:00
|
|
|
"thin" pack, which records objects in deltified form based on
|
|
|
|
|
objects not included in the pack to reduce network traffic.
|
|
|
|
|
Those objects are expected to be present on the receiving end
|
|
|
|
|
and they must be included in the pack for that pack to be self
|
|
|
|
|
contained and indexable. Without this option any attempt to
|
|
|
|
|
index a thin pack will fail. This option only makes sense in
|
2006-10-29 10:41:59 +01:00
|
|
|
conjunction with --stdin.
|
|
|
|
|
|
|
|
|
|
--keep::
|
|
|
|
|
Before moving the index into its final destination
|
|
|
|
|
create an empty .keep file for the associated pack file.
|
|
|
|
|
This option is usually necessary with --stdin to prevent a
|
2008-07-03 07:41:41 +02:00
|
|
|
simultaneous 'git-repack' process from deleting
|
2006-10-29 10:41:59 +01:00
|
|
|
the newly constructed pack and index before refs can be
|
|
|
|
|
updated to use objects contained in the pack.
|
|
|
|
|
|
|
|
|
|
--keep='why'::
|
|
|
|
|
Like --keep create a .keep file before moving the index into
|
|
|
|
|
its final destination, but rather than creating an empty file
|
|
|
|
|
place 'why' followed by an LF into the .keep file. The 'why'
|
|
|
|
|
message can later be searched for within all .keep files to
|
|
|
|
|
locate any which have outlived their usefulness.
|
2006-10-26 05:28:17 +02:00
|
|
|
|
2007-04-20 04:16:53 +02:00
|
|
|
--index-version=<version>[,<offset>]::
|
|
|
|
|
This is intended to be used by the test suite only. It allows
|
|
|
|
|
to force the version for the generated pack index, and to force
|
|
|
|
|
64-bit index entries on objects located above the given offset.
|
|
|
|
|
|
2008-02-25 22:46:12 +01:00
|
|
|
--strict::
|
|
|
|
|
Die, if the pack contains broken objects or links.
|
|
|
|
|
|
2006-10-26 05:28:17 +02:00
|
|
|
|
2006-11-01 23:06:25 +01:00
|
|
|
Note
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
Once the index has been created, the list of object names is sorted
|
|
|
|
|
and the SHA1 hash of that list is printed to stdout. If --stdin was
|
|
|
|
|
also used then this is prefixed by either "pack\t", or "keep\t" if a
|
|
|
|
|
new .keep file was successfully created. This is useful to remove a
|
2008-07-03 07:41:41 +02:00
|
|
|
.keep file used as a lock to prevent the race with 'git-repack'
|
2006-11-01 23:06:25 +01:00
|
|
|
mentioned above.
|
|
|
|
|
|
|
|
|
|
|
2005-10-12 21:01:31 +02:00
|
|
|
Author
|
|
|
|
|
------
|
|
|
|
|
Written by Sergey Vlasov <vsu@altlinux.ru>
|
|
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
|
-------------
|
|
|
|
|
Documentation by Sergey Vlasov
|
|
|
|
|
|
|
|
|
|
GIT
|
|
|
|
|
---
|
2008-06-06 09:07:32 +02:00
|
|
|
Part of the linkgit:git[1] suite
|
