126 lines
3.2 KiB
Groff
126 lines
3.2 KiB
Groff
.Dd December 9, 2014
|
|
.Dt XBPS-REMOVE 8
|
|
.Sh NAME
|
|
.Nm xbps-remove
|
|
.Nd XBPS utility to remove packages
|
|
.Sh SYNOPSYS
|
|
.Nm xbps-remove
|
|
.Op OPTIONS
|
|
.Op PKGNAME...
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility removes installed packages in the target root directory.
|
|
Removing a package involves the following steps:
|
|
.Pp
|
|
.Sy *
|
|
Executes the
|
|
.Sy pre
|
|
ACTION on its
|
|
.Sy REMOVE
|
|
script (which can be shown by running
|
|
.Sy `xbps-query --property=remove-script pkg`
|
|
).
|
|
.Pp
|
|
.Sy *
|
|
Package files are removed if those have not been modified.
|
|
The
|
|
.Ar -f
|
|
option overrides this behaviour and forcefully removes the files.
|
|
.Pp
|
|
.Sy *
|
|
Executes the
|
|
.Sy post
|
|
ACTION on its
|
|
.Sy REMOVE
|
|
script (which can be shown by running
|
|
.Sy `xbps-query --property=remove-script pkg`
|
|
).
|
|
.Pp
|
|
.Sy *
|
|
Changes package state to
|
|
.Sy XBPS_PKG_STATE_HALF_REMOVED
|
|
in the package database.
|
|
.Pp
|
|
.Sy *
|
|
Executes the
|
|
.Sy purge
|
|
ACTION on its
|
|
.Sy REMOVE
|
|
script (which can be shown by running
|
|
.Sy `xbps-query --property=remove-script pkg`
|
|
).
|
|
.Pp
|
|
.Sy *
|
|
Package metadata file is removed.
|
|
.Pp
|
|
.Sy *
|
|
Package is unregistered from package database.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width -x
|
|
.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 c, Fl -cachedir Ar dir
|
|
Specifies a path to the cache directory, where binary packages are stored.
|
|
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-revdeps
|
|
Forcefully remove package even if there are reverse dependencies (DANGEROUS!).
|
|
.It Fl f, Fl -force
|
|
Forcefully remove package files even if they have been modified.
|
|
.It Fl h, Fl -help
|
|
Show the help usage.
|
|
.It Fl n, Fl -dry-run
|
|
Dry-run mode. Show what actions would be done but don't remove anything.
|
|
.It Fl O, Fl -clean-cache
|
|
Cleans cache directory removing obsolete binary packages.
|
|
.It Fl o, Fl -remove-orphans
|
|
Removes installed package orphans that were installed automatically
|
|
(as dependencies) and are not currently dependencies of any installed package.
|
|
.It Fl R, Fl -recursive
|
|
Recursively remove packages that were installed by
|
|
.Ar PKGNAME
|
|
and aren't required by other installed packages.
|
|
.It Fl r, Fl -rootdir Ar dir
|
|
Specifies a full path for the target root directory.
|
|
.It Fl v, Fl -verbose
|
|
Enables verbose messages.
|
|
.It Fl y, Fl -yes
|
|
Assume yes to all questions and avoid interactive questions.
|
|
.It Fl V, Fl -version
|
|
Shows the XBPS version.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width /var/db/xbps/.<pkgname>-files.plist
|
|
.It Ar /etc/xbps.d
|
|
Default configuration directory.
|
|
.It Ar /var/db/xbps/.<pkgname>-files.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.d 5 ,
|
|
.Xr xbps-checkvers 8 ,
|
|
.Xr xbps-create 8 ,
|
|
.Xr xbps-dgraph 8 ,
|
|
.Xr xbps-install 8 ,
|
|
.Xr xbps-pkgdb 8 ,
|
|
.Xr xbps-query 8 ,
|
|
.Xr xbps-reconfigure 8 ,
|
|
.Xr xbps-rindex 8 ,
|
|
.Xr xbps-uchroot 8
|
|
.Sh AUTHORS
|
|
.An Juan Romero Pardines <xtraeme@gmail.com>
|
|
.Sh BUGS
|
|
Probably, but I try to make this not happen. Use it under your own
|
|
responsability and enjoy your life.
|
|
.Pp
|
|
Report bugs in https://github.com/voidlinux/xbps/issues
|