-
Notifications
You must be signed in to change notification settings - Fork 60
/
xtools.1
328 lines (328 loc) · 7.7 KB
/
xtools.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
.Dd June 25, 2019
.Dt XTOOLS 1
.Os
.Sh NAME
.Nm xtools
.Nd A collection of small utilities for use with XBPS
.Sh COMMANDS
.Bl -tag -width x
.It Nm xbarf
.Nd Display build logs of last build
.It Nm xbulk \
Oo Fl n Oc \
Oo Fl k Oc \
Oo Ar xbps-src\ flags Oc \
Ar pkgs ...
.Nd simple XBPS bulk builder
.Bl -tag -offset 2n -width 2n -compact
.It Fl n
dry-run mode
.It Fl k
keep going on errors
.El
.It Nm xbump Ar pkgname Op Ar git\ commit\ options
.Nd git commit a new package or package update.
If
.Ar pkgname
is
.Sq Cm \&: ,
a commit will be made for each template staged in the git index.
.It Nm xchangelog Ar template | pkgname
.Nd open package changelog
.It Nm xcheckmypkgs Op Ar email
.Nd check your packages for updates
.It Nm xcheckrestart Op Fl v
.Nd list programs using outdated libraries
.Bl -tag -offset 2n -width 2n -compact
.It Fl v
verbose mode, also print the library names
.El
.It Nm xchroot Ar directory Op Ar command\ ...
.Nd chroot into a Void (or other Linux) installation
.It Nm xclash
.Nd detect file conflicts between XBPS packages
.It Nm xdbg Ar pkgs ...
.Nd list debugging packages for pkgs and recursive dependencies
.It Nm xdeptree Oo Fl L Ar level Oc Oo Fl R Oc Ar pkgname
.Nd generate a tree of a package's dependencies
.Bl -tag -offset 2n -width 2n -compact
.It Fl L Ar level
Max depth of tree
.It Fl R
Query remote repos
.El
.It Nm xdiff \
Oo Fl u | l Oc \
Op Ar basedir
.Nd merge/diff/list XBPS .new-* files
.Bl -tag -offset 2n -width 2n -compact
.It Fl l
list .new files
.It Fl u
print unified diffs
.El
.It Nm xdistdir
.Nd figure out
.Ev XBPS_DISTDIR
.It Nm xdowngrade Ar pkgfiles.xbps ...
.Nd install XBPS package directly from .xbps file
.It Nm xetcchanges
.Nd show diff of
.Pa /etc
against binary packages
.It Nm xgenfstab \
Oo Fl p | P Oc \
Oo Fl t Ar TAG | Fl L | Fl U Oc \
Ar root
.Nd Generate an
.Xr fstab 5
for a given root.
.Bl -tag -offset 2n -width 2n -compact
.It Fl p
Exclude pseudo-filesystems (default behavior)
.It Fl P
Include pseudo-filesystems
.It Fl t Ar TAG
Use
.Ar TAG
for identifiers
.Po Ar LABEL ,
.Ar UUID ,
.Ar PARTLABEL ,
.Ar PARTUUID Pc
.It Fl L
Use labels for identifiers
.Po same as
.Fl t Ar LABEL Pc
.It Fl U
Use UUIDs for identifiers
.Po same as
.Fl t Ar UUID Pc
.El
.It Nm xgensum \
Oo Fl f Oc \
Oo Fl c Oc \
Oo Fl i Oc \
Oo Fl a Ar arch Oc \
Oo Fl H Ar hostdir Oc \
Ar templates\ ...
.Nd update SHA256 sum in templates
.Bl -tag -offset 2n -width 2n -compact
.It Fl f
force (re-)download of distfiles
.It Fl c
use content checksum
.It Fl i
replace checksum in-place
.It Fl a
architecture to generate the checksum for (default: native or first available architecture)
.It Fl H
absolute path to hostdir
.El
.It Nm xgrep Ar pattern Ar pkgs ...
.Nd search files limited to XBPS package contents
.It Nm xhog
.Nd list installed XBPS packages ordered by size
.It Nm xi Ar pkgs ...
.Nd like
.Ql xbps-install -S ,
but take cwd repo and sudo/su into account
.It Nm xilog Op Ar pattern
.Nd list installed packages by install-date
.It Nm xlg Ar pkg
.Nd open short commit log for XBPS template
.It Nm xlint Ar template | pkgname | Cm \&: Ns Ar pkgname | Cm \&:
.Nd scan XBPS template for common mistakes
.Bl -dash -offset 0n -width 0n -compact
.It
use
.Sq Cm \&: Ns Ar pkgname
to lint template as staged in the git index
.It
use
.Sq Cm \&:
to lint all templates staged in the git index
.El
.It Nm xlocate Fl g | Fl S | Oo Fl EFGPiw Oc Ar pattern
.Nd locate files in all XBPS packages
.Bl -tag -offset 2n -width 2n -compact
.It Fl g
Update a git based xlocate database, useful for local repositories
.It Fl S
Sync with the official git based xlocate database, which is recommended before using the tool
.It Fl E | Fl F | Fl G | Fl P | Fl i | Fl w
Modifies how
.Ar pattern
is matched. See
.Xr git-grep 1
for more info
.El
.It Nm xlog Ar pkg
.Nd open commit log for XBPS template
.It Nm xls Ar pkg ...
.Nd list files contained in pkg (including binpkgs)
.It Nm xmandoc Ar manpage
.Nd read manpage of possibly not installed package
.It Nm xmksv Oo Fl l Oc \
Op Ar newsvdir ...
.Nd create new runit service templates.
Also creates log service if
.Fl l
is passed.
.It Nm xmypkgs Op Ar email
.Nd list all pkgs maintained by you
.It Nm xnew \
Oo Fl a Oc \
Ar pkg \
Op Ar subpkgs ...
.Nd create XBPS template
.Bl -tag -offset 2n -width 2n -compact
.It Fl a
append subpkgs to existing pkg
.El
.It Nm xnews Op Ar pattern
.Nd list news messages for packages by install-date
.It Nm xnodev
.Nd list not installed -devel packages for installed packages
.It Nm xoptdiff \
Oo Fl q Oc \
Op Ar pkgs ...
.Nd show template options which differ from binary package
.Bl -tag -offset 2n -width 2n -compact
.It Fl q
quiet mode, show package names only
.El
.It Nm xpcdeps Ar pcfile ...
.Nd finds package matching the Requires: section of pkg-config files
.It Nm xpkg \
Oo Fl amOHDvV Oc \
Oo Fl r Ar rootdir Oc \
Oo Fl R Ar repo Oc
.Nd convenient package lister
.Bl -tag -offset 2n -width 2n -compact
.It Fl a
list all packages (default: only installed)
.It Fl m
list manual packages
.It Fl O
list orphaned packages
.It Fl H
list packages on hold
.It Fl D
list installed packages not in repo
.It Fl L
list installed packages not from remote repos
.It Fl v
show version numbers
.It Fl V
show version numbers and description
.It Fl r Ar rootdir
specifies a full path for the target root directory
.It Fl R Ar repo
consider only packages from
.Ar repo
.El
.It Nm xpkgdiff \
Oo Fl Sfrxt Oc \
Oo Fl a Ar arch Oc \
Oo Fl R Ar url Oc \
Oo Fl c Ar file Oc \
Oo Fl p Ar prop,... Oc \
Ar pkg
.Nd compare a package in the repositories to the locally-built version
.Bl -dash -offset 0n -width 0n -compact
.It
run from within a void-packages checkout
.It
set DIFF to change the diff program used
.El
.Bl -tag -offset 2n -width 2n -compact
.It Fl S
compare package metadata
.It Fl f
compare package file lists
.It Fl r
reverse diff (compare local to remote)
.It Fl x
compare package dependencies
.It Fl t
compare the full package dependency tree.
Only used with -x (equivalent to xbps-query --fulldeptree -x)
.It Fl a Ar arch
set architecture for comparison
.It Fl R Ar url
set remote repository url
.It Fl c Ar file
compare a file from the package (equivalent to xbps-query --cat)
.It Fl p Ar prop,...
compare properties of the package
.El
.It Nm xpstree
.Nd display tree view of xbps-src processes
.It Nm xq \
Oo Fl R Oc \
Ar pkg ...
.Nd query information about XBPS package
.Bl -tag -offset 2n -width 2n -compact
.It Fl R
query remote repos
.El
.It Nm xrevbump Ar message Ar templates ... Op Ar -\&- git commit options
.Nd increase template revision and commit. Use
.Sq Cm \&-
to read templates from stdin.
.It Nm xrevshlib Ar package
.Nd list packages shlib-dependent on package or its subpackages
.It Nm xrs Ar pattern
.Nd like xbps-query -Rs, but take cwd repo into account
.It Nm xsrc Ar pkg
.Nd list source files for XBPS template
.It Nm xsubpkg \
Oo Fl m Oc \
Ar pkg
.Nd list all subpackages of a package
.Bl -tag -offset 2n -width 2n -compact
.It Fl m
only print main package
.El
.It Nm xtree Ar pkg ...
.Nd list files contained in pkg (including binpkgs) in a
.Xr tree 1
-style format.
If
.Nm tree
is not installed, falls back to
.Nm xls .
.It Nm xuname
.Nd display system info relevant for debugging Void
.It Nm xvoidstrap Ar dir Op Ar packages
.Nd bootstrap a new Void installation
.El
.Sh DESCRIPTION
Tools working on the void-packages tree use
.Nm xdistdir
to find it, check that its output is reasonable first.
.Pp
.Nm xi ,
.Nm xls ,
.Nm xq
and
.Nm xrs
prefer the
.Pa hostdir
/
.Pa binpkgs
repo if you run them from a void-packages checkout.
.Sh LICENSE
.Nm
is in the public domain.
.Pp
To the extent possible under law,
the creator of this work
has waived all copyright and related or
neighboring rights to this work.
.Pp
.Lk http://creativecommons.org/publicdomain/zero/1.0/
.Sh BUGS
All bugs should be reported to
.Lk https://github.com/leahneukirchen/xtools