]>
Commit | Line | Data |
---|---|---|
8b3d9dc0 JH |
1 | git-fetch-pack(1) |
2 | ================= | |
8b3d9dc0 JH |
3 | |
4 | NAME | |
5 | ---- | |
7bd7f280 | 6 | git-fetch-pack - Receive missing objects from another repository |
8b3d9dc0 JH |
7 | |
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
7791a1d9 | 11 | [verse] |
b1889c36 | 12 | 'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] [--upload-pack=<git-upload-pack>] [--depth=<n>] [--no-progress] [-v] [<host>:]<directory> [<refs>...] |
8b3d9dc0 JH |
13 | |
14 | DESCRIPTION | |
15 | ----------- | |
0b444cdb | 16 | Usually you would want to use 'git fetch', which is a |
483bc4f0 | 17 | higher level wrapper of this command, instead. |
5cb545fa | 18 | |
ba020ef5 | 19 | Invokes 'git-upload-pack' on a possibly remote repository |
8b3d9dc0 JH |
20 | and asks it to send objects missing from this repository, to |
21 | update the named heads. The list of commits available locally | |
cc1b8d8b | 22 | is found out by scanning the local refs/ hierarchy and sent to |
ba020ef5 | 23 | 'git-upload-pack' running on the other end. |
8b3d9dc0 | 24 | |
33b83034 JH |
25 | This command degenerates to download everything to complete the |
26 | asked refs from the remote side when the local side does not | |
27 | have a common ancestor commit. | |
8b3d9dc0 JH |
28 | |
29 | ||
30 | OPTIONS | |
31 | ------- | |
3240240f | 32 | --all:: |
18bd8821 UKK |
33 | Fetch all remote refs. |
34 | ||
3240240f SB |
35 | -q:: |
36 | --quiet:: | |
0b444cdb | 37 | Pass '-q' flag to 'git unpack-objects'; this makes the |
8b3d9dc0 JH |
38 | cloning process less verbose. |
39 | ||
3240240f SB |
40 | -k:: |
41 | --keep:: | |
0b444cdb | 42 | Do not invoke 'git unpack-objects' on received data, but |
ad897215 | 43 | create a single packfile out of it instead, and store it |
da093d37 NP |
44 | in the object database. If provided twice then the pack is |
45 | locked against repacking. | |
ad897215 | 46 | |
3240240f | 47 | --thin:: |
738820a9 SB |
48 | Fetch a "thin" pack, which records objects in deltified form based |
49 | on objects not included in the pack to reduce network traffic. | |
18bd8821 | 50 | |
3240240f | 51 | --include-tag:: |
348e390b SP |
52 | If the remote side supports it, annotated tags objects will |
53 | be downloaded on the same connection as the other objects if | |
54 | the object the tag references is downloaded. The caller must | |
55 | otherwise determine the tags this option made available. | |
56 | ||
3240240f | 57 | --upload-pack=<git-upload-pack>:: |
ba020ef5 | 58 | Use this to specify the path to 'git-upload-pack' on the |
8b3d9dc0 JH |
59 | remote side, if is not found on your $PATH. |
60 | Installations of sshd ignores the user's environment | |
61 | setup scripts for login shells (e.g. .bash_profile) and | |
72e9340c | 62 | your privately installed git may not be found on the system |
8b3d9dc0 JH |
63 | default $PATH. Another workaround suggested is to set |
64 | up your $PATH in ".bashrc", but this flag is for people | |
65 | who do not want to pay the overhead for non-interactive | |
66 | shells by having a lean .bashrc file (they set most of | |
67 | the things up in .bash_profile). | |
68 | ||
3240240f | 69 | --exec=<git-upload-pack>:: |
27dca07f UKK |
70 | Same as \--upload-pack=<git-upload-pack>. |
71 | ||
3240240f | 72 | --depth=<n>:: |
18bd8821 UKK |
73 | Limit fetching to ancestor-chains not longer than n. |
74 | ||
3240240f | 75 | --no-progress:: |
83a5ad61 JS |
76 | Do not show the progress. |
77 | ||
3240240f | 78 | -v:: |
18bd8821 UKK |
79 | Run verbosely. |
80 | ||
8b3d9dc0 JH |
81 | <host>:: |
82 | A remote host that houses the repository. When this | |
ba020ef5 | 83 | part is specified, 'git-upload-pack' is invoked via |
8b3d9dc0 JH |
84 | ssh. |
85 | ||
86 | <directory>:: | |
87 | The repository to sync from. | |
88 | ||
33b83034 | 89 | <refs>...:: |
8b3d9dc0 JH |
90 | The remote heads to update from. This is relative to |
91 | $GIT_DIR (e.g. "HEAD", "refs/heads/master"). When | |
92 | unspecified, update from all heads the remote side has. | |
93 | ||
8b3d9dc0 JH |
94 | GIT |
95 | --- | |
9e1f0a85 | 96 | Part of the linkgit:git[1] suite |