git-gc.html

   1 <!DOCTYPE html>
   2 <html xmlns="http://www.w3.org/1999/xhtml" lang="en">
   3 <head>
   4 <meta charset="UTF-8"/>
   5 <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
   7 <meta name="generator" content="Asciidoctor 2.0.20"/>
   8 <title>git-gc(1)</title>
   9 <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700"/>
  10 <style>
  11 /*! Asciidoctor default stylesheet | MIT License | https://asciidoctor.org */
  12 /* Uncomment the following line when using as a custom stylesheet */
  13 /* @import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700"; */
  14 html{font-family:sans-serif;-webkit-text-size-adjust:100%}
  15 a{background:none}
  16 a:focus{outline:thin dotted}
  17 a:active,a:hover{outline:0}
  18 h1{font-size:2em;margin:.67em 0}
  19 b,strong{font-weight:bold}
  20 abbr{font-size:.9em}
  21 abbr[title]{cursor:help;border-bottom:1px dotted #dddddf;text-decoration:none}
  22 dfn{font-style:italic}
  23 hr{height:0}
  24 mark{background:#ff0;color:#000}
  25 code,kbd,pre,samp{font-family:monospace;font-size:1em}
  26 pre{white-space:pre-wrap}
  27 q{quotes:"\201C" "\201D" "\2018" "\2019"}
  28 small{font-size:80%}
  29 sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
  30 sup{top:-.5em}
  31 sub{bottom:-.25em}
  32 img{border:0}
  33 svg:not(:root){overflow:hidden}
  34 figure{margin:0}
  35 audio,video{display:inline-block}
  36 audio:not([controls]){display:none;height:0}
  37 fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
  38 legend{border:0;padding:0}
  39 button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
  40 button,input{line-height:normal}
  41 button,select{text-transform:none}
  42 button,html input[type=button],input[type=reset],input[type=submit]{-webkit-appearance:button;cursor:pointer}
  43 button[disabled],html input[disabled]{cursor:default}
  44 input[type=checkbox],input[type=radio]{padding:0}
  45 button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
  46 textarea{overflow:auto;vertical-align:top}
  47 table{border-collapse:collapse;border-spacing:0}
  48 *,::before,::after{box-sizing:border-box}
  49 html,body{font-size:100%}
  50 body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;line-height:1;position:relative;cursor:auto;-moz-tab-size:4;-o-tab-size:4;tab-size:4;word-wrap:anywhere;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased}
  51 a:hover{cursor:pointer}
  52 img,object,embed{max-width:100%;height:auto}
  53 object,embed{height:100%}
  54 img{-ms-interpolation-mode:bicubic}
  55 .left{float:left!important}
  56 .right{float:right!important}
  57 .text-left{text-align:left!important}
  58 .text-right{text-align:right!important}
  59 .text-center{text-align:center!important}
  60 .text-justify{text-align:justify!important}
  61 .hide{display:none}
  62 img,object,svg{display:inline-block;vertical-align:middle}
  63 textarea{height:auto;min-height:50px}
  64 select{width:100%}
  65 .subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
  66 div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0}
  67 a{color:#2156a5;text-decoration:underline;line-height:inherit}
  68 a:hover,a:focus{color:#1d4b8f}
  69 a img{border:0}
  70 p{line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
  71 p aside{font-size:.875em;line-height:1.35;font-style:italic}
  72 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
  73 h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
  74 h1{font-size:2.125em}
  75 h2{font-size:1.6875em}
  76 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
  77 h4,h5{font-size:1.125em}
  78 h6{font-size:1em}
  79 hr{border:solid #dddddf;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em}
  80 em,i{font-style:italic;line-height:inherit}
  81 strong,b{font-weight:bold;line-height:inherit}
  82 small{font-size:60%;line-height:inherit}
  83 code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
  84 ul,ol,dl{line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
  85 ul,ol{margin-left:1.5em}
  86 ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0}
  87 ul.circle{list-style-type:circle}
  88 ul.disc{list-style-type:disc}
  89 ul.square{list-style-type:square}
  90 ul.circle ul:not([class]),ul.disc ul:not([class]),ul.square ul:not([class]){list-style:inherit}
  91 ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
  92 dl dt{margin-bottom:.3125em;font-weight:bold}
  93 dl dd{margin-bottom:1.25em}
  94 blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
  95 blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
  96 @media screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
  97 h1{font-size:2.75em}
  98 h2{font-size:2.3125em}
  99 h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
 100 h4{font-size:1.4375em}}
 101 table{background:#fff;margin-bottom:1.25em;border:1px solid #dedede;word-wrap:normal}
 102 table thead,table tfoot{background:#f7f8f7}
 103 table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
 104 table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
 105 table tr.even,table tr.alt{background:#f8f8f7}
 106 table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{line-height:1.6}
 107 h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
 108 h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
 109 .center{margin-left:auto;margin-right:auto}
 110 .stretch{width:100%}
 111 .clearfix::before,.clearfix::after,.float-group::before,.float-group::after{content:" ";display:table}
 112 .clearfix::after,.float-group::after{clear:both}
 113 :not(pre).nobreak{word-wrap:normal}
 114 :not(pre).nowrap{white-space:nowrap}
 115 :not(pre).pre-wrap{white-space:pre-wrap}
 116 :not(pre):not([class^=L])>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background:#f7f7f8;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed}
 117 pre{color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;line-height:1.45;text-rendering:optimizeSpeed}
 118 pre code,pre pre{color:inherit;font-size:inherit;line-height:inherit}
 119 pre>code{display:block}
 120 pre.nowrap,pre.nowrap pre{white-space:pre;word-wrap:normal}
 121 em em{font-style:normal}
 122 strong strong{font-weight:400}
 123 .keyseq{color:rgba(51,51,51,.8)}
 124 kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background:#f7f7f7;border:1px solid #ccc;border-radius:3px;box-shadow:0 1px 0 rgba(0,0,0,.2),inset 0 0 0 .1em #fff;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
 125 .keyseq kbd:first-child{margin-left:0}
 126 .keyseq kbd:last-child{margin-right:0}
 127 .menuseq,.menuref{color:#000}
 128 .menuseq b:not(.caret),.menuref{font-weight:inherit}
 129 .menuseq{word-spacing:-.02em}
 130 .menuseq b.caret{font-size:1.25em;line-height:.8}
 131 .menuseq i.caret{font-weight:bold;text-align:center;width:.45em}
 132 b.button::before,b.button::after{position:relative;top:-1px;font-weight:400}
 133 b.button::before{content:"[";padding:0 3px 0 2px}
 134 b.button::after{content:"]";padding:0 2px 0 3px}
 135 p a>code:hover{color:rgba(0,0,0,.9)}
 136 #header,#content,#footnotes,#footer{width:100%;margin:0 auto;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
 137 #header::before,#header::after,#content::before,#content::after,#footnotes::before,#footnotes::after,#footer::before,#footer::after{content:" ";display:table}
 138 #header::after,#content::after,#footnotes::after,#footer::after{clear:both}
 139 #content{margin-top:1.25em}
 140 #content::before{content:none}
 141 #header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
 142 #header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #dddddf}
 143 #header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #dddddf;padding-bottom:8px}
 144 #header .details{border-bottom:1px solid #dddddf;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:flex;flex-flow:row wrap}
 145 #header .details span:first-child{margin-left:-.125em}
 146 #header .details span.email a{color:rgba(0,0,0,.85)}
 147 #header .details br{display:none}
 148 #header .details br+span::before{content:"\00a0\2013\00a0"}
 149 #header .details br+span.author::before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
 150 #header .details br+span#revremark::before{content:"\00a0|\00a0"}
 151 #header #revnumber{text-transform:capitalize}
 152 #header #revnumber::after{content:"\00a0"}
 153 #content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #dddddf;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
 154 #toc{border-bottom:1px solid #e7e7e9;padding-bottom:.5em}
 155 #toc>ul{margin-left:.125em}
 156 #toc ul.sectlevel0>li>a{font-style:italic}
 157 #toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
 158 #toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
 159 #toc li{line-height:1.3334;margin-top:.3334em}
 160 #toc a{text-decoration:none}
 161 #toc a:active{text-decoration:underline}
 162 #toctitle{color:#7a2518;font-size:1.2em}
 163 @media screen and (min-width:768px){#toctitle{font-size:1.375em}
 164 body.toc2{padding-left:15em;padding-right:0}
 165 #toc.toc2{margin-top:0!important;background:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #e7e7e9;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
 166 #toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
 167 #toc.toc2>ul{font-size:.9em;margin-bottom:0}
 168 #toc.toc2 ul ul{margin-left:0;padding-left:1em}
 169 #toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
 170 body.toc2.toc-right{padding-left:0;padding-right:15em}
 171 body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #e7e7e9;left:auto;right:0}}
 172 @media screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
 173 #toc.toc2{width:20em}
 174 #toc.toc2 #toctitle{font-size:1.375em}
 175 #toc.toc2>ul{font-size:.95em}
 176 #toc.toc2 ul ul{padding-left:1.25em}
 177 body.toc2.toc-right{padding-left:0;padding-right:20em}}
 178 #content #toc{border:1px solid #e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;border-radius:4px}
 179 #content #toc>:first-child{margin-top:0}
 180 #content #toc>:last-child{margin-bottom:0}
 181 #footer{max-width:none;background:rgba(0,0,0,.8);padding:1.25em}
 182 #footer-text{color:hsla(0,0%,100%,.8);line-height:1.44}
 183 #content{margin-bottom:.625em}
 184 .sect1{padding-bottom:.625em}
 185 @media screen and (min-width:768px){#content{margin-bottom:1.25em}
 186 .sect1{padding-bottom:1.25em}}
 187 .sect1:last-child{padding-bottom:0}
 188 .sect1+.sect1{border-top:1px solid #e7e7e9}
 189 #content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
 190 #content h1>a.anchor::before,h2>a.anchor::before,h3>a.anchor::before,#toctitle>a.anchor::before,.sidebarblock>.content>.title>a.anchor::before,h4>a.anchor::before,h5>a.anchor::before,h6>a.anchor::before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
 191 #content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
 192 #content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
 193 #content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
 194 details,.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
 195 details{margin-left:1.25rem}
 196 details>summary{cursor:pointer;display:block;position:relative;line-height:1.6;margin-bottom:.625rem;outline:none;-webkit-tap-highlight-color:transparent}
 197 details>summary::-webkit-details-marker{display:none}
 198 details>summary::before{content:"";border:solid transparent;border-left:solid;border-width:.3em 0 .3em .5em;position:absolute;top:.5em;left:-1.25rem;transform:translateX(15%)}
 199 details[open]>summary::before{border:solid transparent;border-top:solid;border-width:.5em .3em 0;transform:translateY(15%)}
 200 details>summary::after{content:"";width:1.25rem;height:1em;position:absolute;top:.3em;left:-1.25rem}
 201 .admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
 202 table.tableblock.fit-content>caption.title{white-space:nowrap;width:0}
 203 .paragraph.lead>p,#preamble>.sectionbody>[class=paragraph]:first-of-type p{font-size:1.21875em;line-height:1.6;color:rgba(0,0,0,.85)}
 204 .admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
 205 .admonitionblock>table td.icon{text-align:center;width:80px}
 206 .admonitionblock>table td.icon img{max-width:none}
 207 .admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
 208 .admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #dddddf;color:rgba(0,0,0,.6);word-wrap:anywhere}
 209 .admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
 210 .exampleblock>.content{border:1px solid #e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;border-radius:4px}
 211 .sidebarblock{border:1px solid #dbdbd6;margin-bottom:1.25em;padding:1.25em;background:#f3f3f2;border-radius:4px}
 212 .sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
 213 .exampleblock>.content>:first-child,.sidebarblock>.content>:first-child{margin-top:0}
 214 .exampleblock>.content>:last-child,.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
 215 .literalblock pre,.listingblock>.content>pre{border-radius:4px;overflow-x:auto;padding:1em;font-size:.8125em}
 216 @media screen and (min-width:768px){.literalblock pre,.listingblock>.content>pre{font-size:.90625em}}
 217 @media screen and (min-width:1280px){.literalblock pre,.listingblock>.content>pre{font-size:1em}}
 218 .literalblock pre,.listingblock>.content>pre:not(.highlight),.listingblock>.content>pre[class=highlight],.listingblock>.content>pre[class^="highlight "]{background:#f7f7f8}
 219 .literalblock.output pre{color:#f7f7f8;background:rgba(0,0,0,.9)}
 220 .listingblock>.content{position:relative}
 221 .listingblock code[data-lang]::before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:inherit;opacity:.5}
 222 .listingblock:hover code[data-lang]::before{display:block}
 223 .listingblock.terminal pre .command::before{content:attr(data-prompt);padding-right:.5em;color:inherit;opacity:.5}
 224 .listingblock.terminal pre .command:not([data-prompt])::before{content:"$"}
 225 .listingblock pre.highlightjs{padding:0}
 226 .listingblock pre.highlightjs>code{padding:1em;border-radius:4px}
 227 .listingblock pre.prettyprint{border-width:0}
 228 .prettyprint{background:#f7f7f8}
 229 pre.prettyprint .linenums{line-height:1.45;margin-left:2em}
 230 pre.prettyprint li{background:none;list-style-type:inherit;padding-left:0}
 231 pre.prettyprint li code[data-lang]::before{opacity:1}
 232 pre.prettyprint li:not(:first-child) code[data-lang]::before{display:none}
 233 table.linenotable{border-collapse:separate;border:0;margin-bottom:0;background:none}
 234 table.linenotable td[class]{color:inherit;vertical-align:top;padding:0;line-height:inherit;white-space:normal}
 235 table.linenotable td.code{padding-left:.75em}
 236 table.linenotable td.linenos,pre.pygments .linenos{border-right:1px solid;opacity:.35;padding-right:.5em;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}
 237 pre.pygments span.linenos{display:inline-block;margin-right:.75em}
 238 .quoteblock{margin:0 1em 1.25em 1.5em;display:table}
 239 .quoteblock:not(.excerpt)>.title{margin-left:-1.5em;margin-bottom:.75em}
 240 .quoteblock blockquote,.quoteblock p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
 241 .quoteblock blockquote{margin:0;padding:0;border:0}
 242 .quoteblock blockquote::before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
 243 .quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
 244 .quoteblock .attribution{margin-top:.75em;margin-right:.5ex;text-align:right}
 245 .verseblock{margin:0 1em 1.25em}
 246 .verseblock pre{font-family:"Open Sans","DejaVu Sans",sans-serif;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
 247 .verseblock pre strong{font-weight:400}
 248 .verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
 249 .quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
 250 .quoteblock .attribution br,.verseblock .attribution br{display:none}
 251 .quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
 252 .quoteblock.abstract blockquote::before,.quoteblock.excerpt blockquote::before,.quoteblock .quoteblock blockquote::before{display:none}
 253 .quoteblock.abstract blockquote,.quoteblock.abstract p,.quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{line-height:1.6;word-spacing:0}
 254 .quoteblock.abstract{margin:0 1em 1.25em;display:block}
 255 .quoteblock.abstract>.title{margin:0 0 .375em;font-size:1.15em;text-align:center}
 256 .quoteblock.excerpt>blockquote,.quoteblock .quoteblock{padding:0 0 .25em 1em;border-left:.25em solid #dddddf}
 257 .quoteblock.excerpt,.quoteblock .quoteblock{margin-left:0}
 258 .quoteblock.excerpt blockquote,.quoteblock.excerpt p,.quoteblock .quoteblock blockquote,.quoteblock .quoteblock p{color:inherit;font-size:1.0625rem}
 259 .quoteblock.excerpt .attribution,.quoteblock .quoteblock .attribution{color:inherit;font-size:.85rem;text-align:left;margin-right:0}
 260 p.tableblock:last-child{margin-bottom:0}
 261 td.tableblock>.content{margin-bottom:1.25em;word-wrap:anywhere}
 262 td.tableblock>.content>:last-child{margin-bottom:-1.25em}
 263 table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
 264 table.grid-all>*>tr>*{border-width:1px}
 265 table.grid-cols>*>tr>*{border-width:0 1px}
 266 table.grid-rows>*>tr>*{border-width:1px 0}
 267 table.frame-all{border-width:1px}
 268 table.frame-ends{border-width:1px 0}
 269 table.frame-sides{border-width:0 1px}
 270 table.frame-none>colgroup+*>:first-child>*,table.frame-sides>colgroup+*>:first-child>*{border-top-width:0}
 271 table.frame-none>:last-child>:last-child>*,table.frame-sides>:last-child>:last-child>*{border-bottom-width:0}
 272 table.frame-none>*>tr>:first-child,table.frame-ends>*>tr>:first-child{border-left-width:0}
 273 table.frame-none>*>tr>:last-child,table.frame-ends>*>tr>:last-child{border-right-width:0}
 274 table.stripes-all>*>tr,table.stripes-odd>*>tr:nth-of-type(odd),table.stripes-even>*>tr:nth-of-type(even),table.stripes-hover>*>tr:hover{background:#f8f8f7}
 275 th.halign-left,td.halign-left{text-align:left}
 276 th.halign-right,td.halign-right{text-align:right}
 277 th.halign-center,td.halign-center{text-align:center}
 278 th.valign-top,td.valign-top{vertical-align:top}
 279 th.valign-bottom,td.valign-bottom{vertical-align:bottom}
 280 th.valign-middle,td.valign-middle{vertical-align:middle}
 281 table thead th,table tfoot th{font-weight:bold}
 282 tbody tr th{background:#f7f8f7}
 283 tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
 284 p.tableblock>code:only-child{background:none;padding:0}
 285 p.tableblock{font-size:1em}
 286 ol{margin-left:1.75em}
 287 ul li ol{margin-left:1.5em}
 288 dl dd{margin-left:1.125em}
 289 dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
 290 li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
 291 ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none}
 292 ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em}
 293 ul.unstyled,ol.unstyled{margin-left:0}
 294 li>p:empty:only-child::before{content:"";display:inline-block}
 295 ul.checklist>li>p:first-child{margin-left:-1em}
 296 ul.checklist>li>p:first-child>.fa-square-o:first-child,ul.checklist>li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em}
 297 ul.checklist>li>p:first-child>input[type=checkbox]:first-child{margin-right:.25em}
 298 ul.inline{display:flex;flex-flow:row wrap;list-style:none;margin:0 0 .625em -1.25em}
 299 ul.inline>li{margin-left:1.25em}
 300 .unstyled dl dt{font-weight:400;font-style:normal}
 301 ol.arabic{list-style-type:decimal}
 302 ol.decimal{list-style-type:decimal-leading-zero}
 303 ol.loweralpha{list-style-type:lower-alpha}
 304 ol.upperalpha{list-style-type:upper-alpha}
 305 ol.lowerroman{list-style-type:lower-roman}
 306 ol.upperroman{list-style-type:upper-roman}
 307 ol.lowergreek{list-style-type:lower-greek}
 308 .hdlist>table,.colist>table{border:0;background:none}
 309 .hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
 310 td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
 311 td.hdlist1{font-weight:bold;padding-bottom:1.25em}
 312 td.hdlist2{word-wrap:anywhere}
 313 .literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
 314 .colist td:not([class]):first-child{padding:.4em .75em 0;line-height:1;vertical-align:top}
 315 .colist td:not([class]):first-child img{max-width:none}
 316 .colist td:not([class]):last-child{padding:.25em 0}
 317 .thumb,.th{line-height:0;display:inline-block;border:4px solid #fff;box-shadow:0 0 0 1px #ddd}
 318 .imageblock.left{margin:.25em .625em 1.25em 0}
 319 .imageblock.right{margin:.25em 0 1.25em .625em}
 320 .imageblock>.title{margin-bottom:0}
 321 .imageblock.thumb,.imageblock.th{border-width:6px}
 322 .imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
 323 .image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
 324 .image.left{margin-right:.625em}
 325 .image.right{margin-left:.625em}
 326 a.image{text-decoration:none;display:inline-block}
 327 a.image object{pointer-events:none}
 328 sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
 329 sup.footnote a,sup.footnoteref a{text-decoration:none}
 330 sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
 331 #footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
 332 #footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em;border-width:1px 0 0}
 333 #footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;margin-bottom:.2em}
 334 #footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none;margin-left:-1.05em}
 335 #footnotes .footnote:last-of-type{margin-bottom:0}
 336 #content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
 337 div.unbreakable{page-break-inside:avoid}
 338 .big{font-size:larger}
 339 .small{font-size:smaller}
 340 .underline{text-decoration:underline}
 341 .overline{text-decoration:overline}
 342 .line-through{text-decoration:line-through}
 343 .aqua{color:#00bfbf}
 344 .aqua-background{background:#00fafa}
 345 .black{color:#000}
 346 .black-background{background:#000}
 347 .blue{color:#0000bf}
 348 .blue-background{background:#0000fa}
 349 .fuchsia{color:#bf00bf}
 350 .fuchsia-background{background:#fa00fa}
 351 .gray{color:#606060}
 352 .gray-background{background:#7d7d7d}
 353 .green{color:#006000}
 354 .green-background{background:#007d00}
 355 .lime{color:#00bf00}
 356 .lime-background{background:#00fa00}
 357 .maroon{color:#600000}
 358 .maroon-background{background:#7d0000}
 359 .navy{color:#000060}
 360 .navy-background{background:#00007d}
 361 .olive{color:#606000}
 362 .olive-background{background:#7d7d00}
 363 .purple{color:#600060}
 364 .purple-background{background:#7d007d}
 365 .red{color:#bf0000}
 366 .red-background{background:#fa0000}
 367 .silver{color:#909090}
 368 .silver-background{background:#bcbcbc}
 369 .teal{color:#006060}
 370 .teal-background{background:#007d7d}
 371 .white{color:#bfbfbf}
 372 .white-background{background:#fafafa}
 373 .yellow{color:#bfbf00}
 374 .yellow-background{background:#fafa00}
 375 span.icon>.fa{cursor:default}
 376 a span.icon>.fa{cursor:inherit}
 377 .admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
 378 .admonitionblock td.icon .icon-note::before{content:"\f05a";color:#19407c}
 379 .admonitionblock td.icon .icon-tip::before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
 380 .admonitionblock td.icon .icon-warning::before{content:"\f071";color:#bf6900}
 381 .admonitionblock td.icon .icon-caution::before{content:"\f06d";color:#bf3400}
 382 .admonitionblock td.icon .icon-important::before{content:"\f06a";color:#bf0000}
 383 .conum[data-value]{display:inline-block;color:#fff!important;background:rgba(0,0,0,.8);border-radius:50%;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
 384 .conum[data-value] *{color:#fff!important}
 385 .conum[data-value]+b{display:none}
 386 .conum[data-value]::after{content:attr(data-value)}
 387 pre .conum[data-value]{position:relative;top:-.125em}
 388 b.conum *{color:inherit!important}
 389 .conum:not([data-value]):empty{display:none}
 390 dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
 391 h1,h2,p,td.content,span.alt,summary{letter-spacing:-.01em}
 392 p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
 393 p,blockquote,dt,td.content,td.hdlist1,span.alt,summary{font-size:1.0625rem}
 394 p{margin-bottom:1.25rem}
 395 .sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
 396 .exampleblock>.content{background:#fffef7;border-color:#e0e0dc;box-shadow:0 1px 4px #e0e0dc}
 397 .print-only{display:none!important}
 398 @page{margin:1.25cm .75cm}
 399 @media print{*{box-shadow:none!important;text-shadow:none!important}
 400 html{font-size:80%}
 401 a{color:inherit!important;text-decoration:underline!important}
 402 a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
 403 a[href^="http:"]:not(.bare)::after,a[href^="https:"]:not(.bare)::after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
 404 abbr[title]{border-bottom:1px dotted}
 405 abbr[title]::after{content:" (" attr(title) ")"}
 406 pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
 407 thead{display:table-header-group}
 408 svg{max-width:100%}
 409 p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
 410 h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
 411 #header,#content,#footnotes,#footer{max-width:none}
 412 #toc,.sidebarblock,.exampleblock>.content{background:none!important}
 413 #toc{border-bottom:1px solid #dddddf!important;padding-bottom:0!important}
 414 body.book #header{text-align:center}
 415 body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em}
 416 body.book #header .details{border:0!important;display:block;padding:0!important}
 417 body.book #header .details span:first-child{margin-left:0!important}
 418 body.book #header .details br{display:block}
 419 body.book #header .details br+span::before{content:none!important}
 420 body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
 421 body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
 422 .listingblock code[data-lang]::before{display:block}
 423 #footer{padding:0 .9375em}
 424 .hide-on-print{display:none!important}
 425 .print-only{display:block!important}
 426 .hide-for-print{display:none!important}
 427 .show-for-print{display:inherit!important}}
 428 @media amzn-kf8,print{#header>h1:first-child{margin-top:1.25rem}
 429 .sect1{padding:0!important}
 430 .sect1+.sect1{border:0}
 431 #footer{background:none}
 432 #footer-text{color:rgba(0,0,0,.6);font-size:.9em}}
 433 @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}}
 434 </style>
 435 <style>
 436 pre>code {
 437    display: inline;
 438 }
 439 </style>
 440 </head>
 441 <body class="manpage">
 442 <div id="header">
 443 <h1>git-gc(1) Manual Page</h1>
 444 <h2 id="_name">NAME</h2>
 445 <div class="sectionbody">
 446 <p>git-gc - Cleanup unnecessary files and optimize the local repository</p>
 447 </div>
 448 </div>
 449 <div id="content">
 450 <div class="sect1">
 451 <h2 id="_synopsis">SYNOPSIS</h2>
 452 <div class="sectionbody">
 453 <div class="verseblock">
 454 <pre class="content"><em>git gc</em> [--aggressive] [--auto] [--quiet] [--prune=&lt;date&gt; | --no-prune] [--force] [--keep-largest-pack]</pre>
 455 </div>
 456 </div>
 457 </div>
 458 <div class="sect1">
 459 <h2 id="_description">DESCRIPTION</h2>
 460 <div class="sectionbody">
 461 <div class="paragraph">
 462 <p>Runs a number of housekeeping tasks within the current repository,
 463 such as compressing file revisions (to reduce disk space and increase
 464 performance), removing unreachable objects which may have been
 465 created from prior invocations of <em>git add</em>, packing refs, pruning
 466 reflog, rerere metadata or stale working trees. May also update ancillary
 467 indexes such as the commit-graph.</p>
 468 </div>
 469 <div class="paragraph">
 470 <p>When common porcelain operations that create objects are run, they
 471 will check whether the repository has grown substantially since the
 472 last maintenance, and if so run <code>git gc</code> automatically. See <code>gc.auto</code>
 473 below for how to disable this behavior.</p>
 474 </div>
 475 <div class="paragraph">
 476 <p>Running <code>git gc</code> manually should only be needed when adding objects to
 477 a repository without regularly running such porcelain commands, to do
 478 a one-off repository optimization, or e.g. to clean up a suboptimal
 479 mass-import. See the "PACKFILE OPTIMIZATION" section in
 480 <a href="git-fast-import.html">git-fast-import(1)</a> for more details on the import case.</p>
 481 </div>
 482 </div>
 483 </div>
 484 <div class="sect1">
 485 <h2 id="_options">OPTIONS</h2>
 486 <div class="sectionbody">
 487 <div class="dlist">
 488 <dl>
 489 <dt class="hdlist1">--aggressive</dt>
 490 <dd>
 491 <p>Usually <em>git gc</em> runs very quickly while providing good disk
 492 space utilization and performance.  This option will cause
 493 <em>git gc</em> to more aggressively optimize the repository at the expense
 494 of taking much more time.  The effects of this optimization are
 495 mostly persistent. See the "AGGRESSIVE" section below for details.</p>
 496 </dd>
 497 <dt class="hdlist1">--auto</dt>
 498 <dd>
 499 <p>With this option, <em>git gc</em> checks whether any housekeeping is
 500 required; if not, it exits without performing any work.</p>
 501 <div class="paragraph">
 502 <p>See the <code>gc.auto</code> option in the "CONFIGURATION" section below for how
 503 this heuristic works.</p>
 504 </div>
 505 <div class="paragraph">
 506 <p>Once housekeeping is triggered by exceeding the limits of
 507 configuration options such as <code>gc.auto</code> and <code>gc.autoPackLimit</code>, all
 508 other housekeeping tasks (e.g. rerere, working trees, reflog&#8230;&#8203;) will
 509 be performed as well.</p>
 510 </div>
 511 </dd>
 512 <dt class="hdlist1">--[no-]cruft</dt>
 513 <dd>
 514 <p>When expiring unreachable objects, pack them separately into a
 515 cruft pack instead of storing them as loose objects. <code>--cruft</code>
 516 is on by default.</p>
 517 </dd>
 518 <dt class="hdlist1">--max-cruft-size=&lt;n&gt;</dt>
 519 <dd>
 520 <p>When packing unreachable objects into a cruft pack, limit the
 521 size of new cruft packs to be at most <code>&lt;n&gt;</code> bytes. Overrides any
 522 value specified via the <code>gc.maxCruftSize</code> configuration. See
 523 the <code>--max-cruft-size</code> option of <a href="git-repack.html">git-repack(1)</a> for
 524 more.</p>
 525 </dd>
 526 <dt class="hdlist1">--prune=&lt;date&gt;</dt>
 527 <dd>
 528 <p>Prune loose objects older than date (default is 2 weeks ago,
 529 overridable by the config variable <code>gc.pruneExpire</code>).
 530 --prune=now prunes loose objects regardless of their age and
 531 increases the risk of corruption if another process is writing to
 532 the repository concurrently; see "NOTES" below. --prune is on by
 533 default.</p>
 534 </dd>
 535 <dt class="hdlist1">--no-prune</dt>
 536 <dd>
 537 <p>Do not prune any loose objects.</p>
 538 </dd>
 539 <dt class="hdlist1">--quiet</dt>
 540 <dd>
 541 <p>Suppress all progress reports.</p>
 542 </dd>
 543 <dt class="hdlist1">--force</dt>
 544 <dd>
 545 <p>Force <code>git gc</code> to run even if there may be another <code>git gc</code>
 546 instance running on this repository.</p>
 547 </dd>
 548 <dt class="hdlist1">--keep-largest-pack</dt>
 549 <dd>
 550 <p>All packs except the largest non-cruft pack, any packs marked
 551 with a <code>.keep</code> file, and any cruft pack(s) are consolidated into
 552 a single pack. When this option is used, <code>gc.bigPackThreshold</code>
 553 is ignored.</p>
 554 </dd>
 555 </dl>
 556 </div>
 557 </div>
 558 </div>
 559 <div class="sect1">
 560 <h2 id="_aggressive">AGGRESSIVE</h2>
 561 <div class="sectionbody">
 562 <div class="paragraph">
 563 <p>When the <code>--aggressive</code> option is supplied, <a href="git-repack.html">git-repack(1)</a> will
 564 be invoked with the <code>-f</code> flag, which in turn will pass
 565 <code>--no-reuse-delta</code> to <a href="git-pack-objects.html">git-pack-objects(1)</a>. This will throw
 566 away any existing deltas and re-compute them, at the expense of
 567 spending much more time on the repacking.</p>
 568 </div>
 569 <div class="paragraph">
 570 <p>The effects of this are mostly persistent, e.g. when packs and loose
 571 objects are coalesced into one another pack the existing deltas in
 572 that pack might get re-used, but there are also various cases where we
 573 might pick a sub-optimal delta from a newer pack instead.</p>
 574 </div>
 575 <div class="paragraph">
 576 <p>Furthermore, supplying <code>--aggressive</code> will tweak the <code>--depth</code> and
 577 <code>--window</code> options passed to <a href="git-repack.html">git-repack(1)</a>. See the
 578 <code>gc.aggressiveDepth</code> and <code>gc.aggressiveWindow</code> settings below. By
 579 using a larger window size we&#8217;re more likely to find more optimal
 580 deltas.</p>
 581 </div>
 582 <div class="paragraph">
 583 <p>It&#8217;s probably not worth it to use this option on a given repository
 584 without running tailored performance benchmarks on it. It takes a lot
 585 more time, and the resulting space/delta optimization may or may not
 586 be worth it. Not using this at all is the right trade-off for most
 587 users and their repositories.</p>
 588 </div>
 589 </div>
 590 </div>
 591 <div class="sect1">
 592 <h2 id="_configuration">CONFIGURATION</h2>
 593 <div class="sectionbody">
 594 <div class="paragraph">
 595 <p>Everything below this line in this section is selectively included
 596 from the <a href="git-config.html">git-config(1)</a> documentation. The content is the same
 597 as what&#8217;s found there:</p>
 598 </div>
 599 <div class="dlist">
 600 <dl>
 601 <dt class="hdlist1">gc.aggressiveDepth</dt>
 602 <dd>
 603 <p>The depth parameter used in the delta compression
 604 algorithm used by <em>git gc --aggressive</em>.  This defaults
 605 to 50, which is the default for the <code>--depth</code> option when
 606 <code>--aggressive</code> isn&#8217;t in use.</p>
 607 <div class="paragraph">
 608 <p>See the documentation for the <code>--depth</code> option in
 609 <a href="git-repack.html">git-repack(1)</a> for more details.</p>
 610 </div>
 611 </dd>
 612 <dt class="hdlist1">gc.aggressiveWindow</dt>
 613 <dd>
 614 <p>The window size parameter used in the delta compression
 615 algorithm used by <em>git gc --aggressive</em>.  This defaults
 616 to 250, which is a much more aggressive window size than
 617 the default <code>--window</code> of 10.</p>
 618 <div class="paragraph">
 619 <p>See the documentation for the <code>--window</code> option in
 620 <a href="git-repack.html">git-repack(1)</a> for more details.</p>
 621 </div>
 622 </dd>
 623 <dt class="hdlist1">gc.auto</dt>
 624 <dd>
 625 <p>When there are approximately more than this many loose
 626 objects in the repository, <code>git gc --auto</code> will pack them.
 627 Some Porcelain commands use this command to perform a
 628 light-weight garbage collection from time to time.  The
 629 default value is 6700.</p>
 630 <div class="paragraph">
 631 <p>Setting this to 0 disables not only automatic packing based on the
 632 number of loose objects, but also any other heuristic <code>git gc --auto</code> will
 633 otherwise use to determine if there&#8217;s work to do, such as
 634 <code>gc.autoPackLimit</code>.</p>
 635 </div>
 636 </dd>
 637 <dt class="hdlist1">gc.autoPackLimit</dt>
 638 <dd>
 639 <p>When there are more than this many packs that are not
 640 marked with <code>*.keep</code> file in the repository, <code>git gc
 641 --auto</code> consolidates them into one larger pack.  The
 642 default value is 50.  Setting this to 0 disables it.
 643 Setting <code>gc.auto</code> to 0 will also disable this.</p>
 644 <div class="paragraph">
 645 <p>See the <code>gc.bigPackThreshold</code> configuration variable below. When in
 646 use, it&#8217;ll affect how the auto pack limit works.</p>
 647 </div>
 648 </dd>
 649 <dt class="hdlist1">gc.autoDetach</dt>
 650 <dd>
 651 <p>Make <code>git gc --auto</code> return immediately and run in the background
 652 if the system supports it. Default is true.</p>
 653 </dd>
 654 <dt class="hdlist1">gc.bigPackThreshold</dt>
 655 <dd>
 656 <p>If non-zero, all non-cruft packs larger than this limit are kept
 657 when <code>git gc</code> is run. This is very similar to
 658 <code>--keep-largest-pack</code> except that all non-cruft packs that meet
 659 the threshold are kept, not just the largest pack. Defaults to
 660 zero. Common unit suffixes of <em>k</em>, <em>m</em>, or <em>g</em> are supported.</p>
 661 <div class="paragraph">
 662 <p>Note that if the number of kept packs is more than gc.autoPackLimit,
 663 this configuration variable is ignored, all packs except the base pack
 664 will be repacked. After this the number of packs should go below
 665 gc.autoPackLimit and gc.bigPackThreshold should be respected again.</p>
 666 </div>
 667 <div class="paragraph">
 668 <p>If the amount of memory estimated for <code>git repack</code> to run smoothly is
 669 not available and <code>gc.bigPackThreshold</code> is not set, the largest pack
 670 will also be excluded (this is the equivalent of running <code>git gc</code> with
 671 <code>--keep-largest-pack</code>).</p>
 672 </div>
 673 </dd>
 674 <dt class="hdlist1">gc.writeCommitGraph</dt>
 675 <dd>
 676 <p>If true, then gc will rewrite the commit-graph file when
 677 <a href="git-gc.html">git-gc(1)</a> is run. When using <code>git gc --auto</code>
 678 the commit-graph will be updated if housekeeping is
 679 required. Default is true. See <a href="git-commit-graph.html">git-commit-graph(1)</a>
 680 for details.</p>
 681 </dd>
 682 <dt class="hdlist1">gc.logExpiry</dt>
 683 <dd>
 684 <p>If the file gc.log exists, then <code>git gc --auto</code> will print
 685 its content and exit with status zero instead of running
 686 unless that file is more than <em>gc.logExpiry</em> old.  Default is
 687 "1.day".  See <code>gc.pruneExpire</code> for more ways to specify its
 688 value.</p>
 689 </dd>
 690 <dt class="hdlist1">gc.packRefs</dt>
 691 <dd>
 692 <p>Running <code>git pack-refs</code> in a repository renders it
 693 unclonable by Git versions prior to 1.5.1.2 over dumb
 694 transports such as HTTP.  This variable determines whether
 695 <em>git gc</em> runs <code>git pack-refs</code>. This can be set to <code>notbare</code>
 696 to enable it within all non-bare repos or it can be set to a
 697 boolean value.  The default is <code>true</code>.</p>
 698 </dd>
 699 <dt class="hdlist1">gc.cruftPacks</dt>
 700 <dd>
 701 <p>Store unreachable objects in a cruft pack (see
 702 <a href="git-repack.html">git-repack(1)</a>) instead of as loose objects. The default
 703 is <code>true</code>.</p>
 704 </dd>
 705 <dt class="hdlist1">gc.maxCruftSize</dt>
 706 <dd>
 707 <p>Limit the size of new cruft packs when repacking. When
 708 specified in addition to <code>--max-cruft-size</code>, the command line
 709 option takes priority. See the <code>--max-cruft-size</code> option of
 710 <a href="git-repack.html">git-repack(1)</a>.</p>
 711 </dd>
 712 <dt class="hdlist1">gc.pruneExpire</dt>
 713 <dd>
 714 <p>When <em>git gc</em> is run, it will call <em>prune --expire 2.weeks.ago</em>
 715 (and <em>repack --cruft --cruft-expiration 2.weeks.ago</em> if using
 716 cruft packs via <code>gc.cruftPacks</code> or <code>--cruft</code>).  Override the
 717 grace period with this config variable.  The value "now" may be
 718 used to disable this grace period and always prune unreachable
 719 objects immediately, or "never" may be used to suppress pruning.
 720 This feature helps prevent corruption when <em>git gc</em> runs
 721 concurrently with another process writing to the repository; see
 722 the "NOTES" section of <a href="git-gc.html">git-gc(1)</a>.</p>
 723 </dd>
 724 <dt class="hdlist1">gc.worktreePruneExpire</dt>
 725 <dd>
 726 <p>When <em>git gc</em> is run, it calls
 727 <em>git worktree prune --expire 3.months.ago</em>.
 728 This config variable can be used to set a different grace
 729 period. The value "now" may be used to disable the grace
 730 period and prune <code>$GIT_DIR/worktrees</code> immediately, or "never"
 731 may be used to suppress pruning.</p>
 732 </dd>
 733 <dt class="hdlist1">gc.reflogExpire</dt>
 734 <dt class="hdlist1">gc.&lt;pattern&gt;.reflogExpire</dt>
 735 <dd>
 736 <p><em>git reflog expire</em> removes reflog entries older than
 737 this time; defaults to 90 days. The value "now" expires all
 738 entries immediately, and "never" suppresses expiration
 739 altogether. With "&lt;pattern&gt;" (e.g.
 740 "refs/stash") in the middle the setting applies only to
 741 the refs that match the &lt;pattern&gt;.</p>
 742 </dd>
 743 <dt class="hdlist1">gc.reflogExpireUnreachable</dt>
 744 <dt class="hdlist1">gc.&lt;pattern&gt;.reflogExpireUnreachable</dt>
 745 <dd>
 746 <p><em>git reflog expire</em> removes reflog entries older than
 747 this time and are not reachable from the current tip;
 748 defaults to 30 days. The value "now" expires all entries
 749 immediately, and "never" suppresses expiration altogether.
 750 With "&lt;pattern&gt;" (e.g. "refs/stash")
 751 in the middle, the setting applies only to the refs that
 752 match the &lt;pattern&gt;.</p>
 753 <div class="paragraph">
 754 <p>These types of entries are generally created as a result of using <code>git
 755 commit --amend</code> or <code>git rebase</code> and are the commits prior to the amend
 756 or rebase occurring.  Since these changes are not part of the current
 757 project most users will want to expire them sooner, which is why the
 758 default is more aggressive than <code>gc.reflogExpire</code>.</p>
 759 </div>
 760 </dd>
 761 <dt class="hdlist1">gc.recentObjectsHook</dt>
 762 <dd>
 763 <p>When considering whether or not to remove an object (either when
 764 generating a cruft pack or storing unreachable objects as
 765 loose), use the shell to execute the specified command(s).
 766 Interpret their output as object IDs which Git will consider as
 767 "recent", regardless of their age. By treating their mtimes as
 768 "now", any objects (and their descendants) mentioned in the
 769 output will be kept regardless of their true age.</p>
 770 <div class="paragraph">
 771 <p>Output must contain exactly one hex object ID per line, and nothing
 772 else. Objects which cannot be found in the repository are ignored.
 773 Multiple hooks are supported, but all must exit successfully, else the
 774 operation (either generating a cruft pack or unpacking unreachable
 775 objects) will be halted.</p>
 776 </div>
 777 </dd>
 778 <dt class="hdlist1">gc.repackFilter</dt>
 779 <dd>
 780 <p>When repacking, use the specified filter to move certain
 781 objects into a separate packfile.  See the
 782 <code>--filter=&lt;filter-spec&gt;</code> option of <a href="git-repack.html">git-repack(1)</a>.</p>
 783 </dd>
 784 <dt class="hdlist1">gc.repackFilterTo</dt>
 785 <dd>
 786 <p>When repacking and using a filter, see <code>gc.repackFilter</code>, the
 787 specified location will be used to create the packfile
 788 containing the filtered out objects. <strong>WARNING:</strong> The
 789 specified location should be accessible, using for example the
 790 Git alternates mechanism, otherwise the repo could be
 791 considered corrupt by Git as it migh not be able to access the
 792 objects in that packfile. See the <code>--filter-to=&lt;dir&gt;</code> option
 793 of <a href="git-repack.html">git-repack(1)</a> and the <code>objects/info/alternates</code>
 794 section of <a href="gitrepository-layout.html">gitrepository-layout(5)</a>.</p>
 795 </dd>
 796 <dt class="hdlist1">gc.rerereResolved</dt>
 797 <dd>
 798 <p>Records of conflicted merge you resolved earlier are
 799 kept for this many days when <em>git rerere gc</em> is run.
 800 You can also use more human-readable "1.month.ago", etc.
 801 The default is 60 days.  See <a href="git-rerere.html">git-rerere(1)</a>.</p>
 802 </dd>
 803 <dt class="hdlist1">gc.rerereUnresolved</dt>
 804 <dd>
 805 <p>Records of conflicted merge you have not resolved are
 806 kept for this many days when <em>git rerere gc</em> is run.
 807 You can also use more human-readable "1.month.ago", etc.
 808 The default is 15 days.  See <a href="git-rerere.html">git-rerere(1)</a>.</p>
 809 </dd>
 810 </dl>
 811 </div>
 812 </div>
 813 </div>
 814 <div class="sect1">
 815 <h2 id="_notes">NOTES</h2>
 816 <div class="sectionbody">
 817 <div class="paragraph">
 818 <p><em>git gc</em> tries very hard not to delete objects that are referenced
 819 anywhere in your repository. In particular, it will keep not only
 820 objects referenced by your current set of branches and tags, but also
 821 objects referenced by the index, remote-tracking branches, reflogs
 822 (which may reference commits in branches that were later amended or
 823 rewound), and anything else in the refs/* namespace. Note that a note
 824 (of the kind created by <em>git notes</em>) attached to an object does not
 825 contribute in keeping the object alive. If you are expecting some
 826 objects to be deleted and they aren&#8217;t, check all of those locations
 827 and decide whether it makes sense in your case to remove those
 828 references.</p>
 829 </div>
 830 <div class="paragraph">
 831 <p>On the other hand, when <em>git gc</em> runs concurrently with another process,
 832 there is a risk of it deleting an object that the other process is using
 833 but hasn&#8217;t created a reference to. This may just cause the other process
 834 to fail or may corrupt the repository if the other process later adds a
 835 reference to the deleted object. Git has two features that significantly
 836 mitigate this problem:</p>
 837 </div>
 838 <div class="olist arabic">
 839 <ol class="arabic">
 840 <li>
 841 <p>Any object with modification time newer than the <code>--prune</code> date is kept,
 842 along with everything reachable from it.</p>
 843 </li>
 844 <li>
 845 <p>Most operations that add an object to the database update the
 846 modification time of the object if it is already present so that #1
 847 applies.</p>
 848 </li>
 849 </ol>
 850 </div>
 851 <div class="paragraph">
 852 <p>However, these features fall short of a complete solution, so users who
 853 run commands concurrently have to live with some risk of corruption (which
 854 seems to be low in practice).</p>
 855 </div>
 856 </div>
 857 </div>
 858 <div class="sect1">
 859 <h2 id="_hooks">HOOKS</h2>
 860 <div class="sectionbody">
 861 <div class="paragraph">
 862 <p>The <em>git gc --auto</em> command will run the <em>pre-auto-gc</em> hook.  See
 863 <a href="githooks.html">githooks(5)</a> for more information.</p>
 864 </div>
 865 </div>
 866 </div>
 867 <div class="sect1">
 868 <h2 id="_see_also">SEE ALSO</h2>
 869 <div class="sectionbody">
 870 <div class="paragraph">
 871 <p><a href="git-prune.html">git-prune(1)</a>
 872 <a href="git-reflog.html">git-reflog(1)</a>
 873 <a href="git-repack.html">git-repack(1)</a>
 874 <a href="git-rerere.html">git-rerere(1)</a></p>
 875 </div>
 876 </div>
 877 </div>
 878 <div class="sect1">
 879 <h2 id="_git">GIT</h2>
 880 <div class="sectionbody">
 881 <div class="paragraph">
 882 <p>Part of the <a href="git.html">git(1)</a> suite</p>
 883 </div>
 884 </div>
 885 </div>
 886 </div>
 887 <div id="footer">
 888 <div id="footer-text">
 889 Last updated 2023-10-18 13:44:22 -0700
 890 </div>
 891 </div>
 892 </body>
 893 </html>