Blame


1 20662ea0 2021-04-10 stsp .\"
2 20662ea0 2021-04-10 stsp .\" Copyright (c) 2021 Stefan Sperling
3 20662ea0 2021-04-10 stsp .\"
4 20662ea0 2021-04-10 stsp .\" Permission to use, copy, modify, and distribute this software for any
5 20662ea0 2021-04-10 stsp .\" purpose with or without fee is hereby granted, provided that the above
6 20662ea0 2021-04-10 stsp .\" copyright notice and this permission notice appear in all copies.
7 20662ea0 2021-04-10 stsp .\"
8 20662ea0 2021-04-10 stsp .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 20662ea0 2021-04-10 stsp .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 20662ea0 2021-04-10 stsp .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 20662ea0 2021-04-10 stsp .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 20662ea0 2021-04-10 stsp .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 20662ea0 2021-04-10 stsp .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 20662ea0 2021-04-10 stsp .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 20662ea0 2021-04-10 stsp .\"
16 20662ea0 2021-04-10 stsp .Dd $Mdocdate$
17 20662ea0 2021-04-10 stsp .Dt GOTADMIN 1
18 20662ea0 2021-04-10 stsp .Os
19 20662ea0 2021-04-10 stsp .Sh NAME
20 20662ea0 2021-04-10 stsp .Nm gotadmin
21 20662ea0 2021-04-10 stsp .Nd Game of Trees repository administration
22 20662ea0 2021-04-10 stsp .Sh SYNOPSIS
23 20662ea0 2021-04-10 stsp .Nm
24 6a0a1bd4 2022-10-04 op .Op Fl hV
25 20662ea0 2021-04-10 stsp .Ar command
26 20662ea0 2021-04-10 stsp .Op Ar arg ...
27 20662ea0 2021-04-10 stsp .Sh DESCRIPTION
28 20662ea0 2021-04-10 stsp .Nm
29 20662ea0 2021-04-10 stsp is the repository maintenance tool for the
30 20662ea0 2021-04-10 stsp .Xr got 1
31 20662ea0 2021-04-10 stsp version control system.
32 20662ea0 2021-04-10 stsp .Pp
33 20662ea0 2021-04-10 stsp .Xr got 1
34 20662ea0 2021-04-10 stsp stores the history of tracked files in a Git repository, as used
35 20662ea0 2021-04-10 stsp by the Git version control system.
36 20662ea0 2021-04-10 stsp .Nm
37 20662ea0 2021-04-10 stsp provides commands for inspecting and manipulating the on-disk state of
38 20662ea0 2021-04-10 stsp Git repositories.
39 20662ea0 2021-04-10 stsp The repository format is described in
40 20662ea0 2021-04-10 stsp .Xr git-repository 5 .
41 20662ea0 2021-04-10 stsp .Pp
42 20662ea0 2021-04-10 stsp .Nm
43 20662ea0 2021-04-10 stsp provides global and command-specific options.
44 20662ea0 2021-04-10 stsp Global options must precede the command name, and are as follows:
45 20662ea0 2021-04-10 stsp .Bl -tag -width tenletters
46 20662ea0 2021-04-10 stsp .It Fl h
47 20662ea0 2021-04-10 stsp Display usage information and exit immediately.
48 20662ea0 2021-04-10 stsp .It Fl V , -version
49 20662ea0 2021-04-10 stsp Display program version and exit immediately.
50 20662ea0 2021-04-10 stsp .El
51 20662ea0 2021-04-10 stsp .Pp
52 20662ea0 2021-04-10 stsp The commands for
53 20662ea0 2021-04-10 stsp .Nm
54 20662ea0 2021-04-10 stsp are as follows:
55 20662ea0 2021-04-10 stsp .Bl -tag -width checkout
56 6f04a73d 2022-09-20 mark .It Cm init Oo Fl b Ar branch Oc Ar repository-path
57 02a5c5d0 2022-07-04 stsp Create a new empty repository at the specified
58 02a5c5d0 2022-07-04 stsp .Ar repository-path .
59 02a5c5d0 2022-07-04 stsp .Pp
60 02a5c5d0 2022-07-04 stsp After
61 02a5c5d0 2022-07-04 stsp .Cm gotadmin init ,
62 02a5c5d0 2022-07-04 stsp the
63 02a5c5d0 2022-07-04 stsp .Cm got import
64 02a5c5d0 2022-07-04 stsp command must be used to populate the empty repository before
65 02a5c5d0 2022-07-04 stsp .Cm got checkout
66 02a5c5d0 2022-07-04 stsp can be used.
67 6f04a73d 2022-09-20 mark .Pp
68 6f04a73d 2022-09-20 mark The options for
69 6f04a73d 2022-09-20 mark .Cm gotadmin init
70 6f04a73d 2022-09-20 mark are as follows:
71 6f04a73d 2022-09-20 mark .Bl -tag -width Ds
72 6f04a73d 2022-09-20 mark .It Fl b Ar branch
73 6f04a73d 2022-09-20 mark Make the repository's HEAD reference point to the specified
74 6f04a73d 2022-09-20 mark .Ar branch
75 6f04a73d 2022-09-20 mark instead of the default branch
76 6f04a73d 2022-09-20 mark .Dq main .
77 6f04a73d 2022-09-20 mark .El
78 5fc4f020 2022-08-30 op .It Cm info Op Fl r Ar repository-path
79 20662ea0 2021-04-10 stsp Display information about a repository.
80 20662ea0 2021-04-10 stsp This includes some configuration settings from
81 20662ea0 2021-04-10 stsp .Xr got.conf 5 ,
82 20662ea0 2021-04-10 stsp and the number of objects stored in the repository, in packed or
83 20662ea0 2021-04-10 stsp loose form, as well as the current on-disk size of these objects.
84 20662ea0 2021-04-10 stsp .Pp
85 20662ea0 2021-04-10 stsp The options for
86 20662ea0 2021-04-10 stsp .Cm gotadmin info
87 20662ea0 2021-04-10 stsp are as follows:
88 20662ea0 2021-04-10 stsp .Bl -tag -width Ds
89 20662ea0 2021-04-10 stsp .It Fl r Ar repository-path
90 20662ea0 2021-04-10 stsp Use the repository at the specified path.
91 20662ea0 2021-04-10 stsp If not specified, assume the repository is located at or above the current
92 20662ea0 2021-04-10 stsp working directory.
93 7d69d862 2021-11-15 stsp If this directory is a
94 7d69d862 2021-11-15 stsp .Xr got 1
95 7d69d862 2021-11-15 stsp work tree, use the repository path associated with this work tree.
96 20662ea0 2021-04-10 stsp .El
97 5fc4f020 2022-08-30 op .It Xo
98 5fc4f020 2022-08-30 op .Cm pack
99 c7a4fcc8 2023-02-17 op .Op Fl aDq
100 5fc4f020 2022-08-30 op .Op Fl r Ar repository-path
101 5fc4f020 2022-08-30 op .Op Fl x Ar reference
102 5fc4f020 2022-08-30 op .Op Ar reference ...
103 5fc4f020 2022-08-30 op .Xc
104 05118f5a 2021-06-22 stsp Generate a new pack file and a corresponding pack file index.
105 05118f5a 2021-06-22 stsp By default, add any loose objects which are reachable via any references
106 05118f5a 2021-06-22 stsp to the generated pack file.
107 05118f5a 2021-06-22 stsp .Pp
108 05118f5a 2021-06-22 stsp If one or more
109 05118f5a 2021-06-22 stsp .Ar reference
110 05118f5a 2021-06-22 stsp arguments is specified, only add objects which are reachable via the specified
111 05118f5a 2021-06-22 stsp references.
112 05118f5a 2021-06-22 stsp Each
113 05118f5a 2021-06-22 stsp .Ar reference
114 05118f5a 2021-06-22 stsp argument may either specify a specific reference or a reference namespace,
115 05118f5a 2021-06-22 stsp in which case all references within this namespace will be used.
116 05118f5a 2021-06-22 stsp .Pp
117 05118f5a 2021-06-22 stsp .Cm gotadmin pack
118 05118f5a 2021-06-22 stsp always ignores references in the
119 05118f5a 2021-06-22 stsp .Pa refs/got/
120 05118f5a 2021-06-22 stsp namespace, effectively treating such references as if they did not refer
121 05118f5a 2021-06-22 stsp to any objects.
122 05118f5a 2021-06-22 stsp .Pp
123 05118f5a 2021-06-22 stsp The options for
124 05118f5a 2021-06-22 stsp .Cm gotadmin pack
125 05118f5a 2021-06-22 stsp are as follows:
126 05118f5a 2021-06-22 stsp .Bl -tag -width Ds
127 05118f5a 2021-06-22 stsp .It Fl a
128 05118f5a 2021-06-22 stsp Add objects to the generated pack file even if they are already packed
129 05118f5a 2021-06-22 stsp in a different pack file.
130 05118f5a 2021-06-22 stsp Unless this option is specified, only loose objects will be added.
131 c7a4fcc8 2023-02-17 op .It Fl D
132 c7a4fcc8 2023-02-17 op Force the use of ref-delta representation for deltified objects.
133 c7a4fcc8 2023-02-17 op If this option is not specified, offset-deltas will be used to represent
134 c7a4fcc8 2023-02-17 op deltified objects.
135 827a167b 2022-08-16 stsp .It Fl q
136 827a167b 2022-08-16 stsp Suppress progress reporting output.
137 05118f5a 2021-06-22 stsp .It Fl r Ar repository-path
138 05118f5a 2021-06-22 stsp Use the repository at the specified path.
139 05118f5a 2021-06-22 stsp If not specified, assume the repository is located at or above the current
140 05118f5a 2021-06-22 stsp working directory.
141 7d69d862 2021-11-15 stsp If this directory is a
142 7d69d862 2021-11-15 stsp .Xr got 1
143 7d69d862 2021-11-15 stsp work tree, use the repository path associated with this work tree.
144 05118f5a 2021-06-22 stsp .It Fl x Ar reference
145 05118f5a 2021-06-22 stsp Exclude objects reachable via the specified
146 05118f5a 2021-06-22 stsp .Ar reference
147 05118f5a 2021-06-22 stsp from the pack file.
148 05118f5a 2021-06-22 stsp The
149 05118f5a 2021-06-22 stsp .Ar reference
150 05118f5a 2021-06-22 stsp argument may either specify a specific reference or a reference namespace,
151 05118f5a 2021-06-22 stsp in which case all references within this namespace will be excluded.
152 05118f5a 2021-06-22 stsp The
153 05118f5a 2021-06-22 stsp .Fl x
154 05118f5a 2021-06-22 stsp option may be specified multiple times to build a list of references to exclude.
155 05118f5a 2021-06-22 stsp .Pp
156 05118f5a 2021-06-22 stsp Exclusion takes precedence over inclusion.
157 05118f5a 2021-06-22 stsp If a reference appears in both the included and excluded lists, it will
158 05118f5a 2021-06-22 stsp be excluded.
159 20662ea0 2021-04-10 stsp .El
160 b13a4ebc 2021-10-06 kn .Tg ix
161 05118f5a 2021-06-22 stsp .It Cm indexpack Ar packfile-path
162 4683a10b 2021-11-04 kn .Dl Pq alias: Cm ix
163 05118f5a 2021-06-22 stsp Create a pack index for the pack file at
164 05118f5a 2021-06-22 stsp .Ar packfile-path .
165 05118f5a 2021-06-22 stsp .Pp
166 05118f5a 2021-06-22 stsp A pack index is required for using the corresponding pack file with
167 05118f5a 2021-06-22 stsp .Xr got 1 .
168 05118f5a 2021-06-22 stsp Usually, a pack index will be created by commands such as
169 05118f5a 2021-06-22 stsp .Cm gotadmin pack
170 05118f5a 2021-06-22 stsp or
171 05118f5a 2021-06-22 stsp .Cm got fetch
172 05118f5a 2021-06-22 stsp as part of regular operation.
173 05118f5a 2021-06-22 stsp The
174 05118f5a 2021-06-22 stsp .Cm gotadmin indexpack
175 05118f5a 2021-06-22 stsp command may be used to recover from a corrupt or missing index.
176 05118f5a 2021-06-22 stsp A given pack file will always yield the same bit-identical index.
177 05118f5a 2021-06-22 stsp .Pp
178 05118f5a 2021-06-22 stsp The provided
179 05118f5a 2021-06-22 stsp .Ar packfile-path
180 05118f5a 2021-06-22 stsp must be located within the
181 05118f5a 2021-06-22 stsp .Pa objects/pack/
182 05118f5a 2021-06-22 stsp directory of the repository and should end in
183 05118f5a 2021-06-22 stsp .Pa .pack .
184 05118f5a 2021-06-22 stsp The filename of the corresponding pack index is equivalent, except
185 05118f5a 2021-06-22 stsp that it ends in
186 05118f5a 2021-06-22 stsp .Pa .idx .
187 b13a4ebc 2021-10-06 kn .Tg ls
188 5fc4f020 2022-08-30 op .It Xo
189 5fc4f020 2022-08-30 op .Cm listpack
190 5fc4f020 2022-08-30 op .Op Fl hs
191 5fc4f020 2022-08-30 op .Ar packfile-path
192 5fc4f020 2022-08-30 op .Xc
193 4683a10b 2021-11-04 kn .Dl Pq alias: Cm ls
194 05118f5a 2021-06-22 stsp List the contents of the pack file at
195 05118f5a 2021-06-22 stsp .Ar packfile-path .
196 05118f5a 2021-06-22 stsp .Pp
197 05118f5a 2021-06-22 stsp Each object contained in the pack file will be displayed on a single line.
198 05118f5a 2021-06-22 stsp The information shown includes the object ID, object type, object offset,
199 05118f5a 2021-06-22 stsp and object size.
200 05118f5a 2021-06-22 stsp .Pp
201 e38d4cde 2022-03-21 naddy If a packed object is deltified against another object, the delta base
202 05118f5a 2021-06-22 stsp will be shown as well.
203 05118f5a 2021-06-22 stsp For offset deltas, the delta base is identified via an offset into the
204 05118f5a 2021-06-22 stsp pack file.
205 05118f5a 2021-06-22 stsp For reference deltas, the delta base is identified via an object ID.
206 05118f5a 2021-06-22 stsp .Pp
207 05118f5a 2021-06-22 stsp The provided
208 05118f5a 2021-06-22 stsp .Ar packfile-path
209 05118f5a 2021-06-22 stsp must be located within the
210 05118f5a 2021-06-22 stsp .Pa objects/pack/
211 05118f5a 2021-06-22 stsp directory of the repository and should end in
212 05118f5a 2021-06-22 stsp .Pa .pack .
213 8e26059c 2022-03-10 stsp The corresponding pack index must exist and can be created with
214 8e26059c 2022-03-10 stsp .Cm gotadmin indexpack
215 8e26059c 2022-03-10 stsp if it is missing.
216 05118f5a 2021-06-22 stsp .Pp
217 05118f5a 2021-06-22 stsp The options for
218 05118f5a 2021-06-22 stsp .Cm gotadmin listpack
219 05118f5a 2021-06-22 stsp are as follows:
220 05118f5a 2021-06-22 stsp .Bl -tag -width Ds
221 05118f5a 2021-06-22 stsp .It Fl h
222 05118f5a 2021-06-22 stsp Show object sizes in human-readable form.
223 05118f5a 2021-06-22 stsp .It Fl s
224 0c079dbc 2021-10-06 kn Display statistics about the pack file after listing objects.
225 05118f5a 2021-06-22 stsp This includes the total number of objects stored in the pack file
226 05118f5a 2021-06-22 stsp and a break-down of the number of objects per object type.
227 05118f5a 2021-06-22 stsp .El
228 b13a4ebc 2021-10-06 kn .Tg cl
229 5fc4f020 2022-08-30 op .It Xo
230 5fc4f020 2022-08-30 op .Cm cleanup
231 5fc4f020 2022-08-30 op .Op Fl anpq
232 5fc4f020 2022-08-30 op .Op Fl r Ar repository-path
233 5fc4f020 2022-08-30 op .Xc
234 4683a10b 2021-11-04 kn .Dl Pq alias: Cm cl
235 9a7c12cf 2023-06-18 op Purge unreferenced loose objects and redundant pack files from the
236 9a7c12cf 2023-06-18 op repository and display the amount of disk space which has been freed
237 9a7c12cf 2023-06-18 op as a result.
238 b3d68e7f 2021-07-03 stsp .Pp
239 b3d68e7f 2021-07-03 stsp Unreferenced objects are present in the repository but cannot be
240 b3d68e7f 2021-07-03 stsp reached via any reference in the entire
241 b3d68e7f 2021-07-03 stsp .Pa refs/
242 b3d68e7f 2021-07-03 stsp namespace.
243 af386a8b 2023-06-18 stsp Objects will usually become unreferenced as a result of deleting
244 cbb6b806 2023-06-18 stsp branches, tags, or other references with
245 cbb6b806 2023-06-18 stsp .Cm got branch -d ,
246 cbb6b806 2023-06-18 stsp .Cm got ref -d ,
247 af386a8b 2023-06-18 stsp or
248 cbb6b806 2023-06-18 stsp .Cm got fetch -X .
249 b3d68e7f 2021-07-03 stsp .Pp
250 b3d68e7f 2021-07-03 stsp Loose objects are stored as individual files beneath the repository's
251 b3d68e7f 2021-07-03 stsp .Pa objects/
252 b3d68e7f 2021-07-03 stsp directory,
253 b3d68e7f 2021-07-03 stsp spread across 256 sub-directories named after the 256 possible
254 b3d68e7f 2021-07-03 stsp hexadecimal values of the first byte of an object identifier.
255 b3d68e7f 2021-07-03 stsp .Pp
256 9a7c12cf 2023-06-18 op Packed objects are stored in pack files under
257 9a7c12cf 2023-06-18 op .Pa objects/pack/ .
258 9a7c12cf 2023-06-18 op .Pp
259 9a7c12cf 2023-06-18 op If redundant copies of packed objects exist in loose form, such
260 9a7c12cf 2023-06-18 op redundant copies will be purged.
261 9a7c12cf 2023-06-18 op If all the objects of a pack file are present in other pack files,
262 9a7c12cf 2023-06-18 op the redundant pack file will be purged.
263 9a7c12cf 2023-06-18 op Pack files will usually become redundant as a result of repacking the
264 9a7c12cf 2023-06-18 op repository with
265 9a7c12cf 2023-06-18 op .Nm
266 9a7c12cf 2023-06-18 op .Cm pack Fl a .
267 9a7c12cf 2023-06-18 op .Pp
268 b3d68e7f 2021-07-03 stsp References in the
269 b3d68e7f 2021-07-03 stsp .Pa refs/got
270 b3d68e7f 2021-07-03 stsp namespace may prevent objects from being purged.
271 b3d68e7f 2021-07-03 stsp This includes references in the
272 b3d68e7f 2021-07-03 stsp .Pa refs/got/worktree
273 b3d68e7f 2021-07-03 stsp namespace created by
274 b3d68e7f 2021-07-03 stsp .Cm got checkout
275 b3d68e7f 2021-07-03 stsp and
276 b3d68e7f 2021-07-03 stsp .Cm got update ,
277 b3d68e7f 2021-07-03 stsp as well as references in the
278 b3d68e7f 2021-07-03 stsp .Pa refs/got/backup
279 b3d68e7f 2021-07-03 stsp namespace created by
280 b3d68e7f 2021-07-03 stsp .Cm got rebase
281 b3d68e7f 2021-07-03 stsp and
282 b3d68e7f 2021-07-03 stsp .Cm got histedit .
283 b3d68e7f 2021-07-03 stsp .Cm gotadmin cleanup
284 b3d68e7f 2021-07-03 stsp will only purge corresponding objects once such references have been
285 b3d68e7f 2021-07-03 stsp deleted with
286 c5058f5d 2023-06-18 stsp .Cm got rebase -X ,
287 c5058f5d 2023-06-18 stsp .Cm got histedit -X ,
288 c5058f5d 2023-06-18 stsp or
289 b3d68e7f 2021-07-03 stsp .Cm got ref -d .
290 9188bd78 2021-07-03 stsp .Pp
291 af386a8b 2023-06-18 stsp The
292 af386a8b 2023-06-18 stsp .Dq preciousObjects
293 af386a8b 2023-06-18 stsp Git extension is intended to prevent the removal of objects from a repository.
294 af386a8b 2023-06-18 stsp .Cm gotadmin cleanup
295 af386a8b 2023-06-18 stsp will refuse to operate on repositories where this extension is active.
296 af386a8b 2023-06-18 stsp .Pp
297 af386a8b 2023-06-18 stsp For compatibility with Git, if a file with the extension
298 af386a8b 2023-06-18 stsp .Pa .keep
299 af386a8b 2023-06-18 stsp exists and corresponds to a pack file with the extension
300 af386a8b 2023-06-18 stsp .Pa .pack
301 af386a8b 2023-06-18 stsp then this pack file will not be removed.
302 af386a8b 2023-06-18 stsp .Pp
303 1124fe40 2021-07-07 stsp Some Git repositories contain pack index files which lack a corresponding
304 1124fe40 2021-07-07 stsp pack file, which is an inconsistent repository state.
305 1124fe40 2021-07-07 stsp In such cases,
306 1124fe40 2021-07-07 stsp .Cm gotadmin cleanup -p -n
307 1124fe40 2021-07-07 stsp will display a list of affected pack index files.
308 e38d4cde 2022-03-21 naddy Whenever possible, the missing pack files should be restored.
309 e38d4cde 2022-03-21 naddy If restoring missing pack files is not possible, then affected pack index
310 1124fe40 2021-07-07 stsp files can be removed with
311 1124fe40 2021-07-07 stsp .Cm gotadmin cleanup -p .
312 1124fe40 2021-07-07 stsp .Pp
313 b3d68e7f 2021-07-03 stsp The options for
314 d4445ca5 2021-07-03 stsp .Cm gotadmin cleanup
315 b3d68e7f 2021-07-03 stsp are as follows:
316 b3d68e7f 2021-07-03 stsp .Bl -tag -width Ds
317 ef8ec606 2021-07-27 stsp .It Fl a
318 87bd0c08 2023-10-16 op Delete all redundant loose and packed objects.
319 ef8ec606 2021-07-27 stsp By default, objects which are newer than an implementation-defined
320 ef8ec606 2021-07-27 stsp modification timestamp are kept on disk to prevent race conditions
321 ef8ec606 2021-07-27 stsp with other commands that add new objects to the repository while
322 ef8ec606 2021-07-27 stsp .Cm gotadmin cleanup
323 ef8ec606 2021-07-27 stsp is running.
324 b3d68e7f 2021-07-03 stsp .It Fl n
325 b3d68e7f 2021-07-03 stsp Display the usual progress output and summary information but do not actually
326 1124fe40 2021-07-07 stsp remove any files from disk.
327 827a167b 2022-08-16 stsp .It Fl p
328 9cb53404 2023-06-18 stsp Instead of purging unreferenced loose objects and redundant pack files,
329 9cb53404 2023-06-18 stsp remove any pack index files which do not have a corresponding pack file.
330 827a167b 2022-08-16 stsp .It Fl q
331 827a167b 2022-08-16 stsp Suppress progress reporting and disk space summary output.
332 2df845d5 2023-07-07 op .It Fl r Ar repository-path
333 2df845d5 2023-07-07 op Use the repository at the specified path.
334 2df845d5 2023-07-07 op If not specified, assume the repository is located at or above the current
335 2df845d5 2023-07-07 op working directory.
336 2df845d5 2023-07-07 op If this directory is a
337 2df845d5 2023-07-07 op .Xr got 1
338 2df845d5 2023-07-07 op work tree, use the repository path associated with this work tree.
339 2df845d5 2023-07-07 op .El
340 2df845d5 2023-07-07 op .It Xo
341 2df845d5 2023-07-07 op .Cm dump
342 2df845d5 2023-07-07 op .Op Fl q
343 2df845d5 2023-07-07 op .Op Fl r Ar repository-path
344 2df845d5 2023-07-07 op .Op Fl x Ar reference
345 2df845d5 2023-07-07 op .Op Ar reference ...
346 2df845d5 2023-07-07 op .Xc
347 ca4f2e18 2023-07-10 stsp Dump the contents of the repository to standard output in Git bundle format.
348 2df845d5 2023-07-07 op .Pp
349 2df845d5 2023-07-07 op If one or more
350 2df845d5 2023-07-07 op .Ar reference
351 2df845d5 2023-07-07 op arguments is specified, only add objects which are reachable via the specified
352 2df845d5 2023-07-07 op references.
353 2df845d5 2023-07-07 op Each
354 2df845d5 2023-07-07 op .Ar reference
355 2df845d5 2023-07-07 op argument may either specify a specific reference or a reference namespace,
356 2df845d5 2023-07-07 op in which case all references within this namespace will be used.
357 2df845d5 2023-07-07 op .Pp
358 2df845d5 2023-07-07 op The options for
359 2df845d5 2023-07-07 op .Nm
360 2df845d5 2023-07-07 op .Cm dump
361 2df845d5 2023-07-07 op are as follows:
362 2df845d5 2023-07-07 op .Bl -tag -width Ds
363 2df845d5 2023-07-07 op .It Fl q
364 2df845d5 2023-07-07 op Suppress progress reporting output.
365 b3d68e7f 2021-07-03 stsp .It Fl r Ar repository-path
366 b3d68e7f 2021-07-03 stsp Use the repository at the specified path.
367 b3d68e7f 2021-07-03 stsp If not specified, assume the repository is located at or above the current
368 b3d68e7f 2021-07-03 stsp working directory.
369 7d69d862 2021-11-15 stsp If this directory is a
370 7d69d862 2021-11-15 stsp .Xr got 1
371 7d69d862 2021-11-15 stsp work tree, use the repository path associated with this work tree.
372 2df845d5 2023-07-07 op .It Fl x Ar reference
373 2df845d5 2023-07-07 op Exclude objects reachable via the specified
374 2df845d5 2023-07-07 op .Ar reference
375 ca4f2e18 2023-07-10 stsp from the bundle.
376 2df845d5 2023-07-07 op The
377 2df845d5 2023-07-07 op .Ar reference
378 2df845d5 2023-07-07 op argument may either specify a specific reference or a reference namespace,
379 2df845d5 2023-07-07 op in which case all references within this namespace will be excluded.
380 2df845d5 2023-07-07 op The
381 2df845d5 2023-07-07 op .Fl x
382 2df845d5 2023-07-07 op option may be specified multiple times to build a list of references to exclude.
383 2df845d5 2023-07-07 op .Pp
384 2df845d5 2023-07-07 op Exclusion takes precedence over inclusion.
385 2df845d5 2023-07-07 op If a reference appears in both the included and excluded lists, it will
386 2df845d5 2023-07-07 op be excluded.
387 f7d653fc 2023-07-09 op .El
388 f7d653fc 2023-07-09 op .It Xo
389 f7d653fc 2023-07-09 op .Cm load
390 02a7e21b 2023-07-10 stsp .Op Fl nq
391 02a7e21b 2023-07-10 stsp .Op Fl l Ar bundle-path
392 f7d653fc 2023-07-09 op .Op Fl r Ar repository-path
393 02a7e21b 2023-07-10 stsp .Op Ar reference ...
394 f7d653fc 2023-07-09 op .Xc
395 02a7e21b 2023-07-10 stsp Read a Git bundle stream from standard input and load its data into
396 02a7e21b 2023-07-10 stsp a repository.
397 f7d653fc 2023-07-09 op .Pp
398 02a7e21b 2023-07-10 stsp If one or more
399 02a7e21b 2023-07-10 stsp .Ar reference
400 02a7e21b 2023-07-10 stsp arguments are provided then only load the specified references
401 02a7e21b 2023-07-10 stsp from the bundle.
402 02a7e21b 2023-07-10 stsp Otherwise, all references will be loaded.
403 02a7e21b 2023-07-10 stsp .Pp
404 f7d653fc 2023-07-09 op The options for
405 8736d68f 2023-07-10 stsp .Cm gotadmin load
406 f7d653fc 2023-07-09 op are as follows:
407 f7d653fc 2023-07-09 op .Bl -tag -width Ds
408 02a7e21b 2023-07-10 stsp .It Fl l Ar bundle-path
409 02a7e21b 2023-07-10 stsp List references available for loading from the bundle at the specified
410 02a7e21b 2023-07-10 stsp .Ar bundle-path
411 02a7e21b 2023-07-10 stsp and exit immediately.
412 02a7e21b 2023-07-10 stsp If the
413 02a7e21b 2023-07-10 stsp .Fl l
414 02a7e21b 2023-07-10 stsp option is specified then no
415 f7d653fc 2023-07-09 op .Ar reference
416 02a7e21b 2023-07-10 stsp arguments are allowed.
417 02a7e21b 2023-07-10 stsp The
418 02a7e21b 2023-07-10 stsp .Fl l
419 02a7e21b 2023-07-10 stsp option is incompatible with the
420 02a7e21b 2023-07-10 stsp .Fl n
421 02a7e21b 2023-07-10 stsp option.
422 f7d653fc 2023-07-09 op .It Fl n
423 ca4f2e18 2023-07-10 stsp Attempt to load the bundle but don't install new packfile or update any
424 f7d653fc 2023-07-09 op reference.
425 ca4f2e18 2023-07-10 stsp Can be used to verify the integrity of the bundle.
426 f7d653fc 2023-07-09 op .It Fl q
427 f7d653fc 2023-07-09 op Suppress progress reporting output.
428 f7d653fc 2023-07-09 op .It Fl r Ar repository-path
429 f7d653fc 2023-07-09 op Use the repository at the specified path.
430 f7d653fc 2023-07-09 op If not specified, assume the repository is located at or above the
431 f7d653fc 2023-07-09 op current working directory.
432 f7d653fc 2023-07-09 op If this directory is a
433 f7d653fc 2023-07-09 op .Xr got 1
434 f7d653fc 2023-07-09 op work tree, use the repository path associated with this work tree.
435 05118f5a 2021-06-22 stsp .El
436 b3d68e7f 2021-07-03 stsp .El
437 20662ea0 2021-04-10 stsp .Sh EXIT STATUS
438 20662ea0 2021-04-10 stsp .Ex -std gotadmin
439 20662ea0 2021-04-10 stsp .Sh SEE ALSO
440 20662ea0 2021-04-10 stsp .Xr got 1 ,
441 20662ea0 2021-04-10 stsp .Xr tog 1 ,
442 20662ea0 2021-04-10 stsp .Xr git-repository 5 ,
443 20662ea0 2021-04-10 stsp .Xr got.conf 5
444 20662ea0 2021-04-10 stsp .Sh AUTHORS
445 8ca658b9 2022-07-05 stsp .An Christian Weisgerber Aq Mt naddy@openbsd.org
446 8ca658b9 2022-07-05 stsp .An Josh Rickmar Aq Mt jrick@zettaport.com
447 8ca658b9 2022-07-05 stsp .An Klemens Nanni Aq Mt kn@openbsd.org
448 ea4587d8 2023-06-18 op .An Omar Polo Aq Mt op@openbsd.org
449 05118f5a 2021-06-22 stsp .An Ori Bernstein Aq Mt ori@openbsd.org
450 8ca658b9 2022-07-05 stsp .An Stefan Sperling Aq Mt stsp@openbsd.org
451 8ca658b9 2022-07-05 stsp .An Tracey Emery Aq Mt tracey@traceyemery.net
452 7e36bc2b 2021-06-25 stsp .Sh CAVEATS
453 7e36bc2b 2021-06-25 stsp .Nm
454 7e36bc2b 2021-06-25 stsp is a work-in-progress and some features remain to be implemented.
455 7e36bc2b 2021-06-25 stsp .Pp
456 7e36bc2b 2021-06-25 stsp At present, the user has to fall back on
457 7e36bc2b 2021-06-25 stsp .Xr git 1
458 7e36bc2b 2021-06-25 stsp to perform some tasks.
459 7e36bc2b 2021-06-25 stsp In particular:
460 7e36bc2b 2021-06-25 stsp .Bl -bullet
461 7e36bc2b 2021-06-25 stsp .It
462 7e36bc2b 2021-06-25 stsp Exporting data from repositories requires
463 7e36bc2b 2021-06-25 stsp .Xr git-fast-export 1 .
464 7e36bc2b 2021-06-25 stsp .It
465 7e36bc2b 2021-06-25 stsp Importing data into repositories requires
466 7e36bc2b 2021-06-25 stsp .Xr git-fast-import 1 .
467 7e36bc2b 2021-06-25 stsp .El
468 aaf7c342 2021-07-03 stsp .Sh BUGS
469 aaf7c342 2021-07-03 stsp Disk space savings reported by
470 aaf7c342 2021-07-03 stsp .Cm gotadmin cleanup
471 aaf7c342 2021-07-03 stsp will be misleading if the repository contains object files that were
472 aaf7c342 2021-07-03 stsp hard-linked from another repository.
473 aaf7c342 2021-07-03 stsp Such hard-links will be created by certain
474 aaf7c342 2021-07-03 stsp .Xr git 1
475 aaf7c342 2021-07-03 stsp commands.
476 aaf7c342 2021-07-03 stsp By itself,
477 aaf7c342 2021-07-03 stsp .Xr got 1
478 aaf7c342 2021-07-03 stsp will never create hard-linked object files.