Autogenerated man pages for v1.2.4-gf61c2
[git.git] / man1 / git-fetch-pack.1
1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
2 .de Sh \" Subsection
3 .br
4 .if t .Sp
5 .ne 5
6 .PP
7 \fB\\$1\fR
8 .PP
9 ..
10 .de Sp \" Vertical space (when we can't use .PP)
11 .if t .sp .5v
12 .if n .sp
13 ..
14 .de Ip \" List item
15 .br
16 .ie \\n(.$>=3 .ne \\$3
17 .el .ne 3
18 .IP "\\$1" \\$2
19 ..
20 .TH "GIT-FETCH-PACK" 1 "" "" ""
21 .SH NAME
22 git-fetch-pack \- Receive missing objects from another repository
23 .SH "SYNOPSIS"
24
25
26 \fIgit\-fetch\-pack\fR [\-q] [\-k] [\-\-exec=<git\-upload\-pack>] [<host>:]<directory> [<refs>...]
27
28 .SH "DESCRIPTION"
29
30
31 Invokes \fIgit\-upload\-pack\fR on a potentially remote repository, and asks it to send objects missing from this repository, to update the named heads\&. The list of commits available locally is found out by scanning local $GIT_DIR/refs/ and sent to \fIgit\-upload\-pack\fR running on the other end\&.
32
33
34 This command degenerates to download everything to complete the asked refs from the remote side when the local side does not have a common ancestor commit\&.
35
36 .SH "OPTIONS"
37
38 .TP
39 \-q
40 Pass \fI\-q\fR flag to \fIgit\-unpack\-objects\fR; this makes the cloning process less verbose\&.
41
42 .TP
43 \-k
44 Do not invoke \fIgit\-unpack\-objects\fR on received data, but create a single packfile out of it instead, and store it in the object database\&.
45
46 .TP
47 \-\-exec=<git\-upload\-pack>
48 Use this to specify the path to \fIgit\-upload\-pack\fR on the remote side, if is not found on your $PATH\&. Installations of sshd ignores the user's environment setup scripts for login shells (e\&.g\&. \&.bash_profile) and your privately installed git may not be found on the system default $PATH\&. Another workaround suggested is to set up your $PATH in "\&.bashrc", but this flag is for people who do not want to pay the overhead for non\-interactive shells by having a lean \&.bashrc file (they set most of the things up in \&.bash_profile)\&.
49
50 .TP
51 <host>
52 A remote host that houses the repository\&. When this part is specified, \fIgit\-upload\-pack\fR is invoked via ssh\&.
53
54 .TP
55 <directory>
56 The repository to sync from\&.
57
58 .TP
59 <refs>...
60 The remote heads to update from\&. This is relative to $GIT_DIR (e\&.g\&. "HEAD", "refs/heads/master")\&. When unspecified, update from all heads the remote side has\&.
61
62 .SH "AUTHOR"
63
64
65 Written by Linus Torvalds <torvalds@osdl\&.org>
66
67 .SH "DOCUMENTATION"
68
69
70 Documentation by Junio C Hamano\&.
71
72 .SH "GIT"
73
74
75 Part of the \fBgit\fR(7) suite
76