man1/git-fetch-pack.1

   1 '\" t
   2 .\"     Title: git-fetch-pack
   3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
   4 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
   5 .\"      Date: 01/17/2023
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.39.1.231.ga7caae2729
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-FETCH\-PACK" "1" "01/17/2023" "Git 2\&.39\&.1\&.231\&.ga7caae" "Git Manual"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 git-fetch-pack \- Receive missing objects from another repository
  32 .SH "SYNOPSIS"
  33 .sp
  34 .nf
  35 \fIgit fetch\-pack\fR [\-\-all] [\-\-quiet|\-q] [\-\-keep|\-k] [\-\-thin] [\-\-include\-tag]
  36         [\-\-upload\-pack=<git\-upload\-pack>]
  37         [\-\-depth=<n>] [\-\-no\-progress]
  38         [\-v] <repository> [<refs>\&...]
  39 .fi
  40 .sp
  41 .SH "DESCRIPTION"
  42 .sp
  43 Usually you would want to use \fIgit fetch\fR, which is a higher level wrapper of this command, instead\&.
  44 .sp
  45 Invokes \fIgit\-upload\-pack\fR on a possibly remote repository and asks it to send objects missing from this repository, to update the named heads\&. The list of commits available locally is found out by scanning the local refs/ hierarchy and sent to \fIgit\-upload\-pack\fR running on the other end\&.
  46 .sp
  47 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\&.
  48 .SH "OPTIONS"
  49 .PP
  50 \-\-all
  51 .RS 4
  52 Fetch all remote refs\&.
  53 .RE
  54 .PP
  55 \-\-stdin
  56 .RS 4
  57 Take the list of refs from stdin, one per line\&. If there are refs specified on the command line in addition to this option, then the refs from stdin are processed after those on the command line\&.
  58 .sp
  59 If
  60 \fB\-\-stateless\-rpc\fR
  61 is specified together with this option then the list of refs must be in packet format (pkt\-line)\&. Each ref must be in a separate packet, and the list must end with a flush packet\&.
  62 .RE
  63 .PP
  64 \-q, \-\-quiet
  65 .RS 4
  66 Pass
  67 \fB\-q\fR
  68 flag to
  69 \fIgit unpack\-objects\fR; this makes the cloning process less verbose\&.
  70 .RE
  71 .PP
  72 \-k, \-\-keep
  73 .RS 4
  74 Do not invoke
  75 \fIgit unpack\-objects\fR
  76 on received data, but create a single packfile out of it instead, and store it in the object database\&. If provided twice then the pack is locked against repacking\&.
  77 .RE
  78 .PP
  79 \-\-thin
  80 .RS 4
  81 Fetch a "thin" pack, which records objects in deltified form based on objects not included in the pack to reduce network traffic\&.
  82 .RE
  83 .PP
  84 \-\-include\-tag
  85 .RS 4
  86 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\&.
  87 .RE
  88 .PP
  89 \-\-upload\-pack=<git\-upload\-pack>
  90 .RS 4
  91 Use this to specify the path to
  92 \fIgit\-upload\-pack\fR
  93 on the remote side, if is not found on your $PATH\&. Installations of sshd ignores the user\(cqs environment setup scripts for login shells (e\&.g\&. \&.bash_profile) and your privately installed git may not be found on the system 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)\&.
  94 .RE
  95 .PP
  96 \-\-exec=<git\-upload\-pack>
  97 .RS 4
  98 Same as \-\-upload\-pack=<git\-upload\-pack>\&.
  99 .RE
 100 .PP
 101 \-\-depth=<n>
 102 .RS 4
 103 Limit fetching to ancestor\-chains not longer than n\&.
 104 \fIgit\-upload\-pack\fR
 105 treats the special depth 2147483647 as infinite even if there is an ancestor\-chain that long\&.
 106 .RE
 107 .PP
 108 \-\-shallow\-since=<date>
 109 .RS 4
 110 Deepen or shorten the history of a shallow repository to include all reachable commits after <date>\&.
 111 .RE
 112 .PP
 113 \-\-shallow\-exclude=<revision>
 114 .RS 4
 115 Deepen or shorten the history of a shallow repository to exclude commits reachable from a specified remote branch or tag\&. This option can be specified multiple times\&.
 116 .RE
 117 .PP
 118 \-\-deepen\-relative
 119 .RS 4
 120 Argument \-\-depth specifies the number of commits from the current shallow boundary instead of from the tip of each remote branch history\&.
 121 .RE
 122 .PP
 123 \-\-refetch
 124 .RS 4
 125 Skips negotiating commits with the server in order to fetch all matching objects\&. Use to reapply a new partial clone blob/tree filter\&.
 126 .RE
 127 .PP
 128 \-\-no\-progress
 129 .RS 4
 130 Do not show the progress\&.
 131 .RE
 132 .PP
 133 \-\-check\-self\-contained\-and\-connected
 134 .RS 4
 135 Output "connectivity\-ok" if the received pack is self\-contained and connected\&.
 136 .RE
 137 .PP
 138 \-v
 139 .RS 4
 140 Run verbosely\&.
 141 .RE
 142 .PP
 143 <repository>
 144 .RS 4
 145 The URL to the remote repository\&.
 146 .RE
 147 .PP
 148 <refs>\&...
 149 .RS 4
 150 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\&.
 151 .sp
 152 If the remote has enabled the options
 153 \fBuploadpack\&.allowTipSHA1InWant\fR,
 154 \fBuploadpack\&.allowReachableSHA1InWant\fR, or
 155 \fBuploadpack\&.allowAnySHA1InWant\fR, they may alternatively be 40\-hex sha1s present on the remote\&.
 156 .RE
 157 .SH "SEE ALSO"
 158 .sp
 159 \fBgit-fetch\fR(1)
 160 .SH "GIT"
 161 .sp
 162 Part of the \fBgit\fR(1) suite