commit a954aa0a95f72d7aa4bd8e3aff9ce3ad862a2b6e from: Stefan Sperling date: Tue Jun 22 20:37:39 2021 UTC sync man pages commit - eb8b2610464f8bcb526eecccb83eee0bf8595692 commit + a954aa0a95f72d7aa4bd8e3aff9ce3ad862a2b6e blob - d05a62715a164e58f7c1a4851e14952f7e426cb4 blob + 1a180b0a04b76c153a96b70911093bc61141c9d3 --- git-repository.5.html +++ git-repository.5.html @@ -17,6 +17,7 @@ --> + + GOTADMIN(1) + + + + + + + + +
GOTADMIN(1)General Commands ManualGOTADMIN(1)
+
+
+

+

gotadmin — Game of + Trees repository administration

+
+
+

+ + + + + +
gotadmincommand [-h] + [arg ...]
+
+
+

+

gotadmin is the repository maintenance + tool for the got(1) version control system.

+

got(1) stores the history of tracked files in a + Git repository, as used by the Git version control system. + gotadmin provides commands for inspecting and + manipulating the on-disk state of Git repositories. The repository format is + described in git-repository(5).

+

gotadmin provides global and + command-specific options. Global options must precede the command name, and + are as follows:

+
+
+
Display usage information and exit immediately.
+
, + --version
+
Display program version and exit immediately.
+
+

The commands for gotadmin are as + follows:

+
+
+ [-r repository-path]
+
Display information about a repository. This includes some configuration + settings from got.conf(5), and the number of objects + stored in the repository, in packed or loose form, as well as the current + on-disk size of these objects. +

The options for gotadmin info are as + follows:

+
+
+ repository-path
+
Use the repository at the specified path. If not specified, assume the + repository is located at or above the current working directory.
+
+
+
+ [-a] [-r + repository-path] [-x + reference] [reference ...]
+
Generate a new pack file and a corresponding pack file index. By default, + add any loose objects which are reachable via any references to the + generated pack file. +

If one or more reference arguments is + specified, only add objects which are reachable via the specified + references. Each reference argument may either + specify a specific reference or a reference namespace, in which case all + references within this namespace will be used.

+

gotadmin pack always ignores + references in the refs/got/ namespace, + effectively treating such references as if they did not refer to any + objects.

+

The options for gotadmin pack are as + follows:

+
+
+
Add objects to the generated pack file even if they are already packed + in a different pack file. Unless this option is specified, only loose + objects will be added.
+
+ repository-path
+
Use the repository at the specified path. If not specified, assume the + repository is located at or above the current working directory.
+
+ reference
+
Exclude objects reachable via the specified + reference from the pack file. The + reference argument may either specify a specific + reference or a reference namespace, in which case all references + within this namespace will be excluded. The -x + option may be specified multiple times to build a list of references + to exclude. +

Exclusion takes precedence over inclusion. If a reference + appears in both the included and excluded lists, it will be + excluded.

+
+
+
+
+ packfile-path
+
Create a pack index for the pack file at + packfile-path. +

A pack index is required for using the corresponding pack file + with got(1). Usually, a pack index will be created by + commands such as gotadmin pack or + got fetch as part of regular operation. The + gotadmin indexpack command may be used to + recover from a corrupt or missing index. A given pack file will always + yield the same bit-identical index.

+

The provided packfile-path must be + located within the objects/pack/ directory of + the repository and should end in .pack. The + filename of the corresponding pack index is equivalent, except that it + ends in .idx.

+
+
+
Short alias for indexpack.
+
+ [-h] [-s] + packfile-path
+
List the contents of the pack file at packfile-path. +

Each object contained in the pack file will be displayed on a + single line. The information shown includes the object ID, object type, + object offset, and object size.

+

If a packed object is deltified against another object the + delta base will be shown as well. For offset deltas, the delta base is + identified via an offset into the pack file. For reference deltas, the + delta base is identified via an object ID.

+

The provided packfile-path must be + located within the objects/pack/ directory of + the repository and should end in .pack.

+

The options for gotadmin listpack are + as follows:

+
+
+
Show object sizes in human-readable form.
+
+
Display statistics about the pack file after listing objects. This + includes the total number of objects stored in the pack file and a + break-down of the number of objects per object type.
+
+
+
+
Short alias for listpack.
+
+
+
+

+

The gotadmin utility exits 0 on + success, and >0 if an error occurs.

+
+
+

+

got(1), tog(1), + git-repository(5), got.conf(5)

+
+
+

+

Stefan Sperling + <stsp@openbsd.org> +
+ Ori Bernstein + <ori@openbsd.org>

+
+
+ + + + + +
June 22, 2021OpenBSD 6.9
+ + blob - 1c83dc49da5f934c3d6bd696f4026053ffe9d339 blob + fb2b53a4939dd860ed41037cec5881fe461d84e4 --- gotweb.conf.5.html +++ gotweb.conf.5.html @@ -17,6 +17,7 @@ --> +