在參考中更新物件名稱

使用

更新儲存在引用中的物件名稱

概要

git update-ref [-m <reason>] (-d <ref> [<oldvalue>] | [--no-deref] [--create-reflog] <ref> <newvalue> [<oldvalue>] | --stdin [-z])

一般語法

  1. 取消引用符號引用,將當前分支頭更新為新物件。

    git update-ref HEAD <newvalue>
    
  2. 在驗證 ref 的當前值與 oldvalue 匹配後,將 newvalue 儲存在 ref 中。

    git update-ref refs/head/master <newvalue> <oldvalue>
    

    只有當前值為 oldvalue 時,上面的語法才會將 master 分支頭更新為 newvalue

在驗證它仍包含 <oldvalue> 後,使用 -d 標誌刪除命名的 <ref>

使用 --create-reflog,update-ref 將為每個 ref 建立一個 reflog,即使通常不會建立一個 reflog。

使用 -z 標誌以 NUL 終止格式指定,其格式包括 update,create,delete,verify。

更新

如果給出,在驗證 <oldvalue> 之後將 <ref> 設定為 <newvalue>。指定零 <newvalue> 以確保更新後 ref 不存在和/或零 <oldvalue> 以確保在更新之前 ref 不存在。

建立

在驗證它不存在後,用 <newvalue> 建立 <ref>。給定的 <newvalue> 可能不為零。

刪除

如果給出,在驗證它與 <oldvalue> 存在後刪除 <ref>。如果給出,<oldvalue> 可能不為零。

校驗

驗證 <ref><oldvalue> 但不改變它。如果 <oldvalue> 為零或缺失,則 ref 必須不存在。