• git-fsck
    • 名称
    • 概要
    • 描述
    • OPTIONS
    • 讨论
    • 提取的诊断
    • 环境变量
    • GIT

    git-fsck

    原文: https://git-scm.com/docs/git-fsck

    名称

    git-fsck - 验证数据库中对象的连通性和有效性

    概要

    1. git fsck [--tags] [--root] [--unreachable] [--cache] [--no-reflogs]
    2. [--[no-]full] [--strict] [--verbose] [--lost-found]
    3. [--[no-]dangling] [--[no-]progress] [--connectivity-only]
    4. [--[no-]name-objects] [<object>*]

    描述

    验证数据库中对象的连接性和有效性。

    OPTIONS

    1. <object>

    作为不可达性痕迹的头部对象的对象。

    如果没有给出对象, git fsck 默认使用索引文件,refs命名空间中的所有SHA-1引用,以及所有reflog(除非给出—no-reflogs)作为头。

    1. --unreachable

    打印出存在但无法从任何引用节点访问的对象。

    1. --[no-]dangling

    打印存在但永远不会直接使用的对象(默认)。 --no-dangling可用于从输出中省略此信息。

    1. --root

    报告根节点。

    1. --tags

    报告标签。

    1. --cache

    将索引中记录的任何对象也视为不可达性跟踪的头节点。

    1. --no-reflogs

    不要认为仅由reflog中的条目引用的提交是可访问的。此选项仅用于搜索曾经在ref中的提交,但现在不是,但仍在相应的reflog中。

    1. --full

    不仅检查GIT_OBJECT_DIRECTORY($ GIT_DIR / objects)中的对象,还检查在GIT_ALTERNATE_OBJECT_DIRECTORIES或$ GIT_DIR / objects / info / alternates中列出的备用对象池中找到的对象,以及在$ GIT_DIR / objects / pack中找到的打包Git存档中找到的对象打包备用对象池中的子目录。这是默认值;你可以用—no-full把它关掉。

    1. --connectivity-only

    仅检查标记,提交和树对象的连接。通过避免解压缩blob,这会加速操作,但代价是丢失损坏的对象或其他有问题的问题。

    1. --strict

    启用更严格的检查,即捕获由g + w位集记录的文件模式,该模式由旧版本的Git创建。现有存储库(包括Linux内核,Git本身和稀疏存储库)具有触发此检查的旧对象,但建议使用此标志检查新项目。

    1. --verbose

    说实话。

    1. --lost-found

    将悬空对象写入.git / lost-found / commit /或.git / lost-found / other /,具体取决于类型。如果对象是blob,则将内容写入文件,而不是其对象名称。

    1. --name-objects

    当显示可到达对象的名称时,除了SHA-1之外还显示描述如何可以到达的名称,与 git-rev-parse [1] 兼容,例如HEAD@{1234567890}~25^2:src/

    1. --[no-]progress

    除非指定了—no-progress或—verbose,否则默认情况下,当标准错误流附加到终端时,会报告进度状态。 - 即使标准错误流未定向到终端, - progress也会强制进度状态。

    讨论

    git-fsck测试SHA-1和一般对象的健全性,它完全跟踪产生的可达性和其他所有内容。它会打印出它找到的任何损坏(丢失或坏的对象),如果使用--unreachable标志,它还会打印出存在但无法从任何指定的头节点(或默认集)访问的对象,正如刚才提到的)。

    您必须在备份或其他存档中找到任何损坏的对象(即,您可以删除它们并与其他某个站点一起执行 rsync ,希望其他人拥有您已损坏的对象)。

    如果core.commitGraph为true,则还将使用 git commit-graph verify 检查提交图文件。参见 git-commit-graph [1] 。

    提取的诊断

    1. expect dangling commits - potential heads - due to lack of head information

    您没有指定任何节点作为头,因此无法区分非父级提交和根节点。

    1. missing sha1 directory <dir>

    缺少包含sha1对象的目录。

    1. unreachable <type> <object>

    < type>对象< object>,实际上并未在任何树或提交的提交中直接或间接引用。这可能意味着您没有指定另一个根节点或树已损坏。如果您没有错过根节点,那么您也可以删除无法访问的节点,因为它们无法使用。

    1. missing <type> <object>

    < type>对象< object>,被引用但不存在于数据库中。

    1. dangling <type> <object>

    < type>对象< object>,存在于数据库中但从不直接使用。悬挂提交可以是根节点。

    1. hash mismatch <object>

    数据库有一个对象,其哈希值与对象数据库值不匹配。这表明存在严重的数据完整性问题。

    环境变量

    1. GIT_OBJECT_DIRECTORY

    用于指定对象数据库的根目录(通常为$ GIT_DIR / objects)

    1. GIT_INDEX_FILE

    用于指定索引的索引文件

    1. GIT_ALTERNATE_OBJECT_DIRECTORIES

    用于指定其他对象数据库根(通常未设置)

    GIT

    部分 git [1] 套件