Git
English ▾ 主題 ▾ 最新版本 ▾ git-fetch-pack 最後更新於 2.43.0

名稱

git-fetch-pack - 從另一個儲存庫接收遺失的物件

概要

git fetch-pack [--all] [--quiet|-q] [--keep|-k] [--thin] [--include-tag]
	[--upload-pack=<git-upload-pack>]
	[--depth=<n>] [--no-progress]
	[-v] <repository> [<refs>…​]

描述

通常您會想要使用 git fetch，它是此命令的更高等級包裝。

在可能為遠端的儲存庫上調用 git-upload-pack，並要求它傳送此儲存庫中遺失的物件，以更新已命名的 head。本機可用的提交清單是透過掃描本機 refs/ 階層並將其傳送至另一端執行的 git-upload-pack 來尋找的。

當本機端沒有共同的祖先提交時，此命令會降級為下載所有內容，以完成遠端要求的 refs。

選項

--all

提取所有遠端 refs。

--stdin

從 stdin 取得 refs 清單，每行一個。如果除了此選項之外，命令列上還有指定的 refs，則會處理命令列上的 refs 之後，再處理 stdin 中的 refs。

如果 --stateless-rpc 與此選項一起指定，則 refs 清單必須採用封包格式 (pkt-line)。每個 ref 必須在單獨的封包中，且清單必須以 flush 封包結束。

-q
--quiet

將 -q 旗標傳遞給 git unpack-objects；這會使複製過程不那麼冗長。

-k
--keep

不要在接收到的資料上調用 git unpack-objects，而是從中建立一個單一 packfile，並將其儲存在物件資料庫中。如果提供兩次，則會鎖定 pack 以防止重新打包。

--thin

提取「thin」封包，它會根據未包含在封包中的物件以差異化形式記錄物件，以減少網路流量。

--include-tag

如果遠端支援，則如果下載標籤參考的物件，則註解標籤物件將在與其他物件相同的連線上下載。呼叫者必須另行決定此選項使其可用的標籤。

--upload-pack=<git-upload-pack>

如果遠端上的 git-upload-pack 未在您的 $PATH 中找到，請使用此選項指定其路徑。sshd 的安裝會忽略使用者用於登入 shell 的環境設定腳本 (例如 .bash_profile)，而且您私下安裝的 git 可能在系統預設的 $PATH 上找不到。另一個建議的解決方法是在 ".bashrc" 中設定您的 $PATH，但此旗標適用於不想因精簡的 .bashrc 檔案而為非互動式 shell 付出額外開銷的人 (他們在 .bash_profile 中設定大多數內容)。

--exec=<git-upload-pack>

與 --upload-pack=<git-upload-pack> 相同。

--depth=<n>

將提取限制為長度不超過 n 的祖先鏈。git-upload-pack 會將特殊深度 2147483647 視為無限，即使存在那麼長的祖先鏈也是如此。

--shallow-since=<date>

加深或縮短淺儲存庫的歷程記錄，以包含 <date> 之後所有可到達的提交。

--shallow-exclude=<revision>

加深或縮短淺儲存庫的歷程記錄，以排除從指定的遠端分支或標籤可到達的提交。此選項可以指定多次。

--deepen-relative

引數 --depth 指定從目前淺邊界而不是從每個遠端分支歷程記錄頂端的提交數。

--refetch

跳過與伺服器協商提交，以便提取所有相符的物件。用於重新套用新的部分複製 blob/樹狀結構篩選器。

--no-progress

不顯示進度。

--check-self-contained-and-connected

如果接收到的封包是獨立且已連線的，則輸出「connectivity-ok」。

-v

詳細執行。

<repository>

遠端儲存庫的 URL。

<refs>…​

要從中更新的遠端 head。這是相對於 $GIT_DIR (例如，「HEAD」、「refs/heads/master」)。如果未指定，則會從遠端端擁有的所有 head 更新。

如果遠端已啟用選項 uploadpack.allowTipSHA1InWant、uploadpack.allowReachableSHA1InWant 或 uploadpack.allowAnySHA1InWant，它們也可以是遠端上存在的 40 個十六進位 sha1。

另請參閱

git-fetch[1]

GIT

git[1] 套件的一部分

scroll-to-top