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">
5 <meta http-equiv=
"Content-Type" content=
"text/html; charset=UTF-8" />
6 <meta name=
"generator" content=
"AsciiDoc 8.4.5" />
7 <title>git-repack(
1)
</title>
8 <style type=
"text/css">
10 p
, li
, dt
, dd
, div
, pre
, h1
, h2
, h3
, h4
, h5
, h6
{
12 border: 1px solid red;
17 margin: 1em 5% 1em 5%;
22 text-decoration: underline
;
42 h1
, h2
, h3
, h4
, h5
, h6
{
44 font-family: sans-serif
;
51 border-bottom: 2px solid silver
;
69 border: 1px solid silver
;
88 font-family: sans-serif
;
94 span#revnumber
, span#revdate
, span#revremark
{
95 font-family: sans-serif
;
99 font-family: sans-serif
;
101 border-top: 2px solid silver
;
107 padding-bottom: 0.5em;
111 padding-bottom: 0.5em;
116 margin-bottom: 1.5em;
118 div
.tableblock
, div
.imageblock
, div
.exampleblock
, div
.verseblock
,
119 div
.quoteblock
, div
.literalblock
, div
.listingblock
, div
.sidebarblock
,
120 div
.admonitionblock
{
122 margin-bottom: 1.5em;
124 div
.admonitionblock
{
126 margin-bottom: 2.5em;
129 div
.content
{ /* Block element content. */
133 /* Block element titles. */
134 div
.title
, caption
.title
{
136 font-family: sans-serif
;
140 margin-bottom: 0.5em;
146 td div
.title:first-child
{
149 div
.content div
.title:first-child
{
152 div
.content
+ div
.title
{
156 div
.sidebarblock
> div
.content
{
158 border: 1px solid silver
;
162 div
.listingblock
> div
.content
{
163 border: 1px solid silver
;
172 div
.quoteblock
> div
.attribution
{
181 div
.verseblock
> div
.content
{
184 div
.verseblock
> div
.attribution
{
188 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
189 div
.verseblock
+ div
.attribution
{
193 div
.admonitionblock
.icon
{
197 text-decoration: underline
;
199 padding-right: 0.5em;
201 div
.admonitionblock td
.content
{
203 border-left: 2px solid silver
;
206 div
.exampleblock
> div
.content
{
207 border-left: 2px solid silver
;
211 div
.imageblock div
.content
{ padding-left: 0; }
212 span
.image img
{ border-style: none
; }
213 a
.image:visited
{ color: white
; }
217 margin-bottom: 0.8em;
230 list-style-position: outside
;
233 list-style-type: decimal
;
236 list-style-type: lower-alpha
;
239 list-style-type: upper-alpha
;
242 list-style-type: lower-roman
;
245 list-style-type: upper-roman
;
248 div
.compact ul
, div
.compact ol
,
249 div
.compact p
, div
.compact p
,
250 div
.compact div
, div
.compact div
{
252 margin-bottom: 0.1em;
255 div
.tableblock
> table
{
256 border: 3px solid
#527bbd;
259 font-family: sans-serif
;
271 /* Because the table frame attribute is overriden by CSS in most browsers. */
272 div
.tableblock
> table
[frame
="void"] {
275 div
.tableblock
> table
[frame
="hsides"] {
276 border-left-style: none
;
277 border-right-style: none
;
279 div
.tableblock
> table
[frame
="vsides"] {
280 border-top-style: none
;
281 border-bottom-style: none
;
287 margin-bottom: 0.8em;
290 padding-bottom: 15px;
292 dt
.hdlist1
.strong
, td
.hdlist1
.strong
{
298 padding-right: 0.8em;
304 div
.hdlist
.compact tr
{
314 div#footer-badges
{ display: none
; }
319 font-family: sans-serif
;
323 margin-bottom: 0.1em;
326 div
.toclevel1
, div
.toclevel2
, div
.toclevel3
, div
.toclevel4
{
342 /* Overrides for manpage documents */
345 padding-bottom: 0.5em;
346 border-top: 2px solid silver
;
347 border-bottom: 2px solid silver
;
357 div#toc
{ display: none
; }
360 /* Workarounds for IE6's broken and incomplete CSS2. */
362 div
.sidebar-content
{
364 border: 1px solid silver
;
367 div
.sidebar-title
, div
.image-title
{
369 font-family: sans-serif
;
372 margin-bottom: 0.5em;
375 div
.listingblock div
.content
{
376 border: 1px solid silver
;
381 div
.quoteblock-attribution
{
386 div
.verseblock-content
{
389 div
.verseblock-attribution
{
394 div
.exampleblock-content
{
395 border-left: 2px solid silver
;
399 /* IE6 sets dynamically generated links as visited. */
400 div#toc
a:visited
{ color: blue
; }
406 git-repack(
1) Manual Page
409 <div class=
"sectionbody">
411 Pack unpacked objects in a repository
415 <h2 id=
"_synopsis">SYNOPSIS
</h2>
416 <div class=
"sectionbody">
417 <div class=
"verseblock">
418 <div class=
"verseblock-content"><em>git repack
</em> [-a] [-A] [-d] [-f] [-F] [-l] [-n] [-q] [--window=
<n
>] [--depth=
<n
>]
</div>
419 <div class=
"verseblock-attribution">
422 <h2 id=
"_description">DESCRIPTION
</h2>
423 <div class=
"sectionbody">
424 <div class=
"paragraph"><p>This script is used to combine all objects that do not currently
425 reside in a
"pack", into a pack. It can also be used to re-organize
426 existing packs into a single, more efficient pack.
</p></div>
427 <div class=
"paragraph"><p>A pack is a collection of objects, individually compressed, with
428 delta compression applied, stored in a single file, with an
429 associated index file.
</p></div>
430 <div class=
"paragraph"><p>Packs are used to reduce the load on mirror systems, backup
431 engines, disk storage, etc.
</p></div>
433 <h2 id=
"_options">OPTIONS
</h2>
434 <div class=
"sectionbody">
435 <div class=
"dlist"><dl>
441 Instead of incrementally packing the unpacked objects,
442 pack everything referenced into a single pack.
443 Especially useful when packing a repository that is used
444 for private development. Use
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
449 <div class=
"paragraph"><p>Note that users fetching over dumb protocols will have to fetch the
450 whole new pack in order to get any contained object, no matter how many
451 other objects in that pack they already have locally.
</p></div>
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
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
466 with the next
<em>git gc
</em> invocation. See
<a href=
"git-gc.html">git-gc(
1)
</a>.
474 After packing, if the newly created packs make some
475 existing packs redundant, remove the redundant packs.
476 Also run
<em>git prune-packed
</em> to remove redundant
485 Pass the
<tt>--local
</tt> option to
<em>git pack-objects
</em>. See
486 <a href=
"git-pack-objects.html">git-pack-objects(
1)
</a>.
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>.
503 Pass the
<tt>--no-reuse-object
</tt> option to
<tt>git-pack-objects
</tt>, see
504 <a href=
"git-pack-objects.html">git-pack-objects(
1)
</a>.
512 Pass the
<tt>-q
</tt> option to
<em>git pack-objects
</em>. See
513 <a href=
"git-pack-objects.html">git-pack-objects(
1)
</a>.
521 Do not update the server information with
522 <em>git update-server-info
</em>. This option skips
523 updating local catalog files needed to publish
524 this repository (or a direct copy of it)
525 over HTTP or FTP. See
<a href=
"git-update-server-info.html">git-update-server-info(
1)
</a>.
536 These two options affect how the objects contained in the pack are
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.
543 The default value for --window is
10 and --depth is
50.
547 --window-memory=
<n
>
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
553 up more than
<em><n
></em> bytes in memory. This is useful in
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
563 --max-pack-size=
<n
>
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.
569 If specified, multiple packfiles may be created.
570 The default is unlimited, unless the config variable
571 <tt>pack.packSizeLimit
</tt> is set.
576 <h2 id=
"_configuration">Configuration
</h2>
577 <div class=
"sectionbody">
578 <div class=
"paragraph"><p>By default, the command passes
<tt>--delta-base-offset
</tt> option to
579 <em>git pack-objects
</em>; this typically results in slightly smaller packs,
580 but the generated packs are incompatible with versions of Git older than
581 version
1.4.4. If you need to share your repository with such ancient Git
582 versions, either directly or via the dumb http or rsync protocol, then you
583 need to set the configuration variable
<tt>repack.UseDeltaBaseOffset
</tt> to
584 "false" and repack. Access from old Git versions over the native protocol
585 is unaffected by this option as the conversion is performed on the fly
586 as needed in that case.
</p></div>
588 <h2 id=
"_see_also">SEE ALSO
</h2>
589 <div class=
"sectionbody">
590 <div class=
"paragraph"><p><a href=
"git-pack-objects.html">git-pack-objects(
1)
</a>
591 <a href=
"git-prune-packed.html">git-prune-packed(
1)
</a></p></div>
593 <h2 id=
"_git">GIT
</h2>
594 <div class=
"sectionbody">
595 <div class=
"paragraph"><p>Part of the
<a href=
"git.html">git(
1)
</a> suite
</p></div>
598 <div id=
"footer-text">
599 Last updated
2011-
07-
23 00:
49:
30 UTC