Blame


1 a954aa0a 2021-06-22 stsp <!DOCTYPE html>
2 a954aa0a 2021-06-22 stsp <html>
3 a954aa0a 2021-06-22 stsp <!-- This is an automatically generated file. Do not edit.
4 a954aa0a 2021-06-22 stsp Copyright (c) 2021 Stefan Sperling
5 a954aa0a 2021-06-22 stsp
6 a954aa0a 2021-06-22 stsp Permission to use, copy, modify, and distribute this software for any
7 a954aa0a 2021-06-22 stsp purpose with or without fee is hereby granted, provided that the above
8 a954aa0a 2021-06-22 stsp copyright notice and this permission notice appear in all copies.
9 a954aa0a 2021-06-22 stsp
10 a954aa0a 2021-06-22 stsp THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 a954aa0a 2021-06-22 stsp WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 a954aa0a 2021-06-22 stsp MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 a954aa0a 2021-06-22 stsp ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 a954aa0a 2021-06-22 stsp WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 a954aa0a 2021-06-22 stsp ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 a954aa0a 2021-06-22 stsp OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17 a954aa0a 2021-06-22 stsp -->
18 a954aa0a 2021-06-22 stsp <head>
19 a954aa0a 2021-06-22 stsp <meta charset="utf-8"/>
20 a954aa0a 2021-06-22 stsp <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
21 5ca479d6 2021-11-21 stsp <link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
22 a954aa0a 2021-06-22 stsp <title>GOTADMIN(1)</title>
23 a954aa0a 2021-06-22 stsp </head>
24 a954aa0a 2021-06-22 stsp <body>
25 a954aa0a 2021-06-22 stsp <table class="head">
26 a954aa0a 2021-06-22 stsp <tr>
27 a954aa0a 2021-06-22 stsp <td class="head-ltitle">GOTADMIN(1)</td>
28 a954aa0a 2021-06-22 stsp <td class="head-vol">General Commands Manual</td>
29 a954aa0a 2021-06-22 stsp <td class="head-rtitle">GOTADMIN(1)</td>
30 a954aa0a 2021-06-22 stsp </tr>
31 a954aa0a 2021-06-22 stsp </table>
32 a954aa0a 2021-06-22 stsp <div class="manual-text">
33 a954aa0a 2021-06-22 stsp <section class="Sh">
34 a954aa0a 2021-06-22 stsp <h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
35 a954aa0a 2021-06-22 stsp <p class="Pp"><code class="Nm">gotadmin</code> &#x2014; <span class="Nd">Game of
36 a954aa0a 2021-06-22 stsp Trees repository administration</span></p>
37 a954aa0a 2021-06-22 stsp </section>
38 a954aa0a 2021-06-22 stsp <section class="Sh">
39 a954aa0a 2021-06-22 stsp <h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
40 a954aa0a 2021-06-22 stsp <table class="Nm">
41 a954aa0a 2021-06-22 stsp <tr>
42 a954aa0a 2021-06-22 stsp <td><code class="Nm">gotadmin</code></td>
43 a954aa0a 2021-06-22 stsp <td><var class="Ar">command</var> [<code class="Fl">-h</code>]
44 a954aa0a 2021-06-22 stsp [<var class="Ar">arg ...</var>]</td>
45 a954aa0a 2021-06-22 stsp </tr>
46 a954aa0a 2021-06-22 stsp </table>
47 a954aa0a 2021-06-22 stsp </section>
48 a954aa0a 2021-06-22 stsp <section class="Sh">
49 a954aa0a 2021-06-22 stsp <h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
50 a954aa0a 2021-06-22 stsp <p class="Pp"><code class="Nm">gotadmin</code> is the repository maintenance
51 a954aa0a 2021-06-22 stsp tool for the <a class="Xr">got(1)</a> version control system.</p>
52 a954aa0a 2021-06-22 stsp <p class="Pp"><a class="Xr">got(1)</a> stores the history of tracked files in a
53 a954aa0a 2021-06-22 stsp Git repository, as used by the Git version control system.
54 a954aa0a 2021-06-22 stsp <code class="Nm">gotadmin</code> provides commands for inspecting and
55 a954aa0a 2021-06-22 stsp manipulating the on-disk state of Git repositories. The repository format is
56 a954aa0a 2021-06-22 stsp described in <a class="Xr">git-repository(5)</a>.</p>
57 a954aa0a 2021-06-22 stsp <p class="Pp"><code class="Nm">gotadmin</code> provides global and
58 a954aa0a 2021-06-22 stsp command-specific options. Global options must precede the command name, and
59 a954aa0a 2021-06-22 stsp are as follows:</p>
60 a954aa0a 2021-06-22 stsp <dl class="Bl-tag">
61 a954aa0a 2021-06-22 stsp <dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a></dt>
62 a954aa0a 2021-06-22 stsp <dd>Display usage information and exit immediately.</dd>
63 a954aa0a 2021-06-22 stsp <dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a>,
64 a954aa0a 2021-06-22 stsp <code class="Fl">--version</code></dt>
65 a954aa0a 2021-06-22 stsp <dd>Display program version and exit immediately.</dd>
66 a954aa0a 2021-06-22 stsp </dl>
67 a954aa0a 2021-06-22 stsp <p class="Pp">The commands for <code class="Nm">gotadmin</code> are as
68 a954aa0a 2021-06-22 stsp follows:</p>
69 a954aa0a 2021-06-22 stsp <dl class="Bl-tag">
70 a954aa0a 2021-06-22 stsp <dt id="info"><a class="permalink" href="#info"><code class="Cm">info</code></a>
71 a954aa0a 2021-06-22 stsp [<code class="Fl">-r</code> <var class="Ar">repository-path</var>]</dt>
72 a954aa0a 2021-06-22 stsp <dd>Display information about a repository. This includes some configuration
73 a954aa0a 2021-06-22 stsp settings from <a class="Xr">got.conf(5)</a>, and the number of objects
74 a954aa0a 2021-06-22 stsp stored in the repository, in packed or loose form, as well as the current
75 a954aa0a 2021-06-22 stsp on-disk size of these objects.
76 a954aa0a 2021-06-22 stsp <p class="Pp">The options for <code class="Cm">gotadmin info</code> are as
77 a954aa0a 2021-06-22 stsp follows:</p>
78 a954aa0a 2021-06-22 stsp <dl class="Bl-tag">
79 a954aa0a 2021-06-22 stsp <dt id="r"><a class="permalink" href="#r"><code class="Fl">-r</code></a>
80 a954aa0a 2021-06-22 stsp <var class="Ar">repository-path</var></dt>
81 a954aa0a 2021-06-22 stsp <dd>Use the repository at the specified path. If not specified, assume the
82 46043f6f 2021-11-23 stsp repository is located at or above the current working directory. If
83 46043f6f 2021-11-23 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
84 46043f6f 2021-11-23 stsp repository path associated with this work tree.</dd>
85 a954aa0a 2021-06-22 stsp </dl>
86 a954aa0a 2021-06-22 stsp </dd>
87 a954aa0a 2021-06-22 stsp <dt id="pack"><a class="permalink" href="#pack"><code class="Cm">pack</code></a>
88 a954aa0a 2021-06-22 stsp [<code class="Fl">-a</code>] [<code class="Fl">-r</code>
89 a954aa0a 2021-06-22 stsp <var class="Ar">repository-path</var>] [<code class="Fl">-x</code>
90 15ba8349 2022-04-24 stsp <var class="Ar">reference</var>] [<code class="Fl">-q</code>]
91 15ba8349 2022-04-24 stsp [<var class="Ar">reference ...</var>]</dt>
92 a954aa0a 2021-06-22 stsp <dd>Generate a new pack file and a corresponding pack file index. By default,
93 a954aa0a 2021-06-22 stsp add any loose objects which are reachable via any references to the
94 a954aa0a 2021-06-22 stsp generated pack file.
95 a954aa0a 2021-06-22 stsp <p class="Pp">If one or more <var class="Ar">reference</var> arguments is
96 a954aa0a 2021-06-22 stsp specified, only add objects which are reachable via the specified
97 a954aa0a 2021-06-22 stsp references. Each <var class="Ar">reference</var> argument may either
98 a954aa0a 2021-06-22 stsp specify a specific reference or a reference namespace, in which case all
99 a954aa0a 2021-06-22 stsp references within this namespace will be used.</p>
100 a954aa0a 2021-06-22 stsp <p class="Pp"><code class="Cm">gotadmin pack</code> always ignores
101 a954aa0a 2021-06-22 stsp references in the <span class="Pa">refs/got/</span> namespace,
102 a954aa0a 2021-06-22 stsp effectively treating such references as if they did not refer to any
103 a954aa0a 2021-06-22 stsp objects.</p>
104 a954aa0a 2021-06-22 stsp <p class="Pp">The options for <code class="Cm">gotadmin pack</code> are as
105 a954aa0a 2021-06-22 stsp follows:</p>
106 a954aa0a 2021-06-22 stsp <dl class="Bl-tag">
107 a954aa0a 2021-06-22 stsp <dt id="a"><a class="permalink" href="#a"><code class="Fl">-a</code></a></dt>
108 a954aa0a 2021-06-22 stsp <dd>Add objects to the generated pack file even if they are already packed
109 a954aa0a 2021-06-22 stsp in a different pack file. Unless this option is specified, only loose
110 a954aa0a 2021-06-22 stsp objects will be added.</dd>
111 a954aa0a 2021-06-22 stsp <dt id="r~2"><a class="permalink" href="#r~2"><code class="Fl">-r</code></a>
112 a954aa0a 2021-06-22 stsp <var class="Ar">repository-path</var></dt>
113 a954aa0a 2021-06-22 stsp <dd>Use the repository at the specified path. If not specified, assume the
114 46043f6f 2021-11-23 stsp repository is located at or above the current working directory. If
115 46043f6f 2021-11-23 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
116 46043f6f 2021-11-23 stsp repository path associated with this work tree.</dd>
117 a954aa0a 2021-06-22 stsp <dt id="x"><a class="permalink" href="#x"><code class="Fl">-x</code></a>
118 a954aa0a 2021-06-22 stsp <var class="Ar">reference</var></dt>
119 a954aa0a 2021-06-22 stsp <dd>Exclude objects reachable via the specified
120 a954aa0a 2021-06-22 stsp <var class="Ar">reference</var> from the pack file. The
121 a954aa0a 2021-06-22 stsp <var class="Ar">reference</var> argument may either specify a specific
122 a954aa0a 2021-06-22 stsp reference or a reference namespace, in which case all references
123 a954aa0a 2021-06-22 stsp within this namespace will be excluded. The <code class="Fl">-x</code>
124 a954aa0a 2021-06-22 stsp option may be specified multiple times to build a list of references
125 a954aa0a 2021-06-22 stsp to exclude.
126 a954aa0a 2021-06-22 stsp <p class="Pp">Exclusion takes precedence over inclusion. If a reference
127 a954aa0a 2021-06-22 stsp appears in both the included and excluded lists, it will be
128 a954aa0a 2021-06-22 stsp excluded.</p>
129 a954aa0a 2021-06-22 stsp </dd>
130 15ba8349 2022-04-24 stsp <dt id="q"><a class="permalink" href="#q"><code class="Fl">-q</code></a></dt>
131 15ba8349 2022-04-24 stsp <dd>Suppress progress reporting output.</dd>
132 a954aa0a 2021-06-22 stsp </dl>
133 a954aa0a 2021-06-22 stsp </dd>
134 63b69821 2021-10-16 stsp <dt id="ix"><a class="permalink" href="#indexpack"><code class="Cm" id="indexpack">indexpack</code></a>
135 a954aa0a 2021-06-22 stsp <var class="Ar">packfile-path</var></dt>
136 63b69821 2021-10-16 stsp <dd>
137 63b69821 2021-10-16 stsp <div class="Bd Bd-indent"><code class="Li">(alias:
138 46043f6f 2021-11-23 stsp <code class="Cm">ix</code>)</code></div>
139 46043f6f 2021-11-23 stsp Create a pack index for the pack file at
140 a954aa0a 2021-06-22 stsp <var class="Ar">packfile-path</var>.
141 a954aa0a 2021-06-22 stsp <p class="Pp">A pack index is required for using the corresponding pack file
142 a954aa0a 2021-06-22 stsp with <a class="Xr">got(1)</a>. Usually, a pack index will be created by
143 a954aa0a 2021-06-22 stsp commands such as <code class="Cm">gotadmin pack</code> or
144 a954aa0a 2021-06-22 stsp <code class="Cm">got fetch</code> as part of regular operation. The
145 a954aa0a 2021-06-22 stsp <code class="Cm">gotadmin indexpack</code> command may be used to
146 a954aa0a 2021-06-22 stsp recover from a corrupt or missing index. A given pack file will always
147 a954aa0a 2021-06-22 stsp yield the same bit-identical index.</p>
148 a954aa0a 2021-06-22 stsp <p class="Pp">The provided <var class="Ar">packfile-path</var> must be
149 a954aa0a 2021-06-22 stsp located within the <span class="Pa">objects/pack/</span> directory of
150 a954aa0a 2021-06-22 stsp the repository and should end in <span class="Pa">.pack</span>. The
151 a954aa0a 2021-06-22 stsp filename of the corresponding pack index is equivalent, except that it
152 a954aa0a 2021-06-22 stsp ends in <span class="Pa">.idx</span>.</p>
153 a954aa0a 2021-06-22 stsp </dd>
154 63b69821 2021-10-16 stsp <dt id="ls"><a class="permalink" href="#listpack"><code class="Cm" id="listpack">listpack</code></a>
155 a954aa0a 2021-06-22 stsp [<code class="Fl">-h</code>] [<code class="Fl">-s</code>]
156 a954aa0a 2021-06-22 stsp <var class="Ar">packfile-path</var></dt>
157 63b69821 2021-10-16 stsp <dd>
158 63b69821 2021-10-16 stsp <div class="Bd Bd-indent"><code class="Li">(alias:
159 46043f6f 2021-11-23 stsp <code class="Cm">ls</code>)</code></div>
160 46043f6f 2021-11-23 stsp List the contents of the pack file at <var class="Ar">packfile-path</var>.
161 a954aa0a 2021-06-22 stsp <p class="Pp">Each object contained in the pack file will be displayed on a
162 a954aa0a 2021-06-22 stsp single line. The information shown includes the object ID, object type,
163 a954aa0a 2021-06-22 stsp object offset, and object size.</p>
164 b078d5c4 2022-03-23 stsp <p class="Pp">If a packed object is deltified against another object, the
165 a954aa0a 2021-06-22 stsp delta base will be shown as well. For offset deltas, the delta base is
166 a954aa0a 2021-06-22 stsp identified via an offset into the pack file. For reference deltas, the
167 a954aa0a 2021-06-22 stsp delta base is identified via an object ID.</p>
168 a954aa0a 2021-06-22 stsp <p class="Pp">The provided <var class="Ar">packfile-path</var> must be
169 a954aa0a 2021-06-22 stsp located within the <span class="Pa">objects/pack/</span> directory of
170 b078d5c4 2022-03-23 stsp the repository and should end in <span class="Pa">.pack</span>. The
171 b078d5c4 2022-03-23 stsp corresponding pack index must exist and can be created with
172 b078d5c4 2022-03-23 stsp <code class="Cm">gotadmin indexpack</code> if it is missing.</p>
173 a954aa0a 2021-06-22 stsp <p class="Pp">The options for <code class="Cm">gotadmin listpack</code> are
174 a954aa0a 2021-06-22 stsp as follows:</p>
175 a954aa0a 2021-06-22 stsp <dl class="Bl-tag">
176 a954aa0a 2021-06-22 stsp <dt id="h~2"><a class="permalink" href="#h~2"><code class="Fl">-h</code></a></dt>
177 a954aa0a 2021-06-22 stsp <dd>Show object sizes in human-readable form.</dd>
178 a954aa0a 2021-06-22 stsp <dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a></dt>
179 a954aa0a 2021-06-22 stsp <dd>Display statistics about the pack file after listing objects. This
180 a954aa0a 2021-06-22 stsp includes the total number of objects stored in the pack file and a
181 a954aa0a 2021-06-22 stsp break-down of the number of objects per object type.</dd>
182 a954aa0a 2021-06-22 stsp </dl>
183 a954aa0a 2021-06-22 stsp </dd>
184 63b69821 2021-10-16 stsp <dt id="cl"><a class="permalink" href="#cleanup"><code class="Cm" id="cleanup">cleanup</code></a>
185 def5be4a 2021-08-31 stsp [<code class="Fl">-a</code>] [<code class="Fl">-p</code>]
186 def5be4a 2021-08-31 stsp [<code class="Fl">-n</code>] [<code class="Fl">-r</code>
187 def5be4a 2021-08-31 stsp <var class="Ar">repository-path</var>] [<code class="Fl">-q</code>]</dt>
188 63b69821 2021-10-16 stsp <dd>
189 63b69821 2021-10-16 stsp <div class="Bd Bd-indent"><code class="Li">(alias:
190 46043f6f 2021-11-23 stsp <code class="Cm">cl</code>)</code></div>
191 46043f6f 2021-11-23 stsp Purge unreferenced loose objects from the repository and display the amount
192 46043f6f 2021-11-23 stsp of disk space which has been freed as a result.
193 16cd1323 2021-07-26 stsp <p class="Pp">Unreferenced objects are present in the repository but cannot
194 16cd1323 2021-07-26 stsp be reached via any reference in the entire <span class="Pa">refs/</span>
195 16cd1323 2021-07-26 stsp namespace.</p>
196 16cd1323 2021-07-26 stsp <p class="Pp">Loose objects are stored as individual files beneath the
197 16cd1323 2021-07-26 stsp repository's <span class="Pa">objects/</span> directory, spread across
198 16cd1323 2021-07-26 stsp 256 sub-directories named after the 256 possible hexadecimal values of
199 16cd1323 2021-07-26 stsp the first byte of an object identifier.</p>
200 16cd1323 2021-07-26 stsp <p class="Pp">Packed objects stored in pack files under
201 16cd1323 2021-07-26 stsp <span class="Pa">objects/pack/</span> will not be purged. However, if
202 16cd1323 2021-07-26 stsp redundant copies of packed objects exist in loose form, such redundant
203 16cd1323 2021-07-26 stsp copies will be purged.</p>
204 16cd1323 2021-07-26 stsp <p class="Pp">Objects will usually become unreferenced as a result of
205 16cd1323 2021-07-26 stsp deleting branches or tags with <code class="Cm">got branch -d</code> or
206 16cd1323 2021-07-26 stsp <code class="Cm">got tag -d</code>. Deleting arbitrary references with
207 16cd1323 2021-07-26 stsp <code class="Cm">got ref -d</code> may also leave unreferenced objects
208 16cd1323 2021-07-26 stsp behind.</p>
209 16cd1323 2021-07-26 stsp <p class="Pp">In order to determine the set of objects which are referenced,
210 16cd1323 2021-07-26 stsp search all references for commit objects and tag objects, and traverse
211 16cd1323 2021-07-26 stsp the corresponding tree object hierarchies. Any loose object IDs not
212 16cd1323 2021-07-26 stsp encountered during this search are unreferenced and thus subject to
213 16cd1323 2021-07-26 stsp removal. Display the number of commits which have been searched to
214 16cd1323 2021-07-26 stsp indicate progress.</p>
215 16cd1323 2021-07-26 stsp <p class="Pp">References in the <span class="Pa">refs/got</span> namespace
216 16cd1323 2021-07-26 stsp may prevent objects from being purged. This includes references in the
217 16cd1323 2021-07-26 stsp <span class="Pa">refs/got/worktree</span> namespace created by
218 16cd1323 2021-07-26 stsp <code class="Cm">got checkout</code> and <code class="Cm">got
219 16cd1323 2021-07-26 stsp update</code>, as well as references in the
220 16cd1323 2021-07-26 stsp <span class="Pa">refs/got/backup</span> namespace created by
221 16cd1323 2021-07-26 stsp <code class="Cm">got rebase</code> and <code class="Cm">got
222 16cd1323 2021-07-26 stsp histedit</code>. <code class="Cm">gotadmin cleanup</code> will only
223 16cd1323 2021-07-26 stsp purge corresponding objects once such references have been deleted with
224 16cd1323 2021-07-26 stsp <code class="Cm">got ref -d</code>.</p>
225 16cd1323 2021-07-26 stsp <p class="Pp">Some Git repositories contain pack index files which lack a
226 16cd1323 2021-07-26 stsp corresponding pack file, which is an inconsistent repository state. In
227 16cd1323 2021-07-26 stsp such cases, <code class="Cm">gotadmin cleanup -p -n</code> will display
228 b078d5c4 2022-03-23 stsp a list of affected pack index files. Whenever possible, the missing pack
229 16cd1323 2021-07-26 stsp files should be restored. If restoring missing pack files is not
230 b078d5c4 2022-03-23 stsp possible, then affected pack index files can be removed with
231 16cd1323 2021-07-26 stsp <code class="Cm">gotadmin cleanup -p</code>.</p>
232 16cd1323 2021-07-26 stsp <p class="Pp">The &#x201C;preciousObjects&#x201D; Git extension is intended
233 16cd1323 2021-07-26 stsp to prevent the removal of objects from a repository.
234 16cd1323 2021-07-26 stsp <code class="Cm">gotadmin cleanup</code> will refuse to operate on
235 16cd1323 2021-07-26 stsp repositories where this extension is active.</p>
236 16cd1323 2021-07-26 stsp <p class="Pp">The options for <code class="Cm">gotadmin cleanup</code> are
237 16cd1323 2021-07-26 stsp as follows:</p>
238 16cd1323 2021-07-26 stsp <dl class="Bl-tag">
239 def5be4a 2021-08-31 stsp <dt id="a~2"><a class="permalink" href="#a~2"><code class="Fl">-a</code></a></dt>
240 def5be4a 2021-08-31 stsp <dd>Delete all loose objects. By default, objects which are newer than an
241 def5be4a 2021-08-31 stsp implementation-defined modification timestamp are kept on disk to
242 def5be4a 2021-08-31 stsp prevent race conditions with other commands that add new objects to
243 def5be4a 2021-08-31 stsp the repository while <code class="Cm">gotadmin cleanup</code> is
244 def5be4a 2021-08-31 stsp running.</dd>
245 16cd1323 2021-07-26 stsp <dt id="p"><a class="permalink" href="#p"><code class="Fl">-p</code></a></dt>
246 16cd1323 2021-07-26 stsp <dd>Instead of purging unreferenced loose objects, remove any pack index
247 16cd1323 2021-07-26 stsp files which do not have a corresponding pack file.</dd>
248 16cd1323 2021-07-26 stsp <dt id="n"><a class="permalink" href="#n"><code class="Fl">-n</code></a></dt>
249 16cd1323 2021-07-26 stsp <dd>Display the usual progress output and summary information but do not
250 16cd1323 2021-07-26 stsp actually remove any files from disk.</dd>
251 16cd1323 2021-07-26 stsp <dt id="r~3"><a class="permalink" href="#r~3"><code class="Fl">-r</code></a>
252 16cd1323 2021-07-26 stsp <var class="Ar">repository-path</var></dt>
253 16cd1323 2021-07-26 stsp <dd>Use the repository at the specified path. If not specified, assume the
254 46043f6f 2021-11-23 stsp repository is located at or above the current working directory. If
255 46043f6f 2021-11-23 stsp this directory is a <a class="Xr">got(1)</a> work tree, use the
256 46043f6f 2021-11-23 stsp repository path associated with this work tree.</dd>
257 15ba8349 2022-04-24 stsp <dt id="q~2"><a class="permalink" href="#q~2"><code class="Fl">-q</code></a></dt>
258 16cd1323 2021-07-26 stsp <dd>Suppress progress reporting and disk space summary output.</dd>
259 16cd1323 2021-07-26 stsp </dl>
260 16cd1323 2021-07-26 stsp </dd>
261 a954aa0a 2021-06-22 stsp </dl>
262 a954aa0a 2021-06-22 stsp </section>
263 a954aa0a 2021-06-22 stsp <section class="Sh">
264 a954aa0a 2021-06-22 stsp <h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
265 a954aa0a 2021-06-22 stsp STATUS</a></h1>
266 a954aa0a 2021-06-22 stsp <p class="Pp">The <code class="Nm">gotadmin</code> utility exits&#x00A0;0 on
267 a954aa0a 2021-06-22 stsp success, and&#x00A0;&gt;0 if an error occurs.</p>
268 a954aa0a 2021-06-22 stsp </section>
269 a954aa0a 2021-06-22 stsp <section class="Sh">
270 a954aa0a 2021-06-22 stsp <h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
271 a954aa0a 2021-06-22 stsp ALSO</a></h1>
272 a954aa0a 2021-06-22 stsp <p class="Pp"><a class="Xr">got(1)</a>, <a class="Xr">tog(1)</a>,
273 a954aa0a 2021-06-22 stsp <a class="Xr">git-repository(5)</a>, <a class="Xr">got.conf(5)</a></p>
274 a954aa0a 2021-06-22 stsp </section>
275 a954aa0a 2021-06-22 stsp <section class="Sh">
276 a954aa0a 2021-06-22 stsp <h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
277 a954aa0a 2021-06-22 stsp <p class="Pp"><span class="An">Stefan Sperling</span>
278 a954aa0a 2021-06-22 stsp &lt;<a class="Mt" href="mailto:stsp@openbsd.org">stsp@openbsd.org</a>&gt;
279 a954aa0a 2021-06-22 stsp <br/>
280 a954aa0a 2021-06-22 stsp <span class="An">Ori Bernstein</span>
281 a954aa0a 2021-06-22 stsp &lt;<a class="Mt" href="mailto:ori@openbsd.org">ori@openbsd.org</a>&gt;</p>
282 a954aa0a 2021-06-22 stsp </section>
283 16cd1323 2021-07-26 stsp <section class="Sh">
284 16cd1323 2021-07-26 stsp <h1 class="Sh" id="CAVEATS"><a class="permalink" href="#CAVEATS">CAVEATS</a></h1>
285 16cd1323 2021-07-26 stsp <p class="Pp"><code class="Nm">gotadmin</code> is a work-in-progress and some
286 16cd1323 2021-07-26 stsp features remain to be implemented.</p>
287 16cd1323 2021-07-26 stsp <p class="Pp">At present, the user has to fall back on <a class="Xr">git(1)</a>
288 16cd1323 2021-07-26 stsp to perform some tasks. In particular:</p>
289 16cd1323 2021-07-26 stsp <ul class="Bl-bullet">
290 16cd1323 2021-07-26 stsp <li>Removing redundant or unreferenced packed objects requires
291 16cd1323 2021-07-26 stsp <a class="Xr">git-gc(1)</a> and perhaps
292 16cd1323 2021-07-26 stsp <a class="Xr">git-repack(1)</a>.</li>
293 16cd1323 2021-07-26 stsp <li>Exporting data from repositories requires
294 16cd1323 2021-07-26 stsp <a class="Xr">git-fast-export(1)</a>.</li>
295 16cd1323 2021-07-26 stsp <li>Importing data into repositories requires
296 16cd1323 2021-07-26 stsp <a class="Xr">git-fast-import(1)</a>.</li>
297 16cd1323 2021-07-26 stsp </ul>
298 16cd1323 2021-07-26 stsp </section>
299 16cd1323 2021-07-26 stsp <section class="Sh">
300 16cd1323 2021-07-26 stsp <h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
301 16cd1323 2021-07-26 stsp <p class="Pp">Disk space savings reported by <code class="Cm">gotadmin
302 16cd1323 2021-07-26 stsp cleanup</code> will be misleading if the repository contains object files
303 16cd1323 2021-07-26 stsp that were hard-linked from another repository. Such hard-links will be
304 16cd1323 2021-07-26 stsp created by certain <a class="Xr">git(1)</a> commands. By itself,
305 16cd1323 2021-07-26 stsp <a class="Xr">got(1)</a> will never create hard-linked object files.</p>
306 16cd1323 2021-07-26 stsp </section>
307 a954aa0a 2021-06-22 stsp </div>
308 a954aa0a 2021-06-22 stsp <table class="foot">
309 a954aa0a 2021-06-22 stsp <tr>
310 03b138b5 2022-05-10 stsp <td class="foot-date">May 10, 2022</td>
311 15ba8349 2022-04-24 stsp <td class="foot-os">OpenBSD 7.1</td>
312 a954aa0a 2021-06-22 stsp </tr>
313 a954aa0a 2021-06-22 stsp </table>
314 a954aa0a 2021-06-22 stsp </body>
315 a954aa0a 2021-06-22 stsp </html>