名称

git-diagnose - 生成包含诊断信息的 zip 压缩包

概要

git diagnose [(-o | --output-directory) <path>] [(-s | --suffix) <format>]
	       [--mode=<mode>]

描述

收集关于用户机器、Git 客户端和仓库状态的详细信息,并将这些信息打包到一个 zip 压缩包中。生成的压缩包可以被分享给 Git 邮件列表,以帮助调试问题,或者作为独立调试的参考。

默认情况下,以下信息会被捕获到压缩包中:

  • git version --build-options

  • 仓库根目录的路径

  • 文件系统上的可用磁盘空间

  • 每个 packfile 的名称和大小,包括那些在备用对象存储中的 packfile

  • 松散对象的总数,以及按 .git/objects 子目录细分的计数

可以通过使用 --mode 选项选择不同的诊断模式来收集其他信息。

此工具与 git-bugreport[1] 的不同之处在于,它收集更详细的信息,并且更加注重报告仓库内容的大小和数据形状。

选项

-o <路径>
--output-directory <路径>

将生成的诊断压缩包放在 <路径> 中,而不是当前目录。

-s <格式>
--suffix <格式>

指定诊断压缩包名称的备用后缀,以创建一个名为 *git-diagnostics-<格式化后的后缀>* 的文件。这应该采用 strftime(3) 格式字符串的形式;将使用当前的本地时间。

--mode=(stats|all)

指定应收集的诊断类型。git diagnose 的默认行为等同于 --mode=stats

--mode=all 选项会收集 --mode=stats 中包含的所有内容,以及 .git.git/hooks.git/info.git/logs.git/objects/info 目录的副本。这些附加信息可能很敏感,因为它可用于重建诊断仓库的完整内容。用户在共享使用 --mode=all 生成的压缩包时应谨慎。

GIT

属于 git[1] 套件的一部分

scroll-to-top