2005-07-14 15:08:37 +08:00
|
|
|
git-fetch-pack(1)
|
|
|
|
=================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2006-03-10 00:24:50 +08:00
|
|
|
git-fetch-pack - Receive missing objects from another repository
|
2005-07-14 15:08:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2008-06-30 14:09:04 +08:00
|
|
|
'git fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag] [--upload-pack=<git-upload-pack>] [--depth=<n>] [--no-progress] [-v] [<host>:]<directory> [<refs>...]
|
2005-07-14 15:08:37 +08:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2010-01-10 07:33:00 +08:00
|
|
|
Usually you would want to use 'git fetch', which is a
|
2008-07-01 02:56:34 +08:00
|
|
|
higher level wrapper of this command, instead.
|
2007-01-18 05:03:29 +08:00
|
|
|
|
2008-07-03 13:41:41 +08:00
|
|
|
Invokes 'git-upload-pack' on a possibly remote repository
|
2005-07-14 15:08:37 +08:00
|
|
|
and asks it to send objects missing from this repository, to
|
|
|
|
update the named heads. The list of commits available locally
|
docs: don't talk about $GIT_DIR/refs/ everywhere
It is misleading to say that we pull refs from $GIT_DIR/refs/*, because we
may also consult the packed refs mechanism. These days we tend to treat
the "refs hierarchy" as more of an abstract namespace that happens to be
represented as $GIT_DIR/refs. At best, this is a minor inaccuracy, but at
worst it can confuse users who then look in $GIT_DIR/refs and find that it
is missing some of the refs they expected to see.
This patch drops most uses of "$GIT_DIR/refs/*", changing them into just
"refs/*", under the assumption that users can handle the concept of an
abstract refs namespace. There are a few things to note:
- most cases just dropped the $GIT_DIR/ portion. But for cases where
that left _just_ the word "refs", I changed it to "refs/" to help
indicate that it was a hierarchy. I didn't do the same for longer
paths (e.g., "refs/heads" remained, instead of becoming
"refs/heads/").
- in some cases, no change was made, as the text was explicitly about
unpacked refs (e.g., the discussion in git-pack-refs).
- In some cases it made sense instead to note the existence of packed
refs (e.g., in check-ref-format and rev-parse).
Signed-off-by: Jeff King <peff@peff.net>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2010-02-18 09:16:20 +08:00
|
|
|
is found out by scanning the local refs/ hierarchy and sent to
|
2008-07-03 13:41:41 +08:00
|
|
|
'git-upload-pack' running on the other end.
|
2005-07-14 15:08:37 +08:00
|
|
|
|
2005-08-12 17:08:29 +08:00
|
|
|
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.
|
2005-07-14 15:08:37 +08:00
|
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
2008-06-08 09:36:09 +08:00
|
|
|
--all::
|
2007-01-19 20:43:00 +08:00
|
|
|
Fetch all remote refs.
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
-q::
|
|
|
|
--quiet::
|
2010-01-10 07:33:00 +08:00
|
|
|
Pass '-q' flag to 'git unpack-objects'; this makes the
|
2005-07-14 15:08:37 +08:00
|
|
|
cloning process less verbose.
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
-k::
|
|
|
|
--keep::
|
2010-01-10 07:33:00 +08:00
|
|
|
Do not invoke 'git unpack-objects' on received data, but
|
2005-12-15 14:17:38 +08:00
|
|
|
create a single packfile out of it instead, and store it
|
2006-11-02 06:06:23 +08:00
|
|
|
in the object database. If provided twice then the pack is
|
|
|
|
locked against repacking.
|
2005-12-15 14:17:38 +08:00
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
--thin::
|
2010-02-18 17:10:28 +08:00
|
|
|
Fetch a "thin" pack, which records objects in deltified form based
|
|
|
|
on objects not included in the pack to reduce network traffic.
|
2007-01-19 20:43:00 +08:00
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
--include-tag::
|
2008-03-04 11:27:33 +08:00
|
|
|
If the remote side supports it, annotated tags objects will
|
|
|
|
be downloaded on the same connection as the other objects if
|
|
|
|
the object the tag references is downloaded. The caller must
|
|
|
|
otherwise determine the tags this option made available.
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
--upload-pack=<git-upload-pack>::
|
2008-07-03 13:41:41 +08:00
|
|
|
Use this to specify the path to 'git-upload-pack' on the
|
2005-07-14 15:08:37 +08:00
|
|
|
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
|
2005-10-11 07:01:31 +08:00
|
|
|
your privately installed git may not be found on the system
|
2005-07-14 15:08:37 +08:00
|
|
|
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).
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
--exec=<git-upload-pack>::
|
2007-01-23 16:20:17 +08:00
|
|
|
Same as \--upload-pack=<git-upload-pack>.
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
--depth=<n>::
|
2007-01-19 20:43:00 +08:00
|
|
|
Limit fetching to ancestor-chains not longer than n.
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
--no-progress::
|
2007-02-20 10:01:44 +08:00
|
|
|
Do not show the progress.
|
|
|
|
|
2008-06-08 09:36:09 +08:00
|
|
|
-v::
|
2007-01-19 20:43:00 +08:00
|
|
|
Run verbosely.
|
|
|
|
|
2005-07-14 15:08:37 +08:00
|
|
|
<host>::
|
|
|
|
A remote host that houses the repository. When this
|
2008-07-03 13:41:41 +08:00
|
|
|
part is specified, 'git-upload-pack' is invoked via
|
2005-07-14 15:08:37 +08:00
|
|
|
ssh.
|
|
|
|
|
|
|
|
<directory>::
|
|
|
|
The repository to sync from.
|
|
|
|
|
2005-08-12 17:08:29 +08:00
|
|
|
<refs>...::
|
2005-07-14 15:08:37 +08:00
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
Author
|
|
|
|
------
|
|
|
|
Written by Linus Torvalds <torvalds@osdl.org>
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
--------------
|
|
|
|
Documentation by Junio C Hamano.
|
|
|
|
|
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 15:07:32 +08:00
|
|
|
Part of the linkgit:git[1] suite
|