mirror of
https://github.com/git/git
synced 2024-11-05 18:59:29 +00:00
6783fd3cef
Create a 'git diagnose' builtin to generate a standalone zip archive of
repository diagnostics.
The "diagnose" functionality was originally implemented for Scalar in
aa5c79a331 (scalar: implement `scalar diagnose`, 2022-05-28). However, the
diagnostics gathered are not specific to Scalar-cloned repositories and
can be useful when diagnosing issues in any Git repository.
Helped-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Helped-by: Derrick Stolee <derrickstolee@github.com>
Signed-off-by: Victoria Dye <vdye@github.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
50 lines
1.5 KiB
Text
50 lines
1.5 KiB
Text
git-diagnose(1)
|
|
================
|
|
|
|
NAME
|
|
----
|
|
git-diagnose - Generate a zip archive of diagnostic information
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'git diagnose' [(-o | --output-directory) <path>] [(-s | --suffix) <format>]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Collects detailed information about the user's machine, Git client, and
|
|
repository state and packages that information into a zip archive. The
|
|
generated archive can then, for example, be shared with the Git mailing list to
|
|
help debug an issue or serve as a reference for independent debugging.
|
|
|
|
The following information is captured in the archive:
|
|
|
|
* 'git version --build-options'
|
|
* The path to the repository root
|
|
* The available disk space on the filesystem
|
|
* The name and size of each packfile, including those in alternate object
|
|
stores
|
|
* The total count of loose objects, as well as counts broken down by
|
|
`.git/objects` subdirectory
|
|
|
|
This tool differs from linkgit:git-bugreport[1] in that it collects much more
|
|
detailed information with a greater focus on reporting the size and data shape
|
|
of repository contents.
|
|
|
|
OPTIONS
|
|
-------
|
|
-o <path>::
|
|
--output-directory <path>::
|
|
Place the resulting diagnostics archive in `<path>` instead of the
|
|
current directory.
|
|
|
|
-s <format>::
|
|
--suffix <format>::
|
|
Specify an alternate suffix for the diagnostics archive name, to create
|
|
a file named 'git-diagnostics-<formatted suffix>'. This should take the
|
|
form of a strftime(3) format string; the current local time will be
|
|
used.
|
|
|
|
GIT
|
|
---
|
|
Part of the linkgit:git[1] suite
|