git-update-ref - 安全地更新存储在ref中的对象名
git update-ref [-m <reason>] [--no-deref] (-d <ref> [<oldvalue>] | [--create-reflog] <ref> <newvalue> [<oldvalue>] | --stdin [-z])
给出两个参数，存储< newvalue>在< ref>中，可能取消引用符号引用。例如。 git update-ref HEAD <newvalue>将当前分支头更新为新对象。
给出三个参数，存储< newvalue>在< ref>中，在验证< ref>的当前值之后，可能解除引用符号引用。匹配< oldvalue>。例如。 git update-ref refs/heads/master <newvalue> <oldvalue>将主分支头更新为< newvalue>仅当其当前值为< oldvalue>时。您可以将40“0”或空字符串指定为< oldvalue>确保您创建的引用不存在。
它还允许“ref”文件作为指向另一个ref文件的符号指针，方法是从“ref：”的四字节头文件序列开始。
更重要的是，它允许更新ref文件以遵循这些符号指针，无论它们是符号链接还是这些“常规文件符号引用”。它只跟随真实符号链接，如果它们以“refs /”开头：否则它只会尝试读取它们并将它们更新为常规文件（即它将允许文件系统跟随它们，但会覆盖它们符号链接到其他具有常规文件名的地方）。
如果给出了--no-deref，则< ref>本身被覆盖，而不是遵循符号指针的结果。
一般来说，使用
git update-ref HEAD "$head"
应该是_很多_比做更安全
echo "$head" > "$GIT_DIR/HEAD"
从符合条件的符号链接和两者都是错误检查的立场。符号链接的“refs /”规则意味着指向树“外部”的符号链接是安全的：它们将被用于读取但不用于写入（因此我们永远不会通过ref符号链接写入其他树，如果您已通过创建符号链接树复制了整个存档。
使用-d标志，它将删除命名的< ref>验证后仍然包含< oldvalue>。
使用--stdin，update-ref从标准输入读取指令并一起执行所有修改。指定表单的命令：
update SP <ref> SP <newvalue> [SP <oldvalue>] LF
create SP <ref> SP <newvalue> LF
delete SP <ref> [SP <oldvalue>] LF
verify SP <ref> [SP <oldvalue>] LF
option SP <opt> LF
使用--create-reflog，update-ref将为每个ref创建一个reflog，即使通常不会创建一个。
引用包含空格的字段，就好像它们是C源代码中的字符串一样;即，被双引号包围并带有反斜杠逃逸。使用40“0”字符或空字符串指定零值。要指定缺失值，请完全省略该值及其前面的SP。
或者，使用-z以NUL终止格式指定，而不引用：
update SP <ref> NUL <newvalue> NUL [<oldvalue>] NUL
create SP <ref> NUL <newvalue> NUL
delete SP <ref> NUL [<oldvalue>] NUL
verify SP <ref> NUL [<oldvalue>] NUL
option SP <opt> NUL
在此格式中，使用40“0”指定零值，并使用空字符串指定缺失值。
无论使用哪种格式，都可以以Git识别为对象名称的任何形式指定值。任何其他格式的命令或重复的< ref>产生错误。命令含义是：
update
设置< ref>到< newvalue>在验证< oldvalue>之后，如果给出。指定零< newvalue>确保更新后ref不存在和/或零< oldvalue>确保在更新之前ref不存在。
create
创建< ref>与< newvalue>在验证它不存在之后。给定的< newvalue>可能不是零。
delete
删除< ref>在验证它与< oldvalue>存在之后，如果给出。如果给出，< oldvalue>可能不是零。
verify
验证< ref>反对< oldvalue>但不要改变它。如果< oldvalue>零或缺少，ref必须不存在。
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值的更改。日志行的格式为：
oldsha1 SP newsha1 SP committer LF
其中“oldsha1”是先前存储在< ref>中的40字符十六进制值，“newsha1”是< newvalue>的40字符十六进制值。 “committer”是标准Git committer ident格式的提交者姓名，电子邮件地址和日期。
可选地使用-m：
oldsha1 SP newsha1 SP committer TAB message LF
其中所有字段如上所述，“message”是提供给-m选项的值。
如果当前用户无法创建新日志文件，附加到现有日志文件或没有可用的提交者信息，则更新将失败（不更改< ref>）。
部分 git [1] 套件