← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/git-core/intrepid-security

« back to all changes in this revision

Viewing changes to Documentation/git-pack-objects.txt

  • Committer: Package Import Robot
  • Author(s): Gerrit Pape
  • Date: 2007-10-04 08:27:01 UTC
  • mfrom: (1.1.23)
  • Revision ID: package-import@ubuntu.com-20071004082701-rsd058ontoqz4i30
Tags: 1:1.5.3.4-1
http://bugs.debian.org/445188
new upstream point release (closes: #445188).

Show diffs side-by-side

added added

removed removed

Lines of Context:
Documentation/git-pack-objects.txt
25
25
designed to be unpackable without having anything else, but for
26
26
random access, accompanied with the pack index file (.idx).
27
27
 
 
28
Placing both in the pack/ subdirectory of $GIT_OBJECT_DIRECTORY (or
 
29
any of the directories on $GIT_ALTERNATE_OBJECT_DIRECTORIES)
 
30
enables git to read from such an archive.
 
31
 
28
32
'git-unpack-objects' command can read the packed archive and
29
33
expand the objects contained in the pack into "one-file
30
34
one-object" format; this is typically done by the smart-pull
31
35
commands when a pack is created on-the-fly for efficient network
32
36
transport by their peers.
33
37
 
34
 
Placing both in the pack/ subdirectory of $GIT_OBJECT_DIRECTORY (or
35
 
any of the directories on $GIT_ALTERNATE_OBJECT_DIRECTORIES)
36
 
enables git to read from such an archive.
37
 
 
38
38
In a packed archive, an object is either stored as a compressed
39
39
whole, or as a difference from some other object.  The latter is
40
40
often called a delta.
85
85
        times to get to the necessary object.
86
86
        The default value for --window is 10 and --depth is 50.
87
87
 
 
88
--window-memory=[N]::
 
89
        This option provides an additional limit on top of `--window`;
 
90
        the window size will dynamically scale down so as to not take
 
91
        up more than N bytes in memory.  This is useful in
 
92
        repositories with a mix of large and small objects to not run
 
93
        out of memory with a large window, but still be able to take
 
94
        advantage of the large window for the smaller objects.  The
 
95
        size can be suffixed with "k", "m", or "g".
 
96
        `--window-memory=0` makes memory usage unlimited, which is the
 
97
        default.
 
98
 
 
99
--max-pack-size=<n>::
 
100
        Maximum size of each output packfile, expressed in MiB.
 
101
        If specified,  multiple packfiles may be created.
 
102
        The default is unlimited.
 
103
 
88
104
--incremental::
89
105
        This flag causes an object already in a pack ignored
90
106
        even if it appears in the standard input.
127
143
        This flag tells the command not to reuse existing deltas
128
144
        but compute them from scratch.
129
145
 
 
146
--no-reuse-object::
 
147
        This flag tells the command not to reuse existing object data at all,
 
148
        including non deltified object, forcing recompression of everything.
 
149
        This implies --no-reuse-delta. Useful only in the obscure case where
 
150
        wholesale enforcement of a different compression level on the
 
151
        packed data is desired.
 
152
 
 
153
--compression=[N]::
 
154
        Specifies compression level for newly-compressed data in the
 
155
        generated pack.  If not specified,  pack compression level is
 
156
        determined first by pack.compression,  then by core.compression,
 
157
        and defaults to -1,  the zlib default,  if neither is set.
 
158
        Add \--no-reuse-object if you want to force a uniform compression
 
159
        level on all data no matter the source.
 
160
 
130
161
--delta-base-offset::
131
162
        A packed archive can express base object of a delta as
132
163
        either 20-byte object name or as an offset in the
161
192
GIT
162
193
---
163
194
Part of the gitlink:git[7] suite
164