ref-filter.h: add functions for filter/format & format-only
[alt-git.git] / Documentation / git-pack-redundant.txt
blob13c3eb5ec96c94970171c96f0c503cba418ab1d8
1 git-pack-redundant(1)
2 =====================
4 NAME
5 ----
6 git-pack-redundant - Find redundant pack files
9 SYNOPSIS
10 --------
11 [verse]
12 'git pack-redundant' [--verbose] [--alt-odb] (--all | <pack-filename>...)
14 WARNING
15 -------
16 `git pack-redundant` has been deprecated and is scheduled for removal in
17 a future version of Git. Because it can only remove entire duplicate
18 packs and not individual duplicate objects, it is generally not a useful
19 tool for reducing repository size. You are better off using `git gc` to
20 do so, which will put objects into a new pack, removing duplicates.
22 Running `pack-redundant` without the `--i-still-use-this` flag will fail
23 in this release. If you believe you have a use case for which
24 `pack-redundant` is better suited and oppose this removal, please
25 contact the Git mailing list at git@vger.kernel.org. More information
26 about the list is available at https://git-scm.com/community.
28 DESCRIPTION
29 -----------
30 This program computes which packs in your repository
31 are redundant. The output is suitable for piping to
32 `xargs rm` if you are in the root of the repository.
34 'git pack-redundant' accepts a list of objects on standard input. Any objects
35 given will be ignored when checking which packs are required. This makes the
36 following command useful when wanting to remove packs which contain unreachable
37 objects.
39 git fsck --full --unreachable | cut -d ' ' -f3 | \
40 git pack-redundant --all | xargs rm
42 OPTIONS
43 -------
46 --all::
47         Processes all packs. Any filenames on the command line are ignored.
49 --alt-odb::
50         Don't require objects present in packs from alternate object
51         database (odb) directories to be present in local packs.
53 --verbose::
54         Outputs some statistics to stderr. Has a small performance penalty.
56 SEE ALSO
57 --------
58 linkgit:git-pack-objects[1]
59 linkgit:git-repack[1]
60 linkgit:git-prune-packed[1]
62 GIT
63 ---
64 Part of the linkgit:git[1] suite