06fbbba2e5
- use `.Os` to show "Void Linux" in the footer - use `Aq Mt` to display email addresses - use `.Lk` for the bug link - remove unnecessary use of `.Nm <name>` when already defined - add xbps-alternatives(1) to SEE ALSO where missing - bump date
132 lines
3.1 KiB
Groff
132 lines
3.1 KiB
Groff
.Dd Feb 9, 2023
|
|
.Dt XBPS-RECONFIGURE 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm xbps-reconfigure
|
|
.Nd XBPS utility to configure installed packages
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op OPTIONS
|
|
.Op PKGNAME...
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility configures or reconfigures packages in target root directory. Configuration
|
|
involves two steps:
|
|
.Pp
|
|
.Sy *
|
|
Executes the
|
|
.Sy post
|
|
ACTION on its
|
|
.Sy INSTALL
|
|
script (which can be shown by running
|
|
.Sy `xbps-query --property=install-script pkg'
|
|
).
|
|
.Pp
|
|
.Sy *
|
|
Changes package state to
|
|
.Sy XBPS_PKG_STATE_INSTALLED
|
|
if previous step ran successfully.
|
|
.Pp
|
|
Only packages that weren't configured previously will be processed,
|
|
unless the
|
|
.Ar -f
|
|
option is specified.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width -x
|
|
.It Fl a, Fl -all
|
|
Configures all packages.
|
|
.It Fl C, Fl -config Ar dir
|
|
Specifies a path to the XBPS configuration directory.
|
|
If the first character is not '/' then it's a relative path of
|
|
.Ar rootdir .
|
|
.It Fl d, Fl -debug
|
|
Enables extra debugging shown to stderr.
|
|
.It Fl f, Fl -force
|
|
Forcefully reconfigure package even if it was configured previously.
|
|
.It Fl h, Fl -help
|
|
Show the help message.
|
|
.It Fl i, Fl -ignore Ar PKG
|
|
Ignore
|
|
.Ar PKG
|
|
when configuring all packages with
|
|
.Fl a, Fl -all .
|
|
The
|
|
.Ar PKG
|
|
argument can be a package name or a package name with version.
|
|
This option can be specified multiple times.
|
|
.It Fl r, Fl -rootdir Ar dir
|
|
Specifies a path for the target root directory.
|
|
.It Fl x, Fl -deps
|
|
Configure
|
|
.Ar PKGNAME...
|
|
and its direct dependencies.
|
|
.It Fl -fulldeptree
|
|
Configure the full dependency tree of
|
|
.Ar PKGNAME...
|
|
when used with
|
|
.Fl x, Fl -deps .
|
|
.
|
|
.It Fl v, Fl -verbose
|
|
Enables verbose messages.
|
|
.It Fl V, Fl -version
|
|
Show the version information.
|
|
.El
|
|
.Sh ENVIRONMENT
|
|
.Bl -tag -width XBPS_TARGET_ARCH
|
|
.It Sy XBPS_ARCH
|
|
Overrides
|
|
.Xr uname 2
|
|
machine result with this value.
|
|
Useful to install packages with a fake architecture
|
|
.It Sy XBPS_TARGET_ARCH
|
|
Sets the target architecture to this value.
|
|
This variable differs from
|
|
.Sy XBPS_ARCH
|
|
in that it allows you to install packages partially, because
|
|
configuration phase is skipped (the target binaries might not be compatible with
|
|
the native architecture).
|
|
.It Sy XBPS_SYSLOG
|
|
Overrides the
|
|
.Xr xbps.d 5
|
|
.Sy syslog=true|false
|
|
configuration option.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width /var/db/xbps/.<pkgname>-files.plist
|
|
.It Ar /etc/xbps.d
|
|
Default configuration directory.
|
|
.It Ar /usr/share/xbps.d
|
|
Default system configuration directory.
|
|
.It Ar /var/db/xbps/.<pkgname>.plist
|
|
Package files metadata.
|
|
.It Ar /var/db/xbps/pkgdb-0.38.plist
|
|
Default package database (0.38 format). Keeps track of installed packages and properties.
|
|
.It Ar /var/cache/xbps
|
|
Default cache directory to store downloaded binary packages.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr xbps-alternatives 1 ,
|
|
.Xr xbps-checkvers 1 ,
|
|
.Xr xbps-create 1 ,
|
|
.Xr xbps-dgraph 1 ,
|
|
.Xr xbps-digest 1 ,
|
|
.Xr xbps-fbulk 1 ,
|
|
.Xr xbps-fetch 1 ,
|
|
.Xr xbps-install 1 ,
|
|
.Xr xbps-pkgdb 1 ,
|
|
.Xr xbps-query 1 ,
|
|
.Xr xbps-remove 1 ,
|
|
.Xr xbps-rindex 1 ,
|
|
.Xr xbps-uchroot 1 ,
|
|
.Xr xbps-uunshare 1 ,
|
|
.Xr xbps.d 5
|
|
.Sh AUTHORS
|
|
.An Juan Romero Pardines Aq Mt xtraeme@gmail.com
|
|
.Sh BUGS
|
|
Probably, but I try to make this not happen. Use it under your own
|
|
responsibility and enjoy your life.
|
|
.Pp
|
|
Report bugs at
|
|
.Lk https://github.com/void-linux/xbps/issues
|