git-bugreport

收集信息供用户提交错误报告

概要

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

描述

收集有关用户机器、Git 客户端和存储库状态的信息，以及请求有关用户观察到的行为信息的表单，并将其存储在单个文本文件中，用户可以随后共享（例如发送到 Git 邮件列表）以报告观察到的 bug。

以下信息是从用户请求的：

• 复现步骤
• 预期行为
• 实际行为

以下信息是自动捕获的：

• git version --build-options
• uname sysname、release、version 和 machine 字符串
• 编译器特定信息字符串
• 已启用钩子列表
• $SHELL

可以使用 --diagnose 选项将附加信息收集到单独的 zip 存档中，并可以与 bugreport 文档一起附加，为读者提供额外上下文。

此工具通过典型的 Git 设置过程调用，这意味着在某些情况下，它可能无法启动——例如，如果相关配置文件不可读。在这种情况下，在手动寻求帮助时手动收集上述列出的信息可能会有所帮助。

选项

-o <path>, --output-directory <path>

将结果错误报告文件放在 <path> 而不是当前目录。

-s <format>, --suffix <format>, --no-suffix

为 bugreport 名称指定替代后缀，创建名为 'git-bugreport-<formatted-suffix>' 的文件。这应该采用 strftime(3) 格式字符串的形式；将使用当前本地时间。--no-suffix 禁用后缀，文件仅命名为 git-bugreport，没有任何消歧措施。

--no-diagnose, --diagnose[=<mode>]

创建有关用户机器、Git 客户端和存储库状态的补充信息的 zip 存档。存档写入与错误报告相同的输出目录，命名为 'git-diagnostics-<formatted-suffix>'。 未指定 mode 时，诊断存档将包含 git diagnose 报告的默认统计信息集。可以指定可选的 mode 值来更改存档中包含的信息。有关 mode 的有效值列表及其用法详细信息，请参阅 git-diagnose(1)。

Git

git(1) 套件的一部分