Git

名稱

git-refs - 低階存取 refs

概要

git refs migrate --ref-format=<format> [--dry-run]
git refs verify [--strict] [--verbose]

描述

此命令提供對 refs 的低階存取。

命令

migrate

在不同格式之間遷移 ref 儲存。

verify

驗證參考資料庫的一致性。

選項

以下選項是 git refs migrate 特有的

--ref-format=<格式>

遷移 ref 儲存的 ref 格式。可以是以下其中一種：

  • files 代表具有 packed-refs 的鬆散檔案。這是預設值。

  • reftable 代表 reftable 格式。此格式為實驗性質，其內部結構可能會變更。

--dry-run

執行遷移，但不修改儲存庫。遷移後的 refs 將被寫入一個單獨的目錄，可以單獨檢查。目錄的名稱將在 stdout 上報告。這可用於在執行實際遷移之前仔細檢查遷移是否按預期工作。

以下選項是 git refs verify 特有的

--strict

啟用更嚴格的錯誤檢查。這會將警告報告為錯誤。請參閱 git-fsck[1]。

--verbose

驗證參考資料庫一致性時，請詳細輸出訊息。

已知限制

目前形式的 ref 格式遷移有幾個已知的限制

  • 無法遷移具有 reflog 的儲存庫。

  • 無法遷移具有工作樹的儲存庫。

  • 在正在進行的遷移期間，沒有辦法阻止對儲存庫的並行寫入。並行寫入可能導致不一致的遷移狀態。使用者應在高層級阻止寫入。如果您的儲存庫已註冊進行排程維護，建議先使用 git-maintenance(1) 取消註冊。

這些限制最終可能會解除。

GIT

屬於 git[1] 套件的一部分

scroll-to-top