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 v1.79.2 <http://docbook.sf.net/>
   5 .\"      Date: 2024-09-18
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.46.1.565.g6531f31ef3
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-FETCH\-PACK" "1" "2024-09-18" "Git 2\&.46\&.1\&.565\&.g6531f3" "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 .SH "DESCRIPTION"
  41 .sp
  42 Usually you would want to use \fIgit fetch\fR, which is a higher level wrapper of this command, instead\&.
  43 .sp
  44 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\&.
  45 .sp
  46 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\&.
  47 .SH "OPTIONS"
  48 .PP
  49 \-\-all
  50 .RS 4
  51 Fetch all remote refs\&.
  52 .RE
  53 .PP
  54 \-\-stdin
  55 .RS 4
  56 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\&.
  57 .sp
  58 If
  59 \fB\-\-stateless\-rpc\fR
  60 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\&.
  61 .RE
  62 .PP
  63 \-q, \-\-quiet
  64 .RS 4
  65 Pass
  66 \fB\-q\fR
  67 flag to
  68 \fIgit unpack\-objects\fR; this makes the cloning process less verbose\&.
  69 .RE
  70 .PP
  71 \-k, \-\-keep
  72 .RS 4
  73 Do not invoke
  74 \fIgit unpack\-objects\fR
  75 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\&.
  76 .RE
  77 .PP
  78 \-\-thin
  79 .RS 4
  80 Fetch a "thin" pack, which records objects in deltified form based on objects not included in the pack to reduce network traffic\&.
  81 .RE
  82 .PP
  83 \-\-include\-tag
  84 .RS 4
  85 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\&.
  86 .RE
  87 .PP
  88 \-\-upload\-pack=<git\-upload\-pack>
  89 .RS 4
  90 Use this to specify the path to
  91 \fIgit\-upload\-pack\fR
  92 on the remote side, if it 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)\&.
  93 .RE
  94 .PP
  95 \-\-exec=<git\-upload\-pack>
  96 .RS 4
  97 Same as \-\-upload\-pack=<git\-upload\-pack>\&.
  98 .RE
  99 .PP
 100 \-\-depth=<n>
 101 .RS 4
 102 Limit fetching to ancestor\-chains not longer than n\&.
 103 \fIgit\-upload\-pack\fR
 104 treats the special depth 2147483647 as infinite even if there is an ancestor\-chain that long\&.
 105 .RE
 106 .PP
 107 \-\-shallow\-since=<date>
 108 .RS 4
 109 Deepen or shorten the history of a shallow repository to include all reachable commits after <date>\&.
 110 .RE
 111 .PP
 112 \-\-shallow\-exclude=<revision>
 113 .RS 4
 114 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\&.
 115 .RE
 116 .PP
 117 \-\-deepen\-relative
 118 .RS 4
 119 Argument \-\-depth specifies the number of commits from the current shallow boundary instead of from the tip of each remote branch history\&.
 120 .RE
 121 .PP
 122 \-\-refetch
 123 .RS 4
 124 Skips negotiating commits with the server in order to fetch all matching objects\&. Use to reapply a new partial clone blob/tree filter\&.
 125 .RE
 126 .PP
 127 \-\-no\-progress
 128 .RS 4
 129 Do not show the progress\&.
 130 .RE
 131 .PP
 132 \-\-check\-self\-contained\-and\-connected
 133 .RS 4
 134 Output "connectivity\-ok" if the received pack is self\-contained and connected\&.
 135 .RE
 136 .PP
 137 \-v
 138 .RS 4
 139 Run verbosely\&.
 140 .RE
 141 .PP
 142 <repository>
 143 .RS 4
 144 The URL to the remote repository\&.
 145 .RE
 146 .PP
 147 <refs>\&...\:
 148 .RS 4
 149 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\&.
 150 .sp
 151 If the remote has enabled the options
 152 \fBuploadpack\&.allowTipSHA1InWant\fR,
 153 \fBuploadpack\&.allowReachableSHA1InWant\fR, or
 154 \fBuploadpack\&.allowAnySHA1InWant\fR, they may alternatively be 40\-hex sha1s present on the remote\&.
 155 .RE
 156 .SH "SEE ALSO"
 157 .sp
 158 \fBgit-fetch\fR(1)
 159 .SH "GIT"
 160 .sp
 161 Part of the \fBgit\fR(1) suite