Google Git
Sign in
chromium / external / gitster / git-htmldocs / a74e4c319c25bbf547ffb840f4e84d8e709291c5 / . / git-repack.html
blob: d9d185c90d1d3c3c2a131ebe1ed3e8f16f552480 [file] [log] [blame]
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4<head>
5<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]6<meta name="generator" content="AsciiDoc 8.4.5" />
7<title>git-repack(1)</title>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]8<style type="text/css">
9/* Debug borders */
10p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
11/*
12 border: 1px solid red;
13*/
14}
15
16body {
17 margin: 1em 5% 1em 5%;
18}
19
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]20a {
21 color: blue;
22 text-decoration: underline;
23}
24a:visited {
25 color: fuchsia;
26}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]27
28em {
29 font-style: italic;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]30 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]31}
32
33strong {
34 font-weight: bold;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]35 color: #083194;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]36}
37
38tt {
39 color: navy;
40}
41
42h1, h2, h3, h4, h5, h6 {
43 color: #527bbd;
44 font-family: sans-serif;
45 margin-top: 1.2em;
46 margin-bottom: 0.5em;
47 line-height: 1.3;
48}
49
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]50h1, h2, h3 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]51 border-bottom: 2px solid silver;
52}
53h2 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]54 padding-top: 0.5em;
55}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]56h3 {
57 float: left;
58}
59h3 + * {
60 clear: left;
61}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]62
63div.sectionbody {
64 font-family: serif;
65 margin-left: 0;
66}
67
68hr {
69 border: 1px solid silver;
70}
71
72p {
73 margin-top: 0.5em;
74 margin-bottom: 0.5em;
75}
76
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]77ul, ol, li > p {
78 margin-top: 0;
79}
80
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]81pre {
82 padding: 0;
83 margin: 0;
84}
85
86span#author {
87 color: #527bbd;
88 font-family: sans-serif;
89 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]90 font-size: 1.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]91}
92span#email {
93}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]94span#revnumber, span#revdate, span#revremark {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]95 font-family: sans-serif;
96}
97
98div#footer {
99 font-family: sans-serif;
100 font-size: small;
101 border-top: 2px solid silver;
102 padding-top: 0.5em;
103 margin-top: 4.0em;
104}
105div#footer-text {
106 float: left;
107 padding-bottom: 0.5em;
108}
109div#footer-badges {
110 float: right;
111 padding-bottom: 0.5em;
112}
113
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]114div#preamble {
115 margin-top: 1.5em;
116 margin-bottom: 1.5em;
117}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]118div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120div.admonitionblock {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]121 margin-top: 1.5em;
122 margin-bottom: 1.5em;
123}
124div.admonitionblock {
125 margin-top: 2.5em;
126 margin-bottom: 2.5em;
127}
128
129div.content { /* Block element content. */
130 padding: 0;
131}
132
133/* Block element titles. */
134div.title, caption.title {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]135 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]136 font-family: sans-serif;
137 font-weight: bold;
138 text-align: left;
139 margin-top: 1.0em;
140 margin-bottom: 0.5em;
141}
142div.title + * {
143 margin-top: 0;
144}
145
146td div.title:first-child {
147 margin-top: 0.0em;
148}
149div.content div.title:first-child {
150 margin-top: 0.0em;
151}
152div.content + div.title {
153 margin-top: 0.0em;
154}
155
156div.sidebarblock > div.content {
157 background: #ffffee;
158 border: 1px solid silver;
159 padding: 0.5em;
160}
161
162div.listingblock > div.content {
163 border: 1px solid silver;
164 background: #f4f4f4;
165 padding: 0.5em;
166}
167
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]168div.quoteblock {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]169 padding-left: 2.0em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]170 margin-right: 10%;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]171}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]172div.quoteblock > div.attribution {
173 padding-top: 0.5em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]174 text-align: right;
175}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]176
177div.verseblock {
178 padding-left: 2.0em;
179 margin-right: 10%;
180}
181div.verseblock > div.content {
182 white-space: pre;
183}
184div.verseblock > div.attribution {
185 padding-top: 0.75em;
186 text-align: left;
187}
188/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]189div.verseblock + div.attribution {
190 text-align: left;
191}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]192
193div.admonitionblock .icon {
194 vertical-align: top;
195 font-size: 1.1em;
196 font-weight: bold;
197 text-decoration: underline;
198 color: #527bbd;
199 padding-right: 0.5em;
200}
201div.admonitionblock td.content {
202 padding-left: 0.5em;
203 border-left: 2px solid silver;
204}
205
206div.exampleblock > div.content {
207 border-left: 2px solid silver;
208 padding: 0.5em;
209}
210
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]211div.imageblock div.content { padding-left: 0; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]212span.image img { border-style: none; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]213a.image:visited { color: white; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]214
215dl {
216 margin-top: 0.8em;
217 margin-bottom: 0.8em;
218}
219dt {
220 margin-top: 0.5em;
221 margin-bottom: 0;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]222 font-style: normal;
223 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]224}
225dd > *:first-child {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]226 margin-top: 0.1em;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]227}
228
229ul, ol {
230 list-style-position: outside;
231}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]232ol.arabic {
233 list-style-type: decimal;
234}
235ol.loweralpha {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]236 list-style-type: lower-alpha;
237}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]238ol.upperalpha {
239 list-style-type: upper-alpha;
240}
241ol.lowerroman {
242 list-style-type: lower-roman;
243}
244ol.upperroman {
245 list-style-type: upper-roman;
246}
247
248div.compact ul, div.compact ol,
249div.compact p, div.compact p,
250div.compact div, div.compact div {
251 margin-top: 0.1em;
252 margin-bottom: 0.1em;
253}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]254
255div.tableblock > table {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]256 border: 3px solid #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]257}
258thead {
259 font-family: sans-serif;
260 font-weight: bold;
261}
262tfoot {
263 font-weight: bold;
264}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]265td > div.verse {
266 white-space: pre;
267}
268p.table {
269 margin-top: 0;
270}
271/* Because the table frame attribute is overriden by CSS in most browsers. */
272div.tableblock > table[frame="void"] {
273 border-style: none;
274}
275div.tableblock > table[frame="hsides"] {
276 border-left-style: none;
277 border-right-style: none;
278}
279div.tableblock > table[frame="vsides"] {
280 border-top-style: none;
281 border-bottom-style: none;
282}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]283
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]284
285div.hdlist {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]286 margin-top: 0.8em;
287 margin-bottom: 0.8em;
288}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]289div.hdlist tr {
290 padding-bottom: 15px;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]291}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]292dt.hdlist1.strong, td.hdlist1.strong {
293 font-weight: bold;
294}
295td.hdlist1 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]296 vertical-align: top;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]297 font-style: normal;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]298 padding-right: 0.8em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]299 color: navy;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]300}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]301td.hdlist2 {
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]302 vertical-align: top;
303}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]304div.hdlist.compact tr {
305 margin: 0;
306 padding-bottom: 0;
307}
308
309.comment {
310 background: yellow;
311}
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]312
313@media print {
314 div#footer-badges { display: none; }
315}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]316
317div#toctitle {
318 color: #527bbd;
319 font-family: sans-serif;
320 font-size: 1.1em;
321 font-weight: bold;
322 margin-top: 1.0em;
323 margin-bottom: 0.1em;
324}
325
326div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
327 margin-top: 0;
328 margin-bottom: 0;
329}
330div.toclevel2 {
331 margin-left: 2em;
332 font-size: 0.9em;
333}
334div.toclevel3 {
335 margin-left: 4em;
336 font-size: 0.9em;
337}
338div.toclevel4 {
339 margin-left: 6em;
340 font-size: 0.9em;
341}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]342/* Overrides for manpage documents */
343h1 {
344 padding-top: 0.5em;
345 padding-bottom: 0.5em;
346 border-top: 2px solid silver;
347 border-bottom: 2px solid silver;
348}
349h2 {
350 border-style: none;
351}
352div.sectionbody {
353 margin-left: 5%;
354}
355
356@media print {
357 div#toc { display: none; }
358}
359
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]360/* Workarounds for IE6's broken and incomplete CSS2. */
361
362div.sidebar-content {
363 background: #ffffee;
364 border: 1px solid silver;
365 padding: 0.5em;
366}
367div.sidebar-title, div.image-title {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]368 color: #527bbd;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]369 font-family: sans-serif;
370 font-weight: bold;
371 margin-top: 0.0em;
372 margin-bottom: 0.5em;
373}
374
375div.listingblock div.content {
376 border: 1px solid silver;
377 background: #f4f4f4;
378 padding: 0.5em;
379}
380
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]381div.quoteblock-attribution {
382 padding-top: 0.5em;
383 text-align: right;
384}
385
386div.verseblock-content {
387 white-space: pre;
388}
389div.verseblock-attribution {
390 padding-top: 0.75em;
391 text-align: left;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]392}
393
394div.exampleblock-content {
395 border-left: 2px solid silver;
396 padding-left: 0.5em;
397}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]398
399/* IE6 sets dynamically generated links as visited. */
400div#toc a:visited { color: blue; }
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]401</style>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]402</head>
403<body>
404<div id="header">
405<h1>
406git-repack(1) Manual Page
407</h1>
408<h2>NAME</h2>
409<div class="sectionbody">
410<p>git-repack -
Junio C Hamano7c73c662007-01-19 00:37:50[diff] [blame]411 Pack unpacked objects in a repository
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]412</p>
413</div>
414</div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]415<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]416<div class="sectionbody">
Junio C Hamano15567bc2011-07-23 00:51:59[diff] [blame]417<div class="verseblock">
418<div class="verseblock-content"><em>git repack</em> [-a] [-A] [-d] [-f] [-F] [-l] [-n] [-q] [--window=&lt;n&gt;] [--depth=&lt;n&gt;]</div>
419<div class="verseblock-attribution">
420</div></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]421</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]422<h2 id="_description">DESCRIPTION</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]423<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]424<div class="paragraph"><p>This script is used to combine all objects that do not currently
Junio C Hamanoa6387422007-08-25 03:54:27[diff] [blame]425reside in a "pack", into a pack. It can also be used to re-organize
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]426existing packs into a single, more efficient pack.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]427<div class="paragraph"><p>A pack is a collection of objects, individually compressed, with
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]428delta compression applied, stored in a single file, with an
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]429associated index file.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]430<div class="paragraph"><p>Packs are used to reduce the load on mirror systems, backup
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]431engines, disk storage, etc.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]432</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]433<h2 id="_options">OPTIONS</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]434<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]435<div class="dlist"><dl>
436<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]437-a
438</dt>
439<dd>
440<p>
441 Instead of incrementally packing the unpacked objects,
Junio C Hamano401939f2007-07-01 06:34:30[diff] [blame]442 pack everything referenced into a single pack.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]443 Especially useful when packing a repository that is used
Junio C Hamano4d81e522009-06-10 08:08:51[diff] [blame]444 for private development. Use
Junio C Hamano401939f2007-07-01 06:34:30[diff] [blame]445 with <em>-d</em>. This will clean up the objects that <tt>git prune</tt>
446 leaves behind, but <tt>git fsck --full</tt> shows as
447 dangling.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]448</p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]449<div class="paragraph"><p>Note that users fetching over dumb protocols will have to fetch the
Junio C Hamano4d81e522009-06-10 08:08:51[diff] [blame]450whole new pack in order to get any contained object, no matter how many
451other objects in that pack they already have locally.</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]452</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]453<dt class="hdlist1">
Junio C Hamanob713ff12008-05-24 01:12:30[diff] [blame]454-A
455</dt>
456<dd>
457<p>
Junio C Hamanobba37ad2008-11-16 17:47:59[diff] [blame]458 Same as <tt>-a</tt>, unless <em>-d</em> is used. Then any unreachable
459 objects in a previous pack become loose, unpacked objects,
460 instead of being left in the old pack. Unreachable objects
461 are never intentionally added to a pack, even when repacking.
462 This option prevents unreachable objects from being immediately
Junio C Hamanob713ff12008-05-24 01:12:30[diff] [blame]463 deleted by way of being left in the old pack and then
464 removed. Instead, the loose unreachable objects
465 will be pruned according to normal expiry rules
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]466 with the next <em>git gc</em> invocation. See <a href="git-gc.html">git-gc(1)</a>.
Junio C Hamanob713ff12008-05-24 01:12:30[diff] [blame]467</p>
468</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]469<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]470-d
471</dt>
472<dd>
473<p>
474 After packing, if the newly created packs make some
475 existing packs redundant, remove the redundant packs.
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]476 Also run <em>git prune-packed</em> to remove redundant
Junio C Hamanofce7c7e2008-07-02 03:06:38[diff] [blame]477 loose object files.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]478</p>
479</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]480<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]481-l
482</dt>
483<dd>
484<p>
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]485 Pass the <tt>--local</tt> option to <em>git pack-objects</em>. See
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]486 <a href="git-pack-objects.html">git-pack-objects(1)</a>.
487</p>
488</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]489<dt class="hdlist1">
Junio C Hamano7e9f6b72006-02-22 10:44:55[diff] [blame]490-f
491</dt>
492<dd>
493<p>
Junio C Hamano657fd8a2010-10-07 00:01:24[diff] [blame]494 Pass the <tt>--no-reuse-delta</tt> option to <tt>git-pack-objects</tt>, see
495 <a href="git-pack-objects.html">git-pack-objects(1)</a>.
496</p>
497</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]498<dt class="hdlist1">
Junio C Hamano657fd8a2010-10-07 00:01:24[diff] [blame]499-F
500</dt>
501<dd>
502<p>
Junio C Hamano7cc91292008-09-20 16:55:38[diff] [blame]503 Pass the <tt>--no-reuse-object</tt> option to <tt>git-pack-objects</tt>, see
Junio C Hamano7e9f6b72006-02-22 10:44:55[diff] [blame]504 <a href="git-pack-objects.html">git-pack-objects(1)</a>.
505</p>
506</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]507<dt class="hdlist1">
Junio C Hamano7e9f6b72006-02-22 10:44:55[diff] [blame]508-q
509</dt>
510<dd>
511<p>
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]512 Pass the <tt>-q</tt> option to <em>git pack-objects</em>. See
Junio C Hamano7e9f6b72006-02-22 10:44:55[diff] [blame]513 <a href="git-pack-objects.html">git-pack-objects(1)</a>.
514</p>
515</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]516<dt class="hdlist1">
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]517-n
518</dt>
519<dd>
520<p>
521 Do not update the server information with
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]522 <em>git update-server-info</em>. This option skips
Junio C Hamanob713ff12008-05-24 01:12:30[diff] [blame]523 updating local catalog files needed to publish
524 this repository (or a direct copy of it)
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]525 over HTTP or FTP. See <a href="git-update-server-info.html">git-update-server-info(1)</a>.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]526</p>
527</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]528<dt class="hdlist1">
Junio C Hamanod2179ef2010-10-22 04:12:17[diff] [blame]529--window=&lt;n&gt;
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]530</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]531<dt class="hdlist1">
Junio C Hamanod2179ef2010-10-22 04:12:17[diff] [blame]532--depth=&lt;n&gt;
Junio C Hamano3eb513f2006-09-18 02:47:16[diff] [blame]533</dt>
534<dd>
535<p>
Junio C Hamano93567a62006-10-08 08:47:56[diff] [blame]536 These two options affect how the objects contained in the pack are
Junio C Hamano3eb513f2006-09-18 02:47:16[diff] [blame]537 stored using delta compression. The objects are first internally
538 sorted by type, size and optionally names and compared against the
539 other objects within <tt>--window</tt> to see if using delta compression saves
540 space. <tt>--depth</tt> limits the maximum delta depth; making it too deep
541 affects the performance on the unpacker side, because delta data needs
542 to be applied that many times to get to the necessary object.
Junio C Hamano91d44c52007-05-09 07:16:07[diff] [blame]543 The default value for --window is 10 and --depth is 50.
Junio C Hamano3eb513f2006-09-18 02:47:16[diff] [blame]544</p>
545</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]546<dt class="hdlist1">
Junio C Hamanod2179ef2010-10-22 04:12:17[diff] [blame]547--window-memory=&lt;n&gt;
Junio C Hamano235d53f2007-07-13 00:25:15[diff] [blame]548</dt>
549<dd>
550<p>
551 This option provides an additional limit on top of <tt>--window</tt>;
552 the window size will dynamically scale down so as to not take
Junio C Hamanod2179ef2010-10-22 04:12:17[diff] [blame]553 up more than <em>&lt;n&gt;</em> bytes in memory. This is useful in
Junio C Hamano235d53f2007-07-13 00:25:15[diff] [blame]554 repositories with a mix of large and small objects to not run
555 out of memory with a large window, but still be able to take
556 advantage of the large window for the smaller objects. The
557 size can be suffixed with "k", "m", or "g".
558 <tt>--window-memory=0</tt> makes memory usage unlimited, which is the
559 default.
560</p>
561</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]562<dt class="hdlist1">
Junio C Hamanod2179ef2010-10-22 04:12:17[diff] [blame]563--max-pack-size=&lt;n&gt;
Junio C Hamano591dc6a2007-05-29 09:18:19[diff] [blame]564</dt>
565<dd>
566<p>
Junio C Hamano4d979582010-02-04 06:27:29[diff] [blame]567 Maximum size of each output pack file. The size can be suffixed with
568 "k", "m", or "g". The minimum size allowed is limited to 1 MiB.
Junio C Hamano591dc6a2007-05-29 09:18:19[diff] [blame]569 If specified, multiple packfiles may be created.
Junio C Hamano4d979582010-02-04 06:27:29[diff] [blame]570 The default is unlimited, unless the config variable
571 <tt>pack.packSizeLimit</tt> is set.
Junio C Hamano591dc6a2007-05-29 09:18:19[diff] [blame]572</p>
573</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]574</dl></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]575</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]576<h2 id="_configuration">Configuration</h2>
Junio C Hamano77b7e902006-10-23 07:18:50[diff] [blame]577<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]578<div class="paragraph"><p>By default, the command passes <tt>--delta-base-offset</tt> option to
Junio C Hamanod3304322010-02-05 03:28:27[diff] [blame]579<em>git pack-objects</em>; this typically results in slightly smaller packs,
580but the generated packs are incompatible with versions of Git older than
581version 1.4.4. If you need to share your repository with such ancient Git
582versions, either directly or via the dumb http or rsync protocol, then you
583need to set the configuration variable <tt>repack.UseDeltaBaseOffset</tt> to
584"false" and repack. Access from old Git versions over the native protocol
585is unaffected by this option as the conversion is performed on the fly
586as needed in that case.</p></div>
Junio C Hamano77b7e902006-10-23 07:18:50[diff] [blame]587</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]588<h2 id="_see_also">SEE ALSO</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]589<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]590<div class="paragraph"><p><a href="git-pack-objects.html">git-pack-objects(1)</a>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]591<a href="git-prune-packed.html">git-prune-packed(1)</a></p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]592</div>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]593<h2 id="_git">GIT</h2>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]594<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]595<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]596</div>
597<div id="footer">
598<div id="footer-text">
Junio C Hamano15567bc2011-07-23 00:51:59[diff] [blame]599Last updated 2011-07-23 00:49:30 UTC
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]600</div>
601</div>
602</body>
603</html>