410 lines
12 KiB
Groff
410 lines
12 KiB
Groff
.TH "XBPS\-BIN" "8" "15/12/2011" "\ \&" "\ \&"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
xbps-bin \- XBPS command for binary packages
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
\fBxbps\-bin\fR [\fIoptions\fR] \fItarget\fR [\fIpkgname\fR]
|
|
.SH "DESCRIPTION"
|
|
.sp
|
|
The xbps\-bin(8) command is used to handle binary packages created for the XBPS binary package system\&. You can use it to install, remove, update, list or show information about any binary package\&. Binary packages can be installed from \fIlocal (directories)\fR or \fIremote repositories (http, https or ftp)\fR, see xbps\-repo(8) for information about repositories\&.
|
|
.SH "OPTIONS"
|
|
.PP
|
|
\fB\-A\fR
|
|
.RS 4
|
|
Sets the \fBautomatic\-install\fR boolean object for a package, therefore explicitly
|
|
setting that package was installed as it were a dependency, even if it is not.
|
|
Use of this option takes effect in the \fIautoupdate\fR, \fIinstall\fR and
|
|
\fIupdate\fR targets and target packages and its required dependencies will be
|
|
matched.
|
|
.RE
|
|
.PP
|
|
\fB\-C\fR \fIconffile\fR
|
|
.RS 4
|
|
Full path to the XBPS configuration file\&.
|
|
By default it\(cqs set to \fIETCDIR/xbps/xbps.conf\fR\&.
|
|
.RE
|
|
.PP
|
|
\fB\-c\fR \fIcachedir\fR
|
|
.RS 4
|
|
Sets the cache directory to store downloaded binary packages from remote repositories\&. By default it\(cqs set to
|
|
\fI/var/cache/xbps\fR\&.
|
|
.RE
|
|
.PP
|
|
\fB\-d\fR
|
|
.RS 4
|
|
Enables extra debugging output to be shown to stderr\&.
|
|
.RE
|
|
.PP
|
|
\fB\-D\fR
|
|
.RS 4
|
|
Only show the URLs to download the binary packages from repositories\&. This is useful if you want to download them by other means, and later you can move them to the
|
|
\fIcachedir\fR
|
|
to start the installation\&. This option can be used for the install, update and autoupdate targets\&.
|
|
.RE
|
|
.PP
|
|
\fB\-F\fR
|
|
.RS 4
|
|
Used currently in the
|
|
\fIremove\fR
|
|
target\&. If set, package will be removed even if other packages are currently depending on it, i\&.e package is a dependency of other packages\&.
|
|
\fIUse this option with care\fR\&.
|
|
.RE
|
|
.PP
|
|
\fB\-f\fR
|
|
.RS 4
|
|
Used currently in the
|
|
\fIpurge\fR,
|
|
\fIreconfigure\fR
|
|
and
|
|
\fIremove\fR
|
|
targets\&. If set,
|
|
\fIpackage(s)\fR
|
|
will be
|
|
\fIreconfigured\fR
|
|
regardless of its state in the reconfigure target, or to
|
|
\fIforce\fR
|
|
removal of package files even if its hash doesn\(cqt match in the
|
|
\fIpurge\fR
|
|
and
|
|
\fIremove\fR
|
|
targets\&.
|
|
.RE
|
|
.PP
|
|
\fB-M\fR
|
|
.RS 4
|
|
Sets the \fBautomatic\-install\fR boolean object for package to false, therefore
|
|
explicitly setting that package was installed manually by the user. Use of this
|
|
option takes effect in the \fIautoupdate\fR, \fIinstall\fR and \fIupdate\fR targets
|
|
and target packages and its required dependencies will be matched.
|
|
.RE
|
|
.PP
|
|
\fB-o\fR \fIkey[,key2...]\fR
|
|
.RS 4
|
|
Used currently in the
|
|
\fIshow\fR
|
|
target\&. Prints the value of specified key(s) from package's properties dictionary.
|
|
Multiple keys can be specified delimited by the comma character.
|
|
.RE
|
|
.PP
|
|
\fB\-p\fR
|
|
.RS 4
|
|
Used currently in the
|
|
\fIremove\fR
|
|
and
|
|
\fIautoremove\fR
|
|
targets, if enabled after removing a package it is also purged\&.
|
|
.RE
|
|
.PP
|
|
\fB\-R\fR
|
|
.RS 4
|
|
Used currently in the
|
|
\fIremove\fR
|
|
target, to recursively remove packages that aren\(cqt required by other installed packages and that were installed by the package that we want to remove\&.
|
|
.RE
|
|
.PP
|
|
\fB\-r\fR \fIrootdir\fR
|
|
.RS 4
|
|
Sets the
|
|
\fIroot\fR
|
|
directory\&. By default the root directory is set to
|
|
\fI/\fR\&. Please note that the database directory is always set to
|
|
\fI/var/db/xbps\fR
|
|
independently of
|
|
\fIrootdir\fR\&. So if you use a rootdir of
|
|
\fI/blah\fR, metadata stuff will go into
|
|
\fI/blah/var/db/xbps\fR\&.
|
|
.RE
|
|
.PP
|
|
\fB\-v\fR
|
|
.RS 4
|
|
Shows verbose messages\&. Useful while installing and removing packages\&.
|
|
.RE
|
|
.PP
|
|
\fB\-y\fR
|
|
.RS 4
|
|
Assume
|
|
\fIyes\fR
|
|
to all questions\&. This will bypass all questions and immediately proceed with the task, use this option with care\&.
|
|
.RE
|
|
.PP
|
|
\fB\-V\fR
|
|
.RS 4
|
|
Shows the current XBPS release version (library and code)\&.
|
|
.RE
|
|
.SH "TARGETS"
|
|
.sp
|
|
Please note that all targets are case insensitive\&.
|
|
.PP
|
|
\fBautoremove\fR
|
|
.RS 4
|
|
Removes package orphans\&. These packages were installed as dependencies and currently there is not any package depending on it, directly or indirectly\&. Usually it is safe to always answer yes\&.
|
|
.RE
|
|
.PP
|
|
\fBautoupdate\fR
|
|
.RS 4
|
|
Updates all currently installed packages to the newest version available in all repositories\&.
|
|
.RE
|
|
.PP
|
|
\fBcheck \fR\fB\fIpkgname | all\fR\fR
|
|
.RS 4
|
|
Checks for integrity errors in installed packages\&. The checks are to found missing run\-time dependencies, missing and modified package files and metadata files\&. If the
|
|
\fIall\fR
|
|
keyword is used, all packages currently installed will be checked, otherwise only
|
|
\fIpkgname\fR\&.
|
|
.RE
|
|
.PP
|
|
\fBfind\-files \fR\fB\fIpattern\fR\fR
|
|
.RS 4
|
|
Prints the name of the installed
|
|
\fIpackage(s)\fR
|
|
matching the pattern on its file list\&.
|
|
.RE
|
|
.PP
|
|
\fBinstall \fR\fB\fIpkgname(s) | pkgpattern(s)\fR\fR
|
|
.RS 4
|
|
Install binary package(s) from repository pool by specifying
|
|
\fIpkgname(s)\fR
|
|
or
|
|
\fIpackage pattern(s)\fR\&. The first repository matching the arguments will be used\&. The package(s) will be
|
|
\fIdownloaded\fR
|
|
(if found in a remote repository),
|
|
\fIunpacked\fR
|
|
and
|
|
\fIconfigured\fR\&. The
|
|
\fIunpack\fR
|
|
stage will execute the pre\-install action on its INSTALL script, and unpack its files\&. The
|
|
\fIconfigure\fR
|
|
stage will run the post\-install action set on its INSTALL script and will change its
|
|
\fIstate\fR
|
|
to installed in the package database\&.
|
|
.RE
|
|
.PP
|
|
\fBlist [\fR\fB\fIstate\fR\fR\fB]\fR
|
|
.RS 4
|
|
Lists all currently installed packages\&. Optionally another argument can be specified to list only packages with the specified
|
|
\fIstate\fR\&. By default only packages that are
|
|
\fIfully installed\fR
|
|
will be listed if
|
|
\fIstate\fR
|
|
has not been specified\&. Accepted states are:
|
|
\fIconfig\-files\fR,
|
|
\fIhalf-unpacked\fR,
|
|
\fIunpacked\fR,
|
|
and
|
|
\fIinstalled\fR\&.
|
|
.RE
|
|
.PP
|
|
\fBlist\-manual\fR
|
|
.RS 4
|
|
Lists packages that were installed manually by the user, i\&.e not as dependencies of any other package\&.
|
|
.RE
|
|
.PP
|
|
\fBpurge \fR\fB\fIpkgname | all\fR\fR
|
|
.RS 4
|
|
Purge an installed package:
|
|
\fIpkgname\fR
|
|
or
|
|
\fIall\fR
|
|
packages\&. The purge stage runs the post\-remove action set in the REMOVE script in its metadata directory
|
|
\fI(/var/db/xbps/metadata/pkgname)\fR
|
|
and will remove configuration (if they were not modified by the user) and metadata files\&. The package will be fully removed from the system once it has been purged\&. If
|
|
\fB\-f\fR
|
|
option is used, configuration files that have been
|
|
\fImodified WILL BE REMOVED\&. BEWARE WITH THIS!\fR
|
|
.RE
|
|
.PP
|
|
\fBreconfigure \fR\fB\fIpkgname | all\fR\fR
|
|
.RS 4
|
|
Reconfigure an unpacked package\&. Packages in this state are not fully installed, because they were not configured for whatever reason\&. The configure stage will run the post\-install action set on its INSTALL script and will change its state to installed in the package database\&. The
|
|
\fIall\fR
|
|
keyword can be used to reconfigure all not configured packages\&. If
|
|
\fB\-f\fR
|
|
option is used, the package will be reconfigured even if its state is already installed\&.
|
|
.RE
|
|
.PP
|
|
\fBremove \fR\fB\fIpkgname(s)\fR\fR
|
|
.RS 4
|
|
Removes the installed package
|
|
\fIpkgname(s)\fR\&. Its files will be removed and its state will be changed to
|
|
\fIconfig\-files\fR
|
|
in the package database\&. Configuration files, its metadata directory/files and its information in the package database are preserved\&. To fully remove a package in
|
|
\fIconfig\-files\fR
|
|
state, it must be purged with the
|
|
\fIpurge\fR
|
|
command or alternatively use the
|
|
\fB\-p\fR
|
|
flag \&. If
|
|
\fB\-f\fR
|
|
option is used, package files will be
|
|
\fBremoved even if its SHA256 hash don\(cqt match\fR\&.
|
|
.RE
|
|
.PP
|
|
\fBshow \fR\fB\fIpkgname\fR\fR
|
|
.RS 4
|
|
Shows information for installed package
|
|
\fIpkgname\fR\&. This will print the size it takes in filesystem, description, maintainer, architecture and other information\&.
|
|
.RE
|
|
.PP
|
|
\fBshow\-deps \fR\fB\fIpkgname\fR\fR
|
|
.RS 4
|
|
Shows the list of dependencies that pkgname requires at run time\&.
|
|
.RE
|
|
.PP
|
|
\fBshow\-files \fR\fB\fIpkgname\fR\fR
|
|
.RS 4
|
|
Shows the list of files that pkgname contains\&.
|
|
.RE
|
|
.PP
|
|
\fBshow\-orphans\fR
|
|
.RS 4
|
|
Shows the list of package orphans currently installed\&. Package orphans are packages that were installed as dependencies of another package, but no other package currently depends on\&.
|
|
.RE
|
|
.PP
|
|
\fBshow\-revdeps \fR\fB\fIpkgname\fR\fR
|
|
.RS 4
|
|
Shows the reverse dependencies for
|
|
\fIpkgname\fR\&. Reverse dependencies are packages that are currently depending in pkgname directly\&.
|
|
.RE
|
|
.PP
|
|
\fBupdate \fR\fB\fIpkgname(s)\fR\fR
|
|
.RS 4
|
|
Updates
|
|
\fIpkgname(s)\fR
|
|
to the most newer version available in repository pool\&. This can be used if only
|
|
\fIpkgname(s)\fR
|
|
need to be updated, unlike the
|
|
\fIautoupdate\fR
|
|
target that will update all currently installed packages\&.
|
|
.RE
|
|
.SH "PACKAGE STATES"
|
|
.sp
|
|
A package can be in a different state while it is being installed, removed, unpacked, configured or purged\&. The following states are available:
|
|
.PP
|
|
\fBinstalled\fR
|
|
.RS 4
|
|
The package is fully installed, that means it was unpacked and configured correctly\&.
|
|
.RE
|
|
.PP
|
|
\fBhalf\-unpacked\fR
|
|
.RS 4
|
|
The package was being unpacked but didn't finish properly for unknown reasons.
|
|
.RE
|
|
.PP
|
|
\fBunpacked\fR
|
|
.RS 4
|
|
The package has been unpacked in destination root directory, but it is not fully installed because it was not yet configured\&. Please note, that some packages will do not work if they are only unpacked\&.
|
|
.RE
|
|
.PP
|
|
\fBconfig\-files\fR
|
|
.RS 4
|
|
The package has been removed but configuration files and its metadata directory are still available (and it is still registered in the package database)\&. You can purge safely packages that are in this state, modified configuration files will be preserved\&.
|
|
.RE
|
|
.PP
|
|
.SH "FILES"
|
|
.PP
|
|
\fB/etc/xbps/conf.plist\fR
|
|
.RS 4
|
|
Default XBPS configuration file\&.
|
|
.RE
|
|
.PP
|
|
\fB/etc/xbps/repositories.plist\fR
|
|
.RS 4
|
|
Defaults XBPS repositories configuration file\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/db/xbps\fR
|
|
.RS 4
|
|
xbps global metadata directory\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/db/xbps/metadata/<pkgname>\fR
|
|
.RS 4
|
|
Installed package metadata directory\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/db/xbps/metadata/<pkgname>/files\&.plist\fR
|
|
.RS 4
|
|
Installed package metadata list of files\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/db/xbps/metadata/<pkgname>/prop\&.plist\fR
|
|
.RS 4
|
|
Installed package metadata properties\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/db/xbps/regpkgdb\&.plist\fR
|
|
.RS 4
|
|
xbps master packages/properties database plist file\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/cache/xbps\fR
|
|
.RS 4
|
|
xbps cache directory for downloaded binary packages\&.
|
|
.RE
|
|
.SH "EXAMPLES"
|
|
.PP
|
|
\fBInstall\fR a package by specifying its \fBname\fR:
|
|
.RS 4
|
|
|
|
$ xbps\-bin install foo
|
|
.RE
|
|
.PP
|
|
\fBInstall\fR a package by specifying a \fBpackage pattern\fR:
|
|
.RS 4
|
|
|
|
$ xbps\-bin install "foo>=3\&.0"
|
|
.RE
|
|
.PP
|
|
\fBInstall multiple\fR packages by specifying \fBnames\fR and \fBpackage patterns\fR:
|
|
.RS 4
|
|
|
|
$ xbps\-bin install foo "blah<=4\&.0" baz\-2\&.0 "blob>4\&.[0\-9]"
|
|
.RE
|
|
.PP
|
|
\fBFind\fR the package that owns the file \fB/bin/mount\fR:
|
|
.RS 4
|
|
|
|
$ xbps\-bin find\-files /bin/mount
|
|
.RE
|
|
.PP
|
|
\fBFind\fR the packages that match the pattern \fB"/usr/lib/libav\fR"*:
|
|
.RS 4
|
|
|
|
$ xbps\-bin find\-files "/usr/lib/libav*"
|
|
.RE
|
|
.PP
|
|
\fBRemove and purge\fR the package \fBproplib\-devel\fR:
|
|
.RS 4
|
|
|
|
$ xbps\-bin \-yp remove proplib\-devel
|
|
.RE
|
|
.PP
|
|
\fBRemove and purge\fR the package \fBbsdtar\fR and \fBrecursively\fR all packages that were installed automatically by it:
|
|
.RS 4
|
|
|
|
$ xbps\-bin \-Rp remove bsdtar
|
|
.RE
|
|
.SH "BUGS"
|
|
.sp
|
|
Probably, but I try to make this not happen\&. Use it under your own responsability and enjoy your life\&.
|
|
.sp
|
|
Report bugs in http://code\&.google\&.com/p/xbps\&.
|
|
.SH "SEE ALSO"
|
|
.sp
|
|
xbps\-repo(8)
|
|
.sp
|
|
The XBPS project: http://code\&.google\&.com/p/xbps
|
|
.SH "AUTHORS"
|
|
.sp
|
|
\fBXBPS\fR has been designed and implemented by Juan Romero Pardines <xtraeme@gmail\&.com>\&.
|