Google Git
Sign in
chromium / external / gitster / git-htmldocs / b968dbbd6a939fc1282a7837026e131ed921e122 / . / git-fetch-pack.html
blob: 25a62e4319d25594cbbb749e8d4c885a9b94d0c4 [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 Hamano2bb13102006-03-06 07:10:21[diff] [blame]6<meta name="generator" content="AsciiDoc 7.0.2" />
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]7<style type="text/css">
8/* Debug borders */
9p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
10/*
11 border: 1px solid red;
12*/
13}
14
15body {
16 margin: 1em 5% 1em 5%;
17}
18
19a { color: blue; }
20a:visited { color: fuchsia; }
21
22em {
23 font-style: italic;
24}
25
26strong {
27 font-weight: bold;
28}
29
30tt {
31 color: navy;
32}
33
34h1, h2, h3, h4, h5, h6 {
35 color: #527bbd;
36 font-family: sans-serif;
37 margin-top: 1.2em;
38 margin-bottom: 0.5em;
39 line-height: 1.3;
40}
41
42h1 {
43 border-bottom: 2px solid silver;
44}
45h2 {
46 border-bottom: 2px solid silver;
47 padding-top: 0.5em;
48}
49
50div.sectionbody {
51 font-family: serif;
52 margin-left: 0;
53}
54
55hr {
56 border: 1px solid silver;
57}
58
59p {
60 margin-top: 0.5em;
61 margin-bottom: 0.5em;
62}
63
64pre {
65 padding: 0;
66 margin: 0;
67}
68
69span#author {
70 color: #527bbd;
71 font-family: sans-serif;
72 font-weight: bold;
73 font-size: 1.2em;
74}
75span#email {
76}
77span#revision {
78 font-family: sans-serif;
79}
80
81div#footer {
82 font-family: sans-serif;
83 font-size: small;
84 border-top: 2px solid silver;
85 padding-top: 0.5em;
86 margin-top: 4.0em;
87}
88div#footer-text {
89 float: left;
90 padding-bottom: 0.5em;
91}
92div#footer-badges {
93 float: right;
94 padding-bottom: 0.5em;
95}
96
97div#preamble,
98div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
99div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
100div.admonitionblock {
101 margin-right: 10%;
102 margin-top: 1.5em;
103 margin-bottom: 1.5em;
104}
105div.admonitionblock {
106 margin-top: 2.5em;
107 margin-bottom: 2.5em;
108}
109
110div.content { /* Block element content. */
111 padding: 0;
112}
113
114/* Block element titles. */
115div.title, caption.title {
116 font-family: sans-serif;
117 font-weight: bold;
118 text-align: left;
119 margin-top: 1.0em;
120 margin-bottom: 0.5em;
121}
122div.title + * {
123 margin-top: 0;
124}
125
126td div.title:first-child {
127 margin-top: 0.0em;
128}
129div.content div.title:first-child {
130 margin-top: 0.0em;
131}
132div.content + div.title {
133 margin-top: 0.0em;
134}
135
136div.sidebarblock > div.content {
137 background: #ffffee;
138 border: 1px solid silver;
139 padding: 0.5em;
140}
141
142div.listingblock > div.content {
143 border: 1px solid silver;
144 background: #f4f4f4;
145 padding: 0.5em;
146}
147
148div.quoteblock > div.content {
149 padding-left: 2.0em;
150}
151div.quoteblock .attribution {
152 text-align: right;
153}
154
155div.admonitionblock .icon {
156 vertical-align: top;
157 font-size: 1.1em;
158 font-weight: bold;
159 text-decoration: underline;
160 color: #527bbd;
161 padding-right: 0.5em;
162}
163div.admonitionblock td.content {
164 padding-left: 0.5em;
165 border-left: 2px solid silver;
166}
167
168div.exampleblock > div.content {
169 border-left: 2px solid silver;
170 padding: 0.5em;
171}
172
173div.verseblock div.content {
174 white-space: pre;
175}
176
177div.imageblock div.content { padding-left: 0; }
178div.imageblock img { border: 1px solid silver; }
179span.image img { border-style: none; }
180
181dl {
182 margin-top: 0.8em;
183 margin-bottom: 0.8em;
184}
185dt {
186 margin-top: 0.5em;
187 margin-bottom: 0;
188 font-style: italic;
189}
190dd > *:first-child {
191 margin-top: 0;
192}
193
194ul, ol {
195 list-style-position: outside;
196}
197ol.olist2 {
198 list-style-type: lower-alpha;
199}
200
201div.tableblock > table {
202 border-color: #527bbd;
203 border-width: 3px;
204}
205thead {
206 font-family: sans-serif;
207 font-weight: bold;
208}
209tfoot {
210 font-weight: bold;
211}
212
213div.hlist {
214 margin-top: 0.8em;
215 margin-bottom: 0.8em;
216}
217td.hlist1 {
218 vertical-align: top;
219 font-style: italic;
220 padding-right: 0.8em;
221}
222td.hlist2 {
223 vertical-align: top;
224}
225
226@media print {
227 div#footer-badges { display: none; }
228}
229include::./stylesheets/xhtml11-manpage.css[]
230/* Workarounds for IE6's broken and incomplete CSS2. */
231
232div.sidebar-content {
233 background: #ffffee;
234 border: 1px solid silver;
235 padding: 0.5em;
236}
237div.sidebar-title, div.image-title {
238 font-family: sans-serif;
239 font-weight: bold;
240 margin-top: 0.0em;
241 margin-bottom: 0.5em;
242}
243
244div.listingblock div.content {
245 border: 1px solid silver;
246 background: #f4f4f4;
247 padding: 0.5em;
248}
249
250div.quoteblock-content {
251 padding-left: 2.0em;
252}
253
254div.exampleblock-content {
255 border-left: 2px solid silver;
256 padding-left: 0.5em;
257}
258</style>
259<title>git-fetch-pack(1)</title>
260</head>
261<body>
262<div id="header">
263<h1>
264git-fetch-pack(1) Manual Page
265</h1>
266<h2>NAME</h2>
267<div class="sectionbody">
268<p>git-fetch-pack -
Junio C Hamano01078922006-03-10 00:31:47[diff] [blame]269 Receive missing objects from another repository
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]270</p>
271</div>
272</div>
273<h2>SYNOPSIS</h2>
274<div class="sectionbody">
Junio C Hamanoaa83a7d2007-03-05 02:37:29[diff] [blame]275<p><em>git-fetch-pack</em> [--all] [--quiet|-q] [--keep|-k] [--thin] [--upload-pack=&lt;git-upload-pack&gt;] [--depth=&lt;n&gt;] [--no-progress] [-v] [&lt;host&gt;:]&lt;directory&gt; [&lt;refs&gt;&#8230;]</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]276</div>
277<h2>DESCRIPTION</h2>
278<div class="sectionbody">
Junio C Hamanoe58607f2007-01-17 23:27:45[diff] [blame]279<p>Usually you would want to use <a href="git-fetch.html">git-fetch(1)</a> which is a
280higher level wrapper of this command instead.</p>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]281<p>Invokes <em>git-upload-pack</em> on a potentially remote repository,
282and asks it to send objects missing from this repository, to
283update the named heads. The list of commits available locally
284is found out by scanning local $GIT_DIR/refs/ and sent to
285<em>git-upload-pack</em> running on the other end.</p>
286<p>This command degenerates to download everything to complete the
287asked refs from the remote side when the local side does not
288have a common ancestor commit.</p>
289</div>
290<h2>OPTIONS</h2>
291<div class="sectionbody">
292<dl>
293<dt>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]294--all
295</dt>
296<dd>
297<p>
298 Fetch all remote refs.
299</p>
300</dd>
301<dt>
302--quiet, \-q
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]303</dt>
304<dd>
305<p>
306 Pass <em>-q</em> flag to <em>git-unpack-objects</em>; this makes the
307 cloning process less verbose.
308</p>
309</dd>
310<dt>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]311--keep, \-k
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]312</dt>
313<dd>
314<p>
315 Do not invoke <em>git-unpack-objects</em> on received data, but
316 create a single packfile out of it instead, and store it
Junio C Hamano0d3c8152006-11-08 01:33:41[diff] [blame]317 in the object database. If provided twice then the pack is
318 locked against repacking.
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]319</p>
320</dd>
321<dt>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]322--thin
323</dt>
324<dd>
325<p>
326 Spend extra cycles to minimize the number of objects to be sent.
327 Use it on slower connection.
328</p>
329</dd>
330<dt>
Junio C Hamanofa0d4cf2007-01-25 02:23:58[diff] [blame]331--upload-pack=&lt;git-upload-pack&gt;
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]332</dt>
333<dd>
334<p>
335 Use this to specify the path to <em>git-upload-pack</em> on the
336 remote side, if is not found on your $PATH.
337 Installations of sshd ignores the user's environment
338 setup scripts for login shells (e.g. .bash_profile) and
339 your privately installed git may not be found on the system
340 default $PATH. Another workaround suggested is to set
341 up your $PATH in ".bashrc", but this flag is for people
342 who do not want to pay the overhead for non-interactive
343 shells by having a lean .bashrc file (they set most of
344 the things up in .bash_profile).
345</p>
346</dd>
347<dt>
Junio C Hamanofa0d4cf2007-01-25 02:23:58[diff] [blame]348--exec=&lt;git-upload-pack&gt;
349</dt>
350<dd>
351<p>
352 Same as --upload-pack=&lt;git-upload-pack&gt;.
353</p>
354</dd>
355<dt>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]356--depth=&lt;n&gt;
357</dt>
358<dd>
359<p>
360 Limit fetching to ancestor-chains not longer than n.
361</p>
362</dd>
363<dt>
Junio C Hamanoaa83a7d2007-03-05 02:37:29[diff] [blame]364--no-progress
365</dt>
366<dd>
367<p>
368 Do not show the progress.
369</p>
370</dd>
371<dt>
Junio C Hamano4ad294b2007-01-20 02:22:50[diff] [blame]372\-v
373</dt>
374<dd>
375<p>
376 Run verbosely.
377</p>
378</dd>
379<dt>
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]380&lt;host&gt;
381</dt>
382<dd>
383<p>
384 A remote host that houses the repository. When this
385 part is specified, <em>git-upload-pack</em> is invoked via
386 ssh.
387</p>
388</dd>
389<dt>
390&lt;directory&gt;
391</dt>
392<dd>
393<p>
394 The repository to sync from.
395</p>
396</dd>
397<dt>
398&lt;refs&gt;&#8230;
399</dt>
400<dd>
401<p>
402 The remote heads to update from. This is relative to
403 $GIT_DIR (e.g. "HEAD", "refs/heads/master"). When
404 unspecified, update from all heads the remote side has.
405</p>
406</dd>
407</dl>
408</div>
409<h2>Author</h2>
410<div class="sectionbody">
411<p>Written by Linus Torvalds &lt;torvalds@osdl.org&gt;</p>
412</div>
413<h2>Documentation</h2>
414<div class="sectionbody">
415<p>Documentation by Junio C Hamano.</p>
416</div>
417<h2>GIT</h2>
418<div class="sectionbody">
419<p>Part of the <a href="git.html">git(7)</a> suite</p>
420</div>
421<div id="footer">
422<div id="footer-text">
Junio C Hamanobb6e0782007-07-19 02:14:50[diff] [blame]423Last updated 19-Jul-2007 02:09:39 UTC
Junio C Hamano1a4e8412005-12-27 08:17:23[diff] [blame]424</div>
425</div>
426</body>
427</html>