]> git.ipfire.org Git - thirdparty/git.git/blame - Documentation/git-fetch-pack.txt
Merge branch 'maint'
[thirdparty/git.git] / Documentation / git-fetch-pack.txt
CommitLineData
8b3d9dc0
JH
1git-fetch-pack(1)
2=================
8b3d9dc0
JH
3
4NAME
5----
7bd7f280 6git-fetch-pack - Receive missing objects from another repository
8b3d9dc0
JH
7
8
9SYNOPSIS
10--------
bd494fc7 11'git-fetch-pack' [-q] [-k] [--exec=<git-upload-pack>] [<host>:]<directory> [<refs>...]
8b3d9dc0
JH
12
13DESCRIPTION
14-----------
15Invokes 'git-upload-pack' on a potentially remote repository,
16and asks it to send objects missing from this repository, to
17update the named heads. The list of commits available locally
33b83034
JH
18is found out by scanning local $GIT_DIR/refs/ and sent to
19'git-upload-pack' running on the other end.
8b3d9dc0 20
33b83034
JH
21This command degenerates to download everything to complete the
22asked refs from the remote side when the local side does not
23have a common ancestor commit.
8b3d9dc0
JH
24
25
26OPTIONS
27-------
28-q::
29 Pass '-q' flag to 'git-unpack-objects'; this makes the
30 cloning process less verbose.
31
ad897215
JH
32-k::
33 Do not invoke 'git-unpack-objects' on received data, but
34 create a single packfile out of it instead, and store it
da093d37
NP
35 in the object database. If provided twice then the pack is
36 locked against repacking.
ad897215 37
8b3d9dc0
JH
38--exec=<git-upload-pack>::
39 Use this to specify the path to 'git-upload-pack' on the
40 remote side, if is not found on your $PATH.
41 Installations of sshd ignores the user's environment
42 setup scripts for login shells (e.g. .bash_profile) and
72e9340c 43 your privately installed git may not be found on the system
8b3d9dc0
JH
44 default $PATH. Another workaround suggested is to set
45 up your $PATH in ".bashrc", but this flag is for people
46 who do not want to pay the overhead for non-interactive
47 shells by having a lean .bashrc file (they set most of
48 the things up in .bash_profile).
49
50<host>::
51 A remote host that houses the repository. When this
52 part is specified, 'git-upload-pack' is invoked via
53 ssh.
54
55<directory>::
56 The repository to sync from.
57
33b83034 58<refs>...::
8b3d9dc0
JH
59 The remote heads to update from. This is relative to
60 $GIT_DIR (e.g. "HEAD", "refs/heads/master"). When
61 unspecified, update from all heads the remote side has.
62
8b3d9dc0
JH
63
64Author
65------
66Written by Linus Torvalds <torvalds@osdl.org>
67
68Documentation
69--------------
70Documentation by Junio C Hamano.
71
72GIT
73---
a7154e91 74Part of the gitlink:git[7] suite