Documentation / git-fetch-pack.txton commit Update documentation of fetch-pack, push and send-pack (18bd882)
   1git-fetch-pack(1)
   2=================
   3
   4NAME
   5----
   6git-fetch-pack - Receive missing objects from another repository
   7
   8
   9SYNOPSIS
  10--------
  11'git-fetch-pack' [--all] [--quiet|-q] [--keep|-k] [--thin] [--exec=<git-upload-pack>] [--depth=<n>] [-v] [<host>:]<directory> [<refs>...]
  12
  13DESCRIPTION
  14-----------
  15Usually you would want to use gitlink:git-fetch[1] which is a
  16higher level wrapper of this command instead.
  17
  18Invokes 'git-upload-pack' on a potentially remote repository,
  19and asks it to send objects missing from this repository, to
  20update the named heads.  The list of commits available locally
  21is found out by scanning local $GIT_DIR/refs/ and sent to
  22'git-upload-pack' running on the other end.
  23
  24This command degenerates to download everything to complete the
  25asked refs from the remote side when the local side does not
  26have a common ancestor commit.
  27
  28
  29OPTIONS
  30-------
  31\--all::
  32        Fetch all remote refs.
  33
  34\--quiet, \-q::
  35        Pass '-q' flag to 'git-unpack-objects'; this makes the
  36        cloning process less verbose.
  37
  38\--keep, \-k::
  39        Do not invoke 'git-unpack-objects' on received data, but
  40        create a single packfile out of it instead, and store it
  41        in the object database. If provided twice then the pack is
  42        locked against repacking.
  43
  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>::
  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
  53        your privately installed git may not be found on the system
  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
  60\--depth=<n>::
  61        Limit fetching to ancestor-chains not longer than n.
  62
  63\-v::
  64        Run verbosely.
  65
  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
  74<refs>...::
  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
  79
  80Author
  81------
  82Written by Linus Torvalds <torvalds@osdl.org>
  83
  84Documentation
  85--------------
  86Documentation by Junio C Hamano.
  87
  88GIT
  89---
  90Part of the gitlink:git[7] suite