blob: a890f1be49ad18ad58c34c95fbd5adb1e13dcc23 [file] [log] [blame]
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -08001= gerrit gc
Edwin Kempin619169b2012-02-09 15:47:52 +01002
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -08003== NAME
Edwin Kempin619169b2012-02-09 15:47:52 +01004gerrit gc - Run the Git garbage collection
5
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -08006== SYNOPSIS
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -08007--
Edwin Kempin619169b2012-02-09 15:47:52 +01008'ssh' -p <port> <host> 'gerrit gc'
9 [--all]
Edwin Kempin4bdc72d2013-11-13 13:30:49 +010010 [--show-progress]
Edwin Kempin619169b2012-02-09 15:47:52 +010011 <NAME> ...
Yuxuan 'fishy' Wangd85b6872013-11-15 11:47:46 -080012--
Edwin Kempin619169b2012-02-09 15:47:52 +010013
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080014== DESCRIPTION
Edwin Kempin619169b2012-02-09 15:47:52 +010015Runs the Git garbage collection for the specified projects.
16
17A Gerrit system administrator can define the default parameters that
18should be used for running the garbage collection in the user global
19Git configuration file of the system user that runs the Gerrit
20server.
21
22Since the user global Git configuration file is overlaid with the Git
23configuration on repository level it is possible to specify
24repository specific parameters for the garbage collection in the Git
25repository configuration of every project.
26
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080027== ACCESS
Edwin Kempin619169b2012-02-09 15:47:52 +010028Caller must be a member of the privileged 'Administrators' group,
29or have been granted the
30link:access-control.html#capability_runGC[Run Garbage Collection]
31global capability.
32
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080033== SCRIPTING
Edwin Kempin619169b2012-02-09 15:47:52 +010034This command is intended to be used in scripts.
35
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080036== OPTIONS
Edwin Kempin619169b2012-02-09 15:47:52 +010037<NAME>::
38 Name of the projects for which the Git garbage collection should be run.
39
40--all::
41 If specified the Git garbage collection is run for all projects
42 sequentially.
43
Edwin Kempin4bdc72d2013-11-13 13:30:49 +010044--show-progress::
45 If specified progress information is shown.
46
Yuxuan 'fishy' Wang61698b12013-12-20 12:55:51 -080047== EXAMPLES
Edwin Kempin619169b2012-02-09 15:47:52 +010048
49Run the Git garbage collection for the projects 'myProject' and
50'yourProject':
51=====
52 $ ssh -p 29418 review.example.com gerrit gc myProject yourProject
53 collecting garbage for "myProject":
54 ...
55 done.
56
57 collecting garbage for "yourProject":
58 ...
59 done.
60=====
61
62Run the Git garbage collection for all projects:
63=====
64 $ ssh -p 29418 review.example.com gerrit gc --all
65=====
66
67GERRIT
68------
69Part of link:index.html[Gerrit Code Review]
Yuxuan 'fishy' Wang99cb68d2013-10-31 17:26:00 -070070
71SEARCHBOX
72---------