Documentation / git-fetch-pack.txton commit Documentation: suggest corresponding Porcelain-level in plumbing docs. (5cb545f)
   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' [-q] [-k] [--exec=<git-upload-pack>] [<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-q::
  32        Pass '-q' flag to 'git-unpack-objects'; this makes the
  33        cloning process less verbose.
  34
  35-k::
  36        Do not invoke 'git-unpack-objects' on received data, but
  37        create a single packfile out of it instead, and store it
  38        in the object database. If provided twice then the pack is
  39        locked against repacking.
  40
  41--exec=<git-upload-pack>::
  42        Use this to specify the path to 'git-upload-pack' on the
  43        remote side, if is not found on your $PATH.
  44        Installations of sshd ignores the user's environment
  45        setup scripts for login shells (e.g. .bash_profile) and
  46        your privately installed git may not be found on the system
  47        default $PATH.  Another workaround suggested is to set
  48        up your $PATH in ".bashrc", but this flag is for people
  49        who do not want to pay the overhead for non-interactive
  50        shells by having a lean .bashrc file (they set most of
  51        the things up in .bash_profile).
  52
  53<host>::
  54        A remote host that houses the repository.  When this
  55        part is specified, 'git-upload-pack' is invoked via
  56        ssh.
  57
  58<directory>::
  59        The repository to sync from.
  60
  61<refs>...::
  62        The remote heads to update from. This is relative to
  63        $GIT_DIR (e.g. "HEAD", "refs/heads/master").  When
  64        unspecified, update from all heads the remote side has.
  65
  66
  67Author
  68------
  69Written by Linus Torvalds <torvalds@osdl.org>
  70
  71Documentation
  72--------------
  73Documentation by Junio C Hamano.
  74
  75GIT
  76---
  77Part of the gitlink:git[7] suite