about summary refs log tree commit diff
path: root/README
blob: dff0baabf3891d9c87d280f61915731ebed0b1ef (plain) (blame)
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
XTOOLS(1)                   General Commands Manual                  XTOOLS(1)

NAME
     xtools – A collection of small utilities for use with XBPS

COMMANDS
     xbarf
        – Display build logs of last build

     xbuildbarf [arch]
        – Spy on current buildbot output

     xbulk [-n] [-k] [xbps-src flags] pkgs ...
        – simple XBPS bulk builder
          -n  dry-run mode
          -k  keep going on errors

     xbump pkgname [git commit options]
        – git commit a new package or package update

     xchangelog template | pkgname
        – open package changelog

     xcheckmypkgs [email]
        – check your packages for updates

     xcheckrestart [-v]
        – list programs using outdated libraries
          -v  verbose mode, also print the library names

     xchroot directory [command ...]
        – chroot into a Void (or other Linux) installation

     xclash
        – detect file conflicts between XBPS packages

     xdbg pkgs ...
        – list debugging packages for pkgs and recursive dependencies

     xdiff [-u | -l] [basedir]
        – merge/diff/list XBPS .new-* files
          -l  list .new files
          -u  print unified diffs

     xdistdir
        – figure out XBPS_DISTDIR

     xdowngrade pkgfiles.xbps ...
        – install XBPS package directly from .xbps file

     xetcchanges
        – show diff of /etc against binary packages

     xgensum [-f] [-c] [-i] [-H hostdir] templates ...
        – update SHA256 sum in templates
          -f  force (re-)download of distfiles
          -c  use content checksum
          -i  replace checksum in-place
          -H  absolute path to hostdir

     xgrep pattern pkgs ...
        – search files limited to XBPS package contents

     xhog
        – list installed XBPS packages ordered by size

     xi pkgs ...
        – like ‘xbps-install -S’, but take cwd repo and sudo/su into account

     xilog [pattern]
        – list installed packages by install-date

     xlg pkg
        – open short commit log for XBPS template

     xlint template | pkgname | :pkgname | :
        – scan XBPS template for common mistakes
        - use ‘:pkgname’ to lint template as staged in the git index
        - use ‘:’ to lint all templates staged in the git index

     xlocate -g | -S | [-EFGPiw] pattern
        – locate files in all XBPS packages
          -g  Update a git based xlocate database, useful for local
              repositories
          -S  Sync with the official git based xlocate database, which is
              recommended before using the tool
          -E | -F | -G | -P | -i | -w
              Modifies how pattern is matched. See git-grep(1) for more info

     xlog pkg
        – open commit log for XBPS template

     xls pkg ...
        – list files contained in pkg (including binpkgs)

     xmandoc manpage
        – read manpage of possibly not installed package

     xmksv [-l] [newsvdir ...]
        – create new runit service templates. Also creates log service if -l
        is passed.

     xmypkgs [email]
        – list all pkgs maintained by you

     xnew [-a] pkg [subpkgs ...]
        – create XBPS template
          -a  append subpkgs to existing pkg

     xnews [pattern]
        – list news messages for packages by install-date

     xnodev
        – list not installed -devel packages for installed packages

     xoptdiff [-q] [pkgs ...]
        – show template options which differ from binary package
          -q  quiet mode, show package names only

     xpcdeps pcfile ...
        – finds package matching the Requires: section of pkg-config files

     xpkg [-amOHDvV] [-r rootdir] [-R repo]
        – convenient package lister
          -a  list all packages (default: only installed)
          -m  list manual packages
          -O  list orphaned packages
          -H  list packages on hold
          -D  list installed packages not in repo
          -L  list installed packages not from remote repos
          -v  show version numbers
          -V  show version numbers and description
          -r rootdir
              specifies a full path for the target root directory
          -R repo
              consider only packages from repo

     xpkgdiff [-Sfrxt] [-a arch] [-R url] [-c file] [-p prop,...] pkg
        – compare a package in the repositories to the locally-built version
        - run from within a void-packages checkout
        - set DIFF to change the diff program used
          -S  compare package metadata
          -f  compare package file lists
          -r  reverse diff (compare local to remote)
          -x  compare package dependencies
          -t  compare the full package dependency tree.  Only used with -x
              (equivalent to xbps-query --fulldeptree -x)
          -a arch
              set architecture for comparison
          -R url
              set remote repository url
          -c file
              compare a file from the package (equivalent to xbps-query --cat)
          -p prop,...
              compare properties of the package

     xpstree
        – display tree view of xbps-src processes

     xq [-R] pkg ...
        – query information about XBPS package
          -R  query remote repos

     xrecent [repourl | arch]
        – list packages in repo ordered by build date

     xrevbump message templates ... [-- git commit options]
        – increase template revision and commit. Use ‘-’ to read templates
        from stdin.

     xrevshlib package
        – list packages shlib-dependent on package or its subpackages

     xrs pattern
        – like xbps-query -Rs, but take cwd repo into account

     xsrc pkg
        – list source files for XBPS template

     xsubpkg [-m] pkg
        – list all subpackages of a package
          -m  only print main package

     xuname
        – display system info relevant for debugging Void

     xvoidstrap dir [packages]
        – bootstrap a new Void installation

DESCRIPTION
     Tools working on the void-packages tree use xdistdir to find it, check
     that its output is reasonable first.

     xi, xls, xq and xrs prefer the hostdir / binpkgs repo if you run them
     from a void-packages checkout.

LICENSE
     xtools is in the public domain.

     To the extent possible under law, the creator of this work has waived all
     copyright and related or neighboring rights to this work.

     http://creativecommons.org/publicdomain/zero/1.0/

BUGS
     All bugs should be reported to https://github.com/leahneukirchen/xtools

Void Linux                       June 25, 2019                      Void Linux