名称

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 <path>
--output-directory <path>

将生成的诊断存档放置在 <path> 中，而不是当前目录。

-s <format>
--suffix <format>

为诊断存档名称指定一个备用的后缀，以创建一个名为 git-diagnostics-<formatted-suffix> 的文件。这应该采用 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] 套件的一部分