xbps/bin/xbps-reconfigure/xbps-reconfigure.1

132 lines
3.1 KiB
Groff
Raw Permalink Normal View History

.Dd Feb 9, 2023
.Dt XBPS-RECONFIGURE 1
.Os
2012-11-03 15:48:10 +05:30
.Sh NAME
.Nm xbps-reconfigure
.Nd XBPS utility to configure installed packages
2015-10-30 11:15:26 +05:30
.Sh SYNOPSIS
.Nm
2012-11-03 15:48:10 +05:30
.Op OPTIONS
.Op PKGNAME...
.Sh DESCRIPTION
The
.Nm
utility configures or reconfigures packages in target root directory. Configuration
2012-11-03 15:48:10 +05:30
involves two steps:
.Pp
.Sy *
Executes the
.Sy post
ACTION on its
2012-11-03 15:48:10 +05:30
.Sy INSTALL
script (which can be shown by running
.Sy `xbps-query --property=install-script pkg'
).
2012-11-03 15:48:10 +05:30
.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
2012-11-06 15:03:29 +05:30
.Bl -tag -width -x
2012-11-05 14:09:10 +05:30
.It Fl a, Fl -all
2012-11-03 15:48:10 +05:30
Configures all packages.
.It Fl C, Fl -config Ar dir
Specifies a path to the XBPS configuration directory.
2017-07-11 08:00:03 +05:30
If the first character is not '/' then it's a relative path of
.Ar rootdir .
2012-11-05 14:09:10 +05:30
.It Fl d, Fl -debug
2012-11-03 15:48:10 +05:30
Enables extra debugging shown to stderr.
2012-11-05 14:09:10 +05:30
.It Fl f, Fl -force
2012-11-03 15:48:10 +05:30
Forcefully reconfigure package even if it was configured previously.
2012-11-05 14:09:10 +05:30
.It Fl h, Fl -help
2015-10-30 11:15:26 +05:30
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.
2012-11-05 14:09:10 +05:30
.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 .
.
2012-11-05 14:09:10 +05:30
.It Fl v, Fl -verbose
2012-11-03 15:48:10 +05:30
Enables verbose messages.
2012-11-05 14:09:10 +05:30
.It Fl V, Fl -version
2015-10-30 11:15:26 +05:30
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
2014-09-11 15:51:33 +05:30
.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
2014-09-11 15:51:33 +05:30
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
2012-11-03 15:48:10 +05:30
.Sh SEE ALSO
.Xr xbps-alternatives 1 ,
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-digest 1 ,
2015-10-28 14:07:09 +05:30
.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
2012-11-03 15:48:10 +05:30
.Sh AUTHORS
.An Juan Romero Pardines Aq Mt xtraeme@gmail.com
2012-11-03 15:48:10 +05:30
.Sh BUGS
Probably, but I try to make this not happen. Use it under your own
responsibility and enjoy your life.
2012-11-03 15:48:10 +05:30
.Pp
Report bugs at
.Lk https://github.com/void-linux/xbps/issues