git-update-ref

原文： https://git-scm.com/docs/git-update-ref

名称

git-update-ref - 安全地更新存储在ref中的对象名

概要

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

描述

给出两个参数，存储< newvalue>在< ref>中，可能取消引用符号引用。例如。 git update-ref HEAD &lt;newvalue&gt;将当前分支头更新为新对象。

给出三个参数，存储< newvalue>在< ref>中，在验证< ref>的当前值之后，可能解除引用符号引用。匹配< oldvalue>。例如。 git update-ref refs/heads/master &lt;newvalue&gt; &lt;oldvalue&gt;将主分支头更新为< newvalue>仅当其当前值为< oldvalue>时。您可以将40“0”或空字符串指定为< oldvalue>确保您创建的引用不存在。

它还允许“ref”文件作为指向另一个ref文件的符号指针，方法是从“ref：”的四字节头文件序列开始。

更重要的是，它允许更新ref文件以遵循这些符号指针，无论它们是符号链接还是这些“常规文件符号引用”。它只跟随真实符号链接，如果它们以“refs /”开头：否则它只会尝试读取它们并将它们更新为常规文件（即它将允许文件系统跟随它们，但会覆盖它们符号链接到其他具有常规文件名的地方）。

如果给出了—no-deref，则< ref>本身被覆盖，而不是遵循符号指针的结果。

一般来说，使用

  1. git update-ref HEAD "$head"

应该是很多比做更安全

  1. echo "$head" > "$GIT_DIR/HEAD"

从符合条件的符号链接和两者都是错误检查的立场。符号链接的“refs /”规则意味着指向树“外部”的符号链接是安全的：它们将被用于读取但不用于写入（因此我们永远不会通过ref符号链接写入其他树，如果您已通过创建符号链接树复制了整个存档。

使用-d标志，它将删除命名的< ref>验证后仍然包含< oldvalue>。

使用--stdin，update-ref从标准输入读取指令并一起执行所有修改。指定表单的命令：

  1. update SP <ref> SP <newvalue> [SP <oldvalue>] LF
  2. create SP <ref> SP <newvalue> LF
  3. delete SP <ref> [SP <oldvalue>] LF
  4. verify SP <ref> [SP <oldvalue>] LF
  5. option SP <opt> LF

使用--create-reflog，update-ref将为每个ref创建一个reflog，即使通常不会创建一个。

引用包含空格的字段，就好像它们是C源代码中的字符串一样;即，被双引号包围并带有反斜杠逃逸。使用40“0”字符或空字符串指定零值。要指定缺失值，请完全省略该值及其前面的SP。

或者，使用-z以NUL终止格式指定，而不引用：

  1. update SP <ref> NUL <newvalue> NUL [<oldvalue>] NUL
  2. create SP <ref> NUL <newvalue> NUL
  3. delete SP <ref> NUL [<oldvalue>] NUL
  4. verify SP <ref> NUL [<oldvalue>] NUL
  5. option SP <opt> NUL

在此格式中，使用40“0”指定零值，并使用空字符串指定缺失值。

无论使用哪种格式，都可以以Git识别为对象名称的任何形式指定值。任何其他格式的命令或重复的< ref>产生错误。命令含义是：

  1.  update

设置< ref>到< newvalue>在验证< oldvalue>之后，如果给出。指定零< newvalue>确保更新后ref不存在和/或零< oldvalue>确保在更新之前ref不存在。

  1.  create

创建< ref>与< newvalue>在验证它不存在之后。给定的< newvalue>可能不是零。

  1.  delete

删除< ref>在验证它与< oldvalue>存在之后，如果给出。如果给出，< oldvalue>可能不是零。

  1.  verify

验证< ref>反对< oldvalue>但不要改变它。如果< oldvalue>零或缺少，ref必须不存在。

  1.  option

修改命名< ref>的下一个命令的行为。唯一有效的选项是no-deref，以避免取消引用符号引用。

如果可以同时使用匹配的< oldvalue>来锁定所有< ref>，则执行所有修改。否则，不执行任何修改。注意，虽然每个人< ref>以原子方式更新或删除，并发读者仍可以看到修改的子集。

记录更新

如果config参数“core.logAllRefUpdates”为true且ref为1，则为“refs / heads /”，“refs / remotes /”，“refs / notes /”或符号ref HEAD;或文件“$ GIT_DIR / logs /< ref>”然后存在git update-ref将一行添加到日志文件“$ GIT_DIR / logs /< ref>” （在创建日志名称之前取消引用所有符号引用）描述ref值的更改。日志行的格式为：

  1. oldsha1 SP newsha1 SP committer LF

其中“oldsha1”是先前存储在< ref>中的40字符十六进制值，“newsha1”是< newvalue>的40字符十六进制值。 “committer”是标准Git committer ident格式的提交者姓名，电子邮件地址和日期。

可选地使用-m：

  1. oldsha1 SP newsha1 SP committer TAB message LF

其中所有字段如上所述，“message”是提供给-m选项的值。

如果当前用户无法创建新日志文件，附加到现有日志文件或没有可用的提交者信息，则更新将失败（不更改< ref>）。

GIT

部分 git [1] 套件