xbps/bin/xbps-remove/xbps-remove.1

132 lines
3.5 KiB
Groff
Raw Normal View History

2015-10-28 14:07:09 +05:30
.Dd October 28, 2015
.Dt XBPS-REMOVE 1
2012-11-03 15:17:03 +05:30
.Sh NAME
.Nm xbps-remove
.Nd XBPS utility to remove packages
.Sh SYNOPSYS
.Nm xbps-remove
.Op OPTIONS
.Op PKGNAME...
.Sh DESCRIPTION
The
.Nm
2012-11-05 14:09:10 +05:30
utility removes installed packages in the target root directory.
Removing a package involves the following steps:
2012-11-03 15:59:45 +05:30
.Pp
.Sy *
2012-11-03 16:03:55 +05:30
Executes the
.Sy pre
ACTION on its
2012-11-03 15:59:45 +05:30
.Sy REMOVE
script (which can be shown by running
.Sy `xbps-query --property=remove-script pkg`
).
2012-11-03 15:59:45 +05:30
.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 *
2012-11-03 16:03:55 +05:30
Executes the
.Sy post
ACTION on its
2012-11-03 15:59:45 +05:30
.Sy REMOVE
script (which can be shown by running
.Sy `xbps-query --property=remove-script pkg`
).
2012-11-03 15:59:45 +05:30
.Pp
.Sy *
2012-11-03 16:03:55 +05:30
Changes package state to
.Sy XBPS_PKG_STATE_HALF_REMOVED
in the package database.
2012-11-03 15:59:45 +05:30
.Pp
.Sy *
2012-11-03 16:03:55 +05:30
Executes the
2012-11-03 15:59:45 +05:30
.Sy purge
ACTION on its
2012-11-03 15:59:45 +05:30
.Sy REMOVE
script (which can be shown by running
.Sy `xbps-query --property=remove-script pkg`
).
2012-11-03 15:59:45 +05:30
.Pp
.Sy *
Package metadata file is removed.
2012-11-03 15:59:45 +05:30
.Pp
.Sy *
Package is unregistered from package database.
2012-11-03 15:17:03 +05:30
.Sh OPTIONS
2012-11-06 15:03:29 +05:30
.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 .
2012-11-05 14:09:10 +05:30
.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 .
2012-11-05 14:09:10 +05:30
.It Fl d, Fl -debug
2012-11-03 15:17:03 +05:30
Enables extra debugging shown to stderr.
.It Fl F, Fl -force-revdeps
2015-02-16 15:49:09 +05:30
Forcefully remove package even if there are reverse dependencies and/or broken
shared libraries (DANGEROUS!).
2012-11-05 14:09:10 +05:30
.It Fl f, Fl -force
2012-11-03 15:17:03 +05:30
Forcefully remove package files even if they have been modified.
2012-11-05 14:09:10 +05:30
.It Fl h, Fl -help
2012-11-03 15:17:03 +05:30
Show the help usage.
2012-11-05 14:09:10 +05:30
.It Fl n, Fl -dry-run
Dry-run mode. Show what actions would be done but don't do anything. The current output
prints 6 arguments: "<pkgver> <action> <arch> <repository> <installedsize> <downloadsize>".
2012-11-05 14:09:10 +05:30
.It Fl O, Fl -clean-cache
2012-11-03 15:17:03 +05:30
Cleans cache directory removing obsolete binary packages.
2012-11-05 14:09:10 +05:30
.It Fl o, Fl -remove-orphans
2012-11-03 15:17:03 +05:30
Removes installed package orphans that were installed automatically
(as dependencies) and are not currently dependencies of any installed package.
2012-11-05 14:09:10 +05:30
.It Fl R, Fl -recursive
2012-11-03 15:17:03 +05:30
Recursively remove packages that were installed by
.Ar PKGNAME
and aren't required by other installed packages.
2012-11-05 14:09:10 +05:30
.It Fl r, Fl -rootdir Ar dir
2012-11-03 15:17:03 +05:30
Specifies a full path for the target root directory.
2012-11-05 14:09:10 +05:30
.It Fl v, Fl -verbose
2012-11-03 15:17:03 +05:30
Enables verbose messages.
2012-11-05 14:09:10 +05:30
.It Fl y, Fl -yes
2012-11-03 15:17:03 +05:30
Assume yes to all questions and avoid interactive questions.
2012-11-05 14:09:10 +05:30
.It Fl V, Fl -version
2012-11-03 15:17:03 +05:30
Shows the XBPS version.
.El
2012-11-03 15:17:03 +05:30
.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.
2014-09-11 15:51:33 +05:30
.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.
2012-11-03 15:17:03 +05:30
.It Ar /var/cache/xbps
Default cache directory to store downloaded binary packages.
.El
2012-11-03 15:17:03 +05:30
.Sh SEE ALSO
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
2015-10-28 14:07:09 +05:30
.Xr xbps-fbulk 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,
.Xr xbps-reconfigure 1 ,
.Xr xbps-rindex 1 ,
.Xr xbps-uchroot 1 ,
.Xr xbps-uunshare 1 ,
.Xr xbps.d 5
2012-11-03 15:17:03 +05:30
.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
2013-12-17 20:08:56 +05:30
Report bugs in https://github.com/voidlinux/xbps/issues