git-pack-objects.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-pack-objects(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-pack-objects(1) Manual Page</h1>
 444 <h2 id="_name">NAME</h2>
 445 <div class="sectionbody">
 446 <p>git-pack-objects - Create a packed archive of objects</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 pack-objects</em> [-q | --progress | --all-progress] [--all-progress-implied]
 455         [--no-reuse-delta] [--delta-base-offset] [--non-empty]
 456         [--local] [--incremental] [--window=&lt;n&gt;] [--depth=&lt;n&gt;]
 457         [--revs [--unpacked | --all]] [--keep-pack=&lt;pack-name&gt;]
 458         [--cruft] [--cruft-expiration=&lt;time&gt;]
 459         [--stdout [--filter=&lt;filter-spec&gt;] | &lt;base-name&gt;]
 460         [--shallow] [--keep-true-parents] [--[no-]sparse] &lt; &lt;object-list&gt;</pre>
 461 </div>
 462 </div>
 463 </div>
 464 <div class="sect1">
 465 <h2 id="_description">DESCRIPTION</h2>
 466 <div class="sectionbody">
 467 <div class="paragraph">
 468 <p>Reads list of objects from the standard input, and writes either one or
 469 more packed archives with the specified base-name to disk, or a packed
 470 archive to the standard output.</p>
 471 </div>
 472 <div class="paragraph">
 473 <p>A packed archive is an efficient way to transfer a set of objects
 474 between two repositories as well as an access efficient archival
 475 format.  In a packed archive, an object is either stored as a
 476 compressed whole or as a difference from some other object.
 477 The latter is often called a delta.</p>
 478 </div>
 479 <div class="paragraph">
 480 <p>The packed archive format (.pack) is designed to be self-contained
 481 so that it can be unpacked without any further information. Therefore,
 482 each object that a delta depends upon must be present within the pack.</p>
 483 </div>
 484 <div class="paragraph">
 485 <p>A pack index file (.idx) is generated for fast, random access to the
 486 objects in the pack. Placing both the index file (.idx) and the packed
 487 archive (.pack) in the pack/ subdirectory of $GIT_OBJECT_DIRECTORY (or
 488 any of the directories on $GIT_ALTERNATE_OBJECT_DIRECTORIES)
 489 enables Git to read from the pack archive.</p>
 490 </div>
 491 <div class="paragraph">
 492 <p>The <em>git unpack-objects</em> command can read the packed archive and
 493 expand the objects contained in the pack into "one-file
 494 one-object" format; this is typically done by the smart-pull
 495 commands when a pack is created on-the-fly for efficient network
 496 transport by their peers.</p>
 497 </div>
 498 </div>
 499 </div>
 500 <div class="sect1">
 501 <h2 id="_options">OPTIONS</h2>
 502 <div class="sectionbody">
 503 <div class="dlist">
 504 <dl>
 505 <dt class="hdlist1">base-name</dt>
 506 <dd>
 507 <p>Write into pairs of files (.pack and .idx), using
 508 &lt;base-name&gt; to determine the name of the created file.
 509 When this option is used, the two files in a pair are written in
 510 &lt;base-name&gt;-&lt;SHA-1&gt;.{pack,idx} files.  &lt;SHA-1&gt; is a hash
 511 based on the pack content and is written to the standard
 512 output of the command.</p>
 513 </dd>
 514 <dt class="hdlist1">--stdout</dt>
 515 <dd>
 516 <p>Write the pack contents (what would have been written to
 517 .pack file) out to the standard output.</p>
 518 </dd>
 519 <dt class="hdlist1">--revs</dt>
 520 <dd>
 521 <p>Read the revision arguments from the standard input, instead of
 522 individual object names.  The revision arguments are processed
 523 the same way as <em>git rev-list</em> with the <code>--objects</code> flag
 524 uses its <code>commit</code> arguments to build the list of objects it
 525 outputs.  The objects on the resulting list are packed.
 526 Besides revisions, <code>--not</code> or <code>--shallow</code> <em>&lt;SHA-1&gt;</em> lines are
 527 also accepted.</p>
 528 </dd>
 529 <dt class="hdlist1">--unpacked</dt>
 530 <dd>
 531 <p>This implies <code>--revs</code>.  When processing the list of
 532 revision arguments read from the standard input, limit
 533 the objects packed to those that are not already packed.</p>
 534 </dd>
 535 <dt class="hdlist1">--all</dt>
 536 <dd>
 537 <p>This implies <code>--revs</code>.  In addition to the list of
 538 revision arguments read from the standard input, pretend
 539 as if all refs under <code>refs/</code> are specified to be
 540 included.</p>
 541 </dd>
 542 <dt class="hdlist1">--include-tag</dt>
 543 <dd>
 544 <p>Include unasked-for annotated tags if the object they
 545 reference was included in the resulting packfile.  This
 546 can be useful to send new tags to native Git clients.</p>
 547 </dd>
 548 <dt class="hdlist1">--stdin-packs</dt>
 549 <dd>
 550 <p>Read the basenames of packfiles (e.g., <code>pack-1234abcd.pack</code>)
 551 from the standard input, instead of object names or revision
 552 arguments. The resulting pack contains all objects listed in the
 553 included packs (those not beginning with <code>^</code>), excluding any
 554 objects listed in the excluded packs (beginning with <code>^</code>).</p>
 555 <div class="paragraph">
 556 <p>Incompatible with <code>--revs</code>, or options that imply <code>--revs</code> (such as
 557 <code>--all</code>), with the exception of <code>--unpacked</code>, which is compatible.</p>
 558 </div>
 559 </dd>
 560 <dt class="hdlist1">--cruft</dt>
 561 <dd>
 562 <p>Packs unreachable objects into a separate "cruft" pack, denoted
 563 by the existence of a .<code>mtimes</code> file. Typically used by <code>git</code>
 564 <code>repack</code> <code>--cruft</code>. Callers provide a list of pack names and
 565 indicate which packs will remain in the repository, along with
 566 which packs will be deleted (indicated by the <code>-</code> prefix). The
 567 contents of the cruft pack are all objects not contained in the
 568 surviving packs which have not exceeded the grace period (see
 569 <code>--cruft-expiration</code> below), or which have exceeded the grace
 570 period, but are reachable from an other object which hasn&#8217;t.</p>
 571 <div class="paragraph">
 572 <p>When the input lists a pack containing all reachable objects (and lists
 573 all other packs as pending deletion), the corresponding cruft pack will
 574 contain all unreachable objects (with mtime newer than the
 575 <code>--cruft-expiration</code>) along with any unreachable objects whose mtime is
 576 older than the <code>--cruft-expiration</code>, but are reachable from an
 577 unreachable object whose mtime is newer than the <code>--cruft-expiration</code>).</p>
 578 </div>
 579 <div class="paragraph">
 580 <p>Incompatible with <code>--unpack-unreachable</code>, <code>--keep-unreachable</code>,
 581 <code>--pack-loose-unreachable</code>, <code>--stdin-packs</code>, as well as any other
 582 options which imply <code>--revs</code>.</p>
 583 </div>
 584 </dd>
 585 <dt class="hdlist1">--cruft-expiration=&lt;approxidate&gt;</dt>
 586 <dd>
 587 <p>If specified, objects are eliminated from the cruft pack if they
 588 have an mtime older than <em>&lt;approxidate&gt;</em>. If unspecified (and
 589 given <code>--cruft</code>), then no objects are eliminated.</p>
 590 </dd>
 591 <dt class="hdlist1">--window=&lt;n&gt;</dt>
 592 <dt class="hdlist1">--depth=&lt;n&gt;</dt>
 593 <dd>
 594 <p>These two options affect how the objects contained in
 595 the pack are stored using delta compression.  The
 596 objects are first internally sorted by type, size and
 597 optionally names and compared against the other objects
 598 within --window to see if using delta compression saves
 599 space.  --depth limits the maximum delta depth; making
 600 it too deep affects the performance on the unpacker
 601 side, because delta data needs to be applied that many
 602 times to get to the necessary object.</p>
 603 <div class="paragraph">
 604 <p>The default value for --window is 10 and --depth is 50. The maximum
 605 depth is 4095.</p>
 606 </div>
 607 </dd>
 608 <dt class="hdlist1">--window-memory=&lt;n&gt;</dt>
 609 <dd>
 610 <p>This option provides an additional limit on top of <code>--window</code>;
 611 the window size will dynamically scale down so as to not take
 612 up more than <em>&lt;n&gt;</em> bytes in memory.  This is useful in
 613 repositories with a mix of large and small objects to not run
 614 out of memory with a large window, but still be able to take
 615 advantage of the large window for the smaller objects.  The
 616 size can be suffixed with "k", "m", or "g".
 617 <code>--window-memory=0</code> makes memory usage unlimited.  The default
 618 is taken from the <code>pack.windowMemory</code> configuration variable.</p>
 619 </dd>
 620 <dt class="hdlist1">--max-pack-size=&lt;n&gt;</dt>
 621 <dd>
 622 <p>In unusual scenarios, you may not be able to create files
 623 larger than a certain size on your filesystem, and this option
 624 can be used to tell the command to split the output packfile
 625 into multiple independent packfiles, each not larger than the
 626 given size. The size can be suffixed with
 627 "k", "m", or "g". The minimum size allowed is limited to 1 MiB.
 628 The default is unlimited, unless the config variable
 629 <code>pack.packSizeLimit</code> is set. Note that this option may result in
 630 a larger and slower repository; see the discussion in
 631 <code>pack.packSizeLimit</code>.</p>
 632 </dd>
 633 <dt class="hdlist1">--honor-pack-keep</dt>
 634 <dd>
 635 <p>This flag causes an object already in a local pack that
 636 has a .keep file to be ignored, even if it would have
 637 otherwise been packed.</p>
 638 </dd>
 639 <dt class="hdlist1">--keep-pack=&lt;pack-name&gt;</dt>
 640 <dd>
 641 <p>This flag causes an object already in the given pack to be
 642 ignored, even if it would have otherwise been
 643 packed. <em>&lt;pack-name&gt;</em> is the pack file name without
 644 leading directory (e.g. <code>pack-123.pack</code>). The option could be
 645 specified multiple times to keep multiple packs.</p>
 646 </dd>
 647 <dt class="hdlist1">--incremental</dt>
 648 <dd>
 649 <p>This flag causes an object already in a pack to be ignored
 650 even if it would have otherwise been packed.</p>
 651 </dd>
 652 <dt class="hdlist1">--local</dt>
 653 <dd>
 654 <p>This flag causes an object that is borrowed from an alternate
 655 object store to be ignored even if it would have otherwise been
 656 packed.</p>
 657 </dd>
 658 <dt class="hdlist1">--non-empty</dt>
 659 <dd>
 660 <p>Only create a packed archive if it would contain at
 661 least one object.</p>
 662 </dd>
 663 <dt class="hdlist1">--progress</dt>
 664 <dd>
 665 <p>Progress status is reported on the standard error stream
 666 by default when it is attached to a terminal, unless -q
 667 is specified. This flag forces progress status even if
 668 the standard error stream is not directed to a terminal.</p>
 669 </dd>
 670 <dt class="hdlist1">--all-progress</dt>
 671 <dd>
 672 <p>When --stdout is specified then progress report is
 673 displayed during the object count and compression phases
 674 but inhibited during the write-out phase. The reason is
 675 that in some cases the output stream is directly linked
 676 to another command which may wish to display progress
 677 status of its own as it processes incoming pack data.
 678 This flag is like --progress except that it forces progress
 679 report for the write-out phase as well even if --stdout is
 680 used.</p>
 681 </dd>
 682 <dt class="hdlist1">--all-progress-implied</dt>
 683 <dd>
 684 <p>This is used to imply --all-progress whenever progress display
 685 is activated.  Unlike --all-progress this flag doesn&#8217;t actually
 686 force any progress display by itself.</p>
 687 </dd>
 688 <dt class="hdlist1">-q</dt>
 689 <dd>
 690 <p>This flag makes the command not to report its progress
 691 on the standard error stream.</p>
 692 </dd>
 693 <dt class="hdlist1">--no-reuse-delta</dt>
 694 <dd>
 695 <p>When creating a packed archive in a repository that
 696 has existing packs, the command reuses existing deltas.
 697 This sometimes results in a slightly suboptimal pack.
 698 This flag tells the command not to reuse existing deltas
 699 but compute them from scratch.</p>
 700 </dd>
 701 <dt class="hdlist1">--no-reuse-object</dt>
 702 <dd>
 703 <p>This flag tells the command not to reuse existing object data at all,
 704 including non deltified object, forcing recompression of everything.
 705 This implies --no-reuse-delta. Useful only in the obscure case where
 706 wholesale enforcement of a different compression level on the
 707 packed data is desired.</p>
 708 </dd>
 709 <dt class="hdlist1">--compression=&lt;n&gt;</dt>
 710 <dd>
 711 <p>Specifies compression level for newly-compressed data in the
 712 generated pack.  If not specified,  pack compression level is
 713 determined first by pack.compression,  then by core.compression,
 714 and defaults to -1,  the zlib default,  if neither is set.
 715 Add --no-reuse-object if you want to force a uniform compression
 716 level on all data no matter the source.</p>
 717 </dd>
 718 <dt class="hdlist1">--[no-]sparse</dt>
 719 <dd>
 720 <p>Toggle the "sparse" algorithm to determine which objects to include in
 721 the pack, when combined with the "--revs" option. This algorithm
 722 only walks trees that appear in paths that introduce new objects.
 723 This can have significant performance benefits when computing
 724 a pack to send a small change. However, it is possible that extra
 725 objects are added to the pack-file if the included commits contain
 726 certain types of direct renames. If this option is not included,
 727 it defaults to the value of <code>pack.useSparse</code>, which is true unless
 728 otherwise specified.</p>
 729 </dd>
 730 <dt class="hdlist1">--thin</dt>
 731 <dd>
 732 <p>Create a "thin" pack by omitting the common objects between a
 733 sender and a receiver in order to reduce network transfer. This
 734 option only makes sense in conjunction with --stdout.</p>
 735 <div class="paragraph">
 736 <p>Note: A thin pack violates the packed archive format by omitting
 737 required objects and is thus unusable by Git without making it
 738 self-contained. Use <code>git</code> <code>index-pack</code> <code>--fix-thin</code>
 739 (see <a href="git-index-pack.html">git-index-pack(1)</a>) to restore the self-contained property.</p>
 740 </div>
 741 </dd>
 742 <dt class="hdlist1">--shallow</dt>
 743 <dd>
 744 <p>Optimize a pack that will be provided to a client with a shallow
 745 repository.  This option, combined with --thin, can result in a
 746 smaller pack at the cost of speed.</p>
 747 </dd>
 748 <dt class="hdlist1">--delta-base-offset</dt>
 749 <dd>
 750 <p>A packed archive can express the base object of a delta as
 751 either a 20-byte object name or as an offset in the
 752 stream, but ancient versions of Git don&#8217;t understand the
 753 latter.  By default, <em>git pack-objects</em> only uses the
 754 former format for better compatibility.  This option
 755 allows the command to use the latter format for
 756 compactness.  Depending on the average delta chain
 757 length, this option typically shrinks the resulting
 758 packfile by 3-5 per-cent.</p>
 759 <div class="paragraph">
 760 <p>Note: Porcelain commands such as <code>git</code> <code>gc</code> (see <a href="git-gc.html">git-gc(1)</a>),
 761 <code>git</code> <code>repack</code> (see <a href="git-repack.html">git-repack(1)</a>) pass this option by default
 762 in modern Git when they put objects in your repository into pack files.
 763 So does <code>git</code> <code>bundle</code> (see <a href="git-bundle.html">git-bundle(1)</a>) when it creates a bundle.</p>
 764 </div>
 765 </dd>
 766 <dt class="hdlist1">--threads=&lt;n&gt;</dt>
 767 <dd>
 768 <p>Specifies the number of threads to spawn when searching for best
 769 delta matches.  This requires that pack-objects be compiled with
 770 pthreads otherwise this option is ignored with a warning.
 771 This is meant to reduce packing time on multiprocessor machines.
 772 The required amount of memory for the delta search window is
 773 however multiplied by the number of threads.
 774 Specifying 0 will cause Git to auto-detect the number of CPU&#8217;s
 775 and set the number of threads accordingly.</p>
 776 </dd>
 777 <dt class="hdlist1">--index-version=&lt;version&gt;[,&lt;offset&gt;]</dt>
 778 <dd>
 779 <p>This is intended to be used by the test suite only. It allows
 780 to force the version for the generated pack index, and to force
 781 64-bit index entries on objects located above the given offset.</p>
 782 </dd>
 783 <dt class="hdlist1">--keep-true-parents</dt>
 784 <dd>
 785 <p>With this option, parents that are hidden by grafts are packed
 786 nevertheless.</p>
 787 </dd>
 788 <dt class="hdlist1">--filter=&lt;filter-spec&gt;</dt>
 789 <dd>
 790 <p>Omits certain objects (usually blobs) from the resulting
 791 packfile.  See <a href="git-rev-list.html">git-rev-list(1)</a> for valid
 792 <em>&lt;filter-spec&gt;</em> forms.</p>
 793 </dd>
 794 <dt class="hdlist1">--no-filter</dt>
 795 <dd>
 796 <p>Turns off any previous <code>--filter=</code> argument.</p>
 797 </dd>
 798 <dt class="hdlist1">--missing=&lt;missing-action&gt;</dt>
 799 <dd>
 800 <p>A debug option to help with future "partial clone" development.
 801 This option specifies how missing objects are handled.</p>
 802 <div class="paragraph">
 803 <p>The form <em>--missing=error</em> requests that pack-objects stop with an error if
 804 a missing object is encountered.  If the repository is a partial clone, an
 805 attempt to fetch missing objects will be made before declaring them missing.
 806 This is the default action.</p>
 807 </div>
 808 <div class="paragraph">
 809 <p>The form <em>--missing=allow-any</em> will allow object traversal to continue
 810 if a missing object is encountered.  No fetch of a missing object will occur.
 811 Missing objects will silently be omitted from the results.</p>
 812 </div>
 813 <div class="paragraph">
 814 <p>The form <em>--missing=allow-promisor</em> is like <em>allow-any</em>, but will only
 815 allow object traversal to continue for EXPECTED promisor missing objects.
 816 No fetch of a missing object will occur.  An unexpected missing object will
 817 raise an error.</p>
 818 </div>
 819 </dd>
 820 <dt class="hdlist1">--exclude-promisor-objects</dt>
 821 <dd>
 822 <p>Omit objects that are known to be in the promisor remote.  (This
 823 option has the purpose of operating only on locally created objects,
 824 so that when we repack, we still maintain a distinction between
 825 locally created objects [without .promisor] and objects from the
 826 promisor remote [with .promisor].)  This is used with partial clone.</p>
 827 </dd>
 828 <dt class="hdlist1">--keep-unreachable</dt>
 829 <dd>
 830 <p>Objects unreachable from the refs in packs named with
 831 --unpacked= option are added to the resulting pack, in
 832 addition to the reachable objects that are not in packs marked
 833 with *.keep files. This implies <code>--revs</code>.</p>
 834 </dd>
 835 <dt class="hdlist1">--pack-loose-unreachable</dt>
 836 <dd>
 837 <p>Pack unreachable loose objects (and their loose counterparts
 838 removed). This implies <code>--revs</code>.</p>
 839 </dd>
 840 <dt class="hdlist1">--unpack-unreachable</dt>
 841 <dd>
 842 <p>Keep unreachable objects in loose form. This implies <code>--revs</code>.</p>
 843 </dd>
 844 <dt class="hdlist1">--delta-islands</dt>
 845 <dd>
 846 <p>Restrict delta matches based on "islands". See DELTA ISLANDS
 847 below.</p>
 848 </dd>
 849 </dl>
 850 </div>
 851 </div>
 852 </div>
 853 <div class="sect1">
 854 <h2 id="_delta_islands">DELTA ISLANDS</h2>
 855 <div class="sectionbody">
 856 <div class="paragraph">
 857 <p>When possible, <code>pack-objects</code> tries to reuse existing on-disk deltas to
 858 avoid having to search for new ones on the fly. This is an important
 859 optimization for serving fetches, because it means the server can avoid
 860 inflating most objects at all and just send the bytes directly from
 861 disk. This optimization can&#8217;t work when an object is stored as a delta
 862 against a base which the receiver does not have (and which we are not
 863 already sending). In that case the server "breaks" the delta and has to
 864 find a new one, which has a high CPU cost. Therefore it&#8217;s important for
 865 performance that the set of objects in on-disk delta relationships match
 866 what a client would fetch.</p>
 867 </div>
 868 <div class="paragraph">
 869 <p>In a normal repository, this tends to work automatically. The objects
 870 are mostly reachable from the branches and tags, and that&#8217;s what clients
 871 fetch. Any deltas we find on the server are likely to be between objects
 872 the client has or will have.</p>
 873 </div>
 874 <div class="paragraph">
 875 <p>But in some repository setups, you may have several related but separate
 876 groups of ref tips, with clients tending to fetch those groups
 877 independently. For example, imagine that you are hosting several "forks"
 878 of a repository in a single shared object store, and letting clients
 879 view them as separate repositories through <code>GIT_NAMESPACE</code> or separate
 880 repos using the alternates mechanism. A naive repack may find that the
 881 optimal delta for an object is against a base that is only found in
 882 another fork. But when a client fetches, they will not have the base
 883 object, and we&#8217;ll have to find a new delta on the fly.</p>
 884 </div>
 885 <div class="paragraph">
 886 <p>A similar situation may exist if you have many refs outside of
 887 <code>refs/heads/</code> and <code>refs/tags/</code> that point to related objects (e.g.,
 888 <code>refs/pull</code> or <code>refs/changes</code> used by some hosting providers). By
 889 default, clients fetch only heads and tags, and deltas against objects
 890 found only in those other groups cannot be sent as-is.</p>
 891 </div>
 892 <div class="paragraph">
 893 <p>Delta islands solve this problem by allowing you to group your refs into
 894 distinct "islands". Pack-objects computes which objects are reachable
 895 from which islands, and refuses to make a delta from an object <code>A</code>
 896 against a base which is not present in all of <code>A</code>'s islands. This
 897 results in slightly larger packs (because we miss some delta
 898 opportunities), but guarantees that a fetch of one island will not have
 899 to recompute deltas on the fly due to crossing island boundaries.</p>
 900 </div>
 901 <div class="paragraph">
 902 <p>When repacking with delta islands the delta window tends to get
 903 clogged with candidates that are forbidden by the config. Repacking
 904 with a big --window helps (and doesn&#8217;t take as long as it otherwise
 905 might because we can reject some object pairs based on islands before
 906 doing any computation on the content).</p>
 907 </div>
 908 <div class="paragraph">
 909 <p>Islands are configured via the <code>pack.island</code> option, which can be
 910 specified multiple times. Each value is a left-anchored regular
 911 expressions matching refnames. For example:</p>
 912 </div>
 913 <div class="listingblock">
 914 <div class="content">
 915 <pre>[pack]
 916 island = refs/heads/
 917 island = refs/tags/</pre>
 918 </div>
 919 </div>
 920 <div class="paragraph">
 921 <p>puts heads and tags into an island (whose name is the empty string; see
 922 below for more on naming). Any refs which do not match those regular
 923 expressions (e.g., <code>refs/pull/123</code>) is not in any island. Any object
 924 which is reachable only from <code>refs/pull/</code> (but not heads or tags) is
 925 therefore not a candidate to be used as a base for <code>refs/heads/</code>.</p>
 926 </div>
 927 <div class="paragraph">
 928 <p>Refs are grouped into islands based on their "names", and two regexes
 929 that produce the same name are considered to be in the same
 930 island. The names are computed from the regexes by concatenating any
 931 capture groups from the regex, with a <em>-</em> dash in between. (And if
 932 there are no capture groups, then the name is the empty string, as in
 933 the above example.) This allows you to create arbitrary numbers of
 934 islands. Only up to 14 such capture groups are supported though.</p>
 935 </div>
 936 <div class="paragraph">
 937 <p>For example, imagine you store the refs for each fork in
 938 <code>refs/virtual/ID</code>, where <code>ID</code> is a numeric identifier. You might then
 939 configure:</p>
 940 </div>
 941 <div class="listingblock">
 942 <div class="content">
 943 <pre>[pack]
 944 island = refs/virtual/([0-9]+)/heads/
 945 island = refs/virtual/([0-9]+)/tags/
 946 island = refs/virtual/([0-9]+)/(pull)/</pre>
 947 </div>
 948 </div>
 949 <div class="paragraph">
 950 <p>That puts the heads and tags for each fork in their own island (named
 951 "1234" or similar), and the pull refs for each go into their own
 952 "1234-pull".</p>
 953 </div>
 954 <div class="paragraph">
 955 <p>Note that we pick a single island for each regex to go into, using "last
 956 one wins" ordering (which allows repo-specific config to take precedence
 957 over user-wide config, and so forth).</p>
 958 </div>
 959 </div>
 960 </div>
 961 <div class="sect1">
 962 <h2 id="_configuration">CONFIGURATION</h2>
 963 <div class="sectionbody">
 964 <div class="paragraph">
 965 <p>Various configuration variables affect packing, see
 966 <a href="git-config.html">git-config(1)</a> (search for "pack" and "delta").</p>
 967 </div>
 968 <div class="paragraph">
 969 <p>Notably, delta compression is not used on objects larger than the
 970 <code>core.bigFileThreshold</code> configuration variable and on files with the
 971 attribute <code>delta</code> set to false.</p>
 972 </div>
 973 </div>
 974 </div>
 975 <div class="sect1">
 976 <h2 id="_see_also">SEE ALSO</h2>
 977 <div class="sectionbody">
 978 <div class="paragraph">
 979 <p><a href="git-rev-list.html">git-rev-list(1)</a>
 980 <a href="git-repack.html">git-repack(1)</a>
 981 <a href="git-prune-packed.html">git-prune-packed(1)</a></p>
 982 </div>
 983 </div>
 984 </div>
 985 <div class="sect1">
 986 <h2 id="_git">GIT</h2>
 987 <div class="sectionbody">
 988 <div class="paragraph">
 989 <p>Part of the <a href="git.html">git(1)</a> suite</p>
 990 </div>
 991 </div>
 992 </div>
 993 </div>
 994 <div id="footer">
 995 <div id="footer-text">
 996 Last updated 2023-10-10 11:55:22 -0700
 997 </div>
 998 </div>
 999 </body>
1000 </html>