logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

git-fetch-pack.1 (5887B)


  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: 2025-03-14
  6. .\" Manual: Git Manual
  7. .\" Source: Git 2.49.0
  8. .\" Language: English
  9. .\"
  10. .TH "GIT\-FETCH\-PACK" "1" "2025-03-14" "Git 2\&.49\&.0" "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=<ref>
  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