projects / thirdparty / git.git / blame
| 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 | -------- | |
| 18bd8821 | 11 | 'git-fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--exec=<git-upload-pack>] [--depth=<n>] [-v] [<host>:]<directory> [<refs>...] |
| 8b3d9dc0 JH |
12 | |
| 13 | DESCRIPTION | |
| 14 | ----------- | |
| 5cb545fa JH |
15 | Usually you would want to use gitlink:git-fetch[1] which is a |
| 16 | higher level wrapper of this command instead. | |
| 17 | ||
| 8b3d9dc0 JH |
18 | Invokes 'git-upload-pack' on a potentially remote repository, |
| 19 | and asks it to send objects missing from this repository, to | |
| 20 | update the named heads. The list of commits available locally | |
| 33b83034 JH |
21 | is found out by scanning local $GIT_DIR/refs/ and sent to |
| 22 | 'git-upload-pack' running on the other end. | |
| 8b3d9dc0 | 23 | |
| 33b83034 JH |
24 | This command degenerates to download everything to complete the |
| 25 | asked refs from the remote side when the local side does not | |
| 26 | have a common ancestor commit. | |
| 8b3d9dc0 JH |
27 | |
| 28 | ||
| 29 | OPTIONS | |
| 30 | ------- | |
| 18bd8821 UKK |
31 | \--all:: |
| 32 | Fetch all remote refs. | |
| 33 | ||
| 34 | \--quiet, \-q:: | |
| 8b3d9dc0 JH |
35 | Pass '-q' flag to 'git-unpack-objects'; this makes the |
| 36 | cloning process less verbose. | |
| 37 | ||
| 18bd8821 | 38 | \--keep, \-k:: |
| ad897215 JH |
39 | Do not invoke 'git-unpack-objects' on received data, but |
| 40 | create a single packfile out of it instead, and store it | |
| da093d37 NP |
41 | in the object database. If provided twice then the pack is |
| 42 | locked against repacking. | |
| ad897215 | 43 | |
| 18bd8821 UKK |
44 | \--thin:: |
| 45 | Spend extra cycles to minimize the number of objects to be sent. | |
| 46 | Use it on slower connection. | |
| 47 | ||
| 48 | \--exec=<git-upload-pack>:: | |
| 8b3d9dc0 JH |
49 | Use this to specify the path to 'git-upload-pack' on the |
| 50 | remote side, if is not found on your $PATH. | |
| 51 | Installations of sshd ignores the user's environment | |
| 52 | setup scripts for login shells (e.g. .bash_profile) and | |
| 72e9340c | 53 | your privately installed git may not be found on the system |
| 8b3d9dc0 JH |
54 | default $PATH. Another workaround suggested is to set |
| 55 | up your $PATH in ".bashrc", but this flag is for people | |
| 56 | who do not want to pay the overhead for non-interactive | |
| 57 | shells by having a lean .bashrc file (they set most of | |
| 58 | the things up in .bash_profile). | |
| 59 | ||
| 18bd8821 UKK |
60 | \--depth=<n>:: |
| 61 | Limit fetching to ancestor-chains not longer than n. | |
| 62 | ||
| 63 | \-v:: | |
| 64 | Run verbosely. | |
| 65 | ||
| 8b3d9dc0 JH |
66 | <host>:: |
| 67 | A remote host that houses the repository. When this | |
| 68 | part is specified, 'git-upload-pack' is invoked via | |
| 69 | ssh. | |
| 70 | ||
| 71 | <directory>:: | |
| 72 | The repository to sync from. | |
| 73 | ||
| 33b83034 | 74 | <refs>...:: |
| 8b3d9dc0 JH |
75 | The remote heads to update from. This is relative to |
| 76 | $GIT_DIR (e.g. "HEAD", "refs/heads/master"). When | |
| 77 | unspecified, update from all heads the remote side has. | |
| 78 | ||
| 8b3d9dc0 JH |
79 | |
| 80 | Author | |
| 81 | ------ | |
| 82 | Written by Linus Torvalds <torvalds@osdl.org> | |
| 83 | ||
| 84 | Documentation | |
| 85 | -------------- | |
| 86 | Documentation by Junio C Hamano. | |
| 87 | ||
| 88 | GIT | |
| 89 | --- | |
| a7154e91 | 90 | Part of the gitlink:git[7] suite |