Google Git
Sign in
chromium / external / gitster / git-htmldocs / 085534867cb82e0690945a1645554999bcfa542a / . / git-prune.txt
blob: 80d01b05710e250a5f1d548fca3fba54d50e0f29 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1git-prune(1)
2============
3
4NAME
5----
Junio C Hamano4ec06712007-06-09 20:39:33[diff] [blame]6git-prune - Prune all unreachable objects from the object database
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]7
8
9SYNOPSIS
10--------
Junio C Hamano15567bc2011-07-23 00:51:59[diff] [blame]11[verse]
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]12'git prune' [-n] [-v] [--expire <expire>] [--] [<head>...]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]13
14DESCRIPTION
15-----------
16
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]17NOTE: In most cases, users should run 'git gc', which calls
18'git prune'. See the section "NOTES", below.
Junio C Hamano7d575a52008-04-30 08:45:27[diff] [blame]19
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]20This runs 'git fsck --unreachable' using all the refs
Junio C Hamano4fdccb22010-02-19 09:58:14[diff] [blame]21available in `refs/`, optionally with additional set of
Junio C Hamano229a72f2008-05-16 00:47:56[diff] [blame]22objects specified on the command line, and prunes all unpacked
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]23objects unreachable from any of these head objects from the object database.
24In addition, it
25prunes the unpacked objects that are also found in packs by
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]26running 'git prune-packed'.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]27
Junio C Hamano229a72f2008-05-16 00:47:56[diff] [blame]28Note that unreachable, packed objects will remain. If this is
29not desired, see linkgit:git-repack[1].
30
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]31OPTIONS
32-------
33
34-n::
Junio C Hamanoe85e36f2010-08-10 05:30:14[diff] [blame]35--dry-run::
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]36Do not remove anything; just report what it would
37remove.
38
Junio C Hamanoa476efa2008-10-10 15:31:42[diff] [blame]39-v::
Junio C Hamanoe85e36f2010-08-10 05:30:14[diff] [blame]40--verbose::
Junio C Hamanoa476efa2008-10-10 15:31:42[diff] [blame]41Report all removed objects.
42
Junio C Hamano1bb569e2006-05-05 23:14:25[diff] [blame]43\--::
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]44Do not interpret any more arguments as options.
45
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]46--expire <time>::
Junio C Hamano0c999702007-12-03 09:57:55[diff] [blame]47Only expire loose objects older than <time>.
48
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]49<head>...::
50In addition to objects
51reachable from any of our references, keep objects
52reachable from listed <head>s.
53
54EXAMPLE
55-------
56
57To prune objects not used by your repository nor another that
58borrows from your repository via its
59`.git/objects/info/alternates`:
60
61------------
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]62$ git prune $(cd ../another && $(git rev-parse --all))
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]63------------
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]64
Junio C Hamano7d575a52008-04-30 08:45:27[diff] [blame]65Notes
66-----
67
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]68In most cases, users will not need to call 'git prune' directly, but
69should instead call 'git gc', which handles pruning along with
Junio C Hamano7d575a52008-04-30 08:45:27[diff] [blame]70many other housekeeping tasks.
71
72For a description of which objects are considered for pruning, see
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]73'git fsck''s --unreachable option.
Junio C Hamano7d575a52008-04-30 08:45:27[diff] [blame]74
Junio C Hamano9049d912008-05-29 02:09:50[diff] [blame]75SEE ALSO
Junio C Hamano7d575a52008-04-30 08:45:27[diff] [blame]76--------
77
78linkgit:git-fsck[1],
79linkgit:git-gc[1],
80linkgit:git-reflog[1]
81
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]82GIT
83---
Junio C Hamanof7c042d2008-06-06 22:50:53[diff] [blame]84Part of the linkgit:git[1] suite