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
