| git-repack(1) | |
| ============= | |
| NAME | |
| ---- | |
| git-repack - Pack unpacked objects in a repository | |
| SYNOPSIS | |
| -------- | |
| 'git repack' [-a] [-A] [-d] [-f] [-l] [-n] [-q] [--window=N] [--depth=N] | |
| DESCRIPTION | |
| ----------- | |
| This script is used to combine all objects that do not currently | |
| reside in a "pack", into a pack. It can also be used to re-organize | |
| existing packs into a single, more efficient pack. | |
| A pack is a collection of objects, individually compressed, with | |
| delta compression applied, stored in a single file, with an | |
| associated index file. | |
| Packs are used to reduce the load on mirror systems, backup | |
| engines, disk storage, etc. | |
| OPTIONS | |
| ------- | |
| -a:: | |
| Instead of incrementally packing the unpacked objects, | |
| pack everything referenced into a single pack. | |
| Especially useful when packing a repository that is used | |
| for private development and there is no need to worry | |
| about people fetching via dumb protocols from it. Use | |
| with '-d'. This will clean up the objects that `git prune` | |
| leaves behind, but `git fsck --full` shows as | |
| dangling. | |
| -A:: | |
| Same as `-a`, unless '-d' is used. Then any unreachable | |
| objects in a previous pack become loose, unpacked objects, | |
| instead of being left in the old pack. Unreachable objects | |
| are never intentionally added to a pack, even when repacking. | |
| This option prevents unreachable objects from being immediately | |
| deleted by way of being left in the old pack and then | |
| removed. Instead, the loose unreachable objects | |
| will be pruned according to normal expiry rules | |
| with the next 'git-gc' invocation. See linkgit:git-gc[1]. | |
| -d:: | |
| After packing, if the newly created packs make some | |
| existing packs redundant, remove the redundant packs. | |
| Also run 'git-prune-packed' to remove redundant | |
| loose object files. | |
| -l:: | |
| Pass the `--local` option to 'git-pack-objects'. See | |
| linkgit:git-pack-objects[1]. | |
| -f:: | |
| Pass the `--no-reuse-object` option to `git-pack-objects`, see | |
| linkgit:git-pack-objects[1]. | |
| -q:: | |
| Pass the `-q` option to 'git-pack-objects'. See | |
| linkgit:git-pack-objects[1]. | |
| -n:: | |
| Do not update the server information with | |
| 'git-update-server-info'. This option skips | |
| updating local catalog files needed to publish | |
| this repository (or a direct copy of it) | |
| over HTTP or FTP. See linkgit:git-update-server-info[1]. | |
| --window=[N]:: | |
| --depth=[N]:: | |
| These two options affect how the objects contained in the pack are | |
| stored using delta compression. The objects are first internally | |
| sorted by type, size and optionally names and compared against the | |
| other objects within `--window` to see if using delta compression saves | |
| space. `--depth` limits the maximum delta depth; making it too deep | |
| affects the performance on the unpacker side, because delta data needs | |
| to be applied that many times to get to the necessary object. | |
| The default value for --window is 10 and --depth is 50. | |
| --window-memory=[N]:: | |
| This option provides an additional limit on top of `--window`; | |
| the window size will dynamically scale down so as to not take | |
| up more than N bytes in memory. This is useful in | |
| repositories with a mix of large and small objects to not run | |
| out of memory with a large window, but still be able to take | |
| advantage of the large window for the smaller objects. The | |
| size can be suffixed with "k", "m", or "g". | |
| `--window-memory=0` makes memory usage unlimited, which is the | |
| default. | |
| --max-pack-size=<n>:: | |
| Maximum size of each output packfile, expressed in MiB. | |
| If specified, multiple packfiles may be created. | |
| The default is unlimited. | |
| Configuration | |
| ------------- | |
| When configuration variable `repack.UseDeltaBaseOffset` is set | |
| for the repository, the command passes `--delta-base-offset` | |
| option to 'git-pack-objects'; this typically results in slightly | |
| smaller packs, but the generated packs are incompatible with | |
| versions of git older than (and including) v1.4.3; do not set | |
| the variable in a repository that older version of git needs to | |
| be able to read (this includes repositories from which packs can | |
| be copied out over http or rsync, and people who obtained packs | |
| that way can try to use older git with it). | |
| Author | |
| ------ | |
| Written by Linus Torvalds <torvalds@osdl.org> | |
| Documentation | |
| -------------- | |
| Documentation by Ryan Anderson <ryan@michonline.com> | |
| SEE ALSO | |
| -------- | |
| linkgit:git-pack-objects[1] | |
| linkgit:git-prune-packed[1] | |
| GIT | |
| --- | |
| Part of the linkgit:git[1] suite |