xbps-bin(8): rewritten manpage to mdoc(7) macro format.
This commit is contained in:
Juan RP
parent
53fd5fa10b
commit
fa80e01404
@ -1,409 +1,337 @@
|
|||||||
.TH "XBPS\-BIN" "8" "15/12/2011" "\ \&" "\ \&"
|
.Dd December 15, 2011
|
||||||
.\" -----------------------------------------------------------------
|
.Os Void GNU/Linux
|
||||||
.\" * set default formatting
|
.Dt xbps-bin 8
|
||||||
.\" -----------------------------------------------------------------
|
.Sh NAME
|
||||||
.\" disable hyphenation
|
.Nm xbps-bin
|
||||||
.nh
|
.Nd XBPS command for binary packages
|
||||||
.\" disable justification (adjust text to left margin only)
|
.Sh SYNOPSYS
|
||||||
.ad l
|
.Nm xbps-bin
|
||||||
.\" -----------------------------------------------------------------
|
.Op options
|
||||||
.\" * MAIN CONTENT STARTS HERE *
|
.Op target
|
||||||
.\" -----------------------------------------------------------------
|
.Op pkgname(s)|pkgpattern(s)
|
||||||
.SH "NAME"
|
.Sh DESCRIPTION
|
||||||
xbps-bin \- XBPS command for binary packages
|
The
|
||||||
.SH "SYNOPSIS"
|
.Nm
|
||||||
.sp
|
ommand is used to handle binary packages created for the XBPS binary
|
||||||
\fBxbps\-bin\fR [\fIoptions\fR] \fItarget\fR [\fIpkgname\fR]
|
package system. You can use it to install, remove, update, list or show information
|
||||||
.SH "DESCRIPTION"
|
about any binary package. Binary packages can be installed from
|
||||||
.sp
|
.Em local
|
||||||
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\&.
|
(directories)
|
||||||
.SH "OPTIONS"
|
or
|
||||||
.PP
|
.Em remote
|
||||||
\fB\-A\fR
|
repositories (http, https or ftp), see
|
||||||
.RS 4
|
.Xr xbps-repo 8
|
||||||
Sets the \fBautomatic\-install\fR boolean object for a package, therefore explicitly
|
for information about repositories.
|
||||||
setting that package was installed as it were a dependency, even if it is not.
|
.Sh OPTIONS
|
||||||
Use of this option takes effect in the \fIautoupdate\fR, \fIinstall\fR and
|
.Bl -tag -width Fl
|
||||||
\fIupdate\fR targets and target packages and its required dependencies will be
|
.It Fl A
|
||||||
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
|
Sets the
|
||||||
\fIroot\fR
|
.Em automatic-install
|
||||||
directory\&. By default the root directory is set to
|
boolean object for a package, therefore explicitly
|
||||||
\fI/\fR\&. Please note that the database directory is always set to
|
setting that package was installed as it were a dependency, even if it is not.
|
||||||
\fI/var/db/xbps\fR
|
Use of this option takes effect in the
|
||||||
independently of
|
.Em autoupdate ,
|
||||||
\fIrootdir\fR\&. So if you use a rootdir of
|
.Em install
|
||||||
\fI/blah\fR, metadata stuff will go into
|
and
|
||||||
\fI/blah/var/db/xbps\fR\&.
|
.Em update
|
||||||
.RE
|
targets.
|
||||||
.PP
|
Targetted packages and its required dependencies will be matched.
|
||||||
\fB\-v\fR
|
.It Fl C Ar conffile
|
||||||
.RS 4
|
Full path to the XBPS configuration file. By default set to
|
||||||
Shows verbose messages\&. Useful while installing and removing packages\&.
|
.Pa /etc/xbps/xbps.conf .
|
||||||
.RE
|
.It Fl c Ar cachedir
|
||||||
.PP
|
Sets the
|
||||||
\fB\-y\fR
|
.Em cache
|
||||||
.RS 4
|
directory to store downloaded binary packages from remote
|
||||||
|
repositories. By default set to
|
||||||
|
.Pa /var/cache/xbps .
|
||||||
|
.It Fl d
|
||||||
|
Enables extra debugging output to be shown to stderr.
|
||||||
|
.It Fl D
|
||||||
|
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 cachedir to start the installation. This option can be used for
|
||||||
|
the install, update and autoupdate targets.
|
||||||
|
.It Fl F
|
||||||
|
Used currently in the
|
||||||
|
.Em remove
|
||||||
|
target. If set, package will be removed even if other packages are currently
|
||||||
|
depending on it, i.e package is a dependency of any other installed package.
|
||||||
|
.It Fl f
|
||||||
|
Used currently in the
|
||||||
|
.Em purge ,
|
||||||
|
.Em reconfigure
|
||||||
|
and
|
||||||
|
.Em remove
|
||||||
|
targets. If set, package(s) will be reconfigured regardless of its state in
|
||||||
|
.Em reconfigure
|
||||||
|
target, or to
|
||||||
|
.Em force
|
||||||
|
removal of package files even if its hash does not match in the
|
||||||
|
.Em purge
|
||||||
|
and
|
||||||
|
.Em remove
|
||||||
|
targets.
|
||||||
|
.It Fl M
|
||||||
|
Sets the
|
||||||
|
.Em automatic-install
|
||||||
|
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
|
||||||
|
.Em autoupdate ,
|
||||||
|
.Em install
|
||||||
|
and
|
||||||
|
.Em update
|
||||||
|
targets
|
||||||
|
and target packages and its required dependencies will be matched.
|
||||||
|
.It Fl o Ar key Op key2,...
|
||||||
|
Used currently in the
|
||||||
|
.Em show
|
||||||
|
target. Prints the value of specified key(s) from
|
||||||
|
package's properties dictionary. Multiple keys can be specified delimited by
|
||||||
|
the comma character.
|
||||||
|
.It Fl p
|
||||||
|
Used currently in the
|
||||||
|
.Em remove
|
||||||
|
and
|
||||||
|
.Em autoremove
|
||||||
|
targets. If enabled, after removing
|
||||||
|
a package it is also purged.
|
||||||
|
.It Fl R
|
||||||
|
Used currently in the
|
||||||
|
.Em remove
|
||||||
|
target. If set, recursively removes packages that
|
||||||
|
are not required by any other installed package and that were installed by
|
||||||
|
the package that we want to remove.
|
||||||
|
.It Fl r Ar rootdir
|
||||||
|
Sets the
|
||||||
|
.Em root
|
||||||
|
directory. By default the root directory is set to
|
||||||
|
.Em / .
|
||||||
|
Please note that the database directory is always set to
|
||||||
|
.Pa /var/db/xbps
|
||||||
|
independently of rootdir setting. So if you use a rootdir of
|
||||||
|
.Pa /blah ,
|
||||||
|
metadata stuff will go into
|
||||||
|
.Pa /blah/var/db/xbps .
|
||||||
|
.It Fl v
|
||||||
|
Shows verbose messages. Useful while installing and removing packages.
|
||||||
|
.It Fl y
|
||||||
Assume
|
Assume
|
||||||
\fIyes\fR
|
.Em yes
|
||||||
to all questions\&. This will bypass all questions and immediately proceed with the task, use this option with care\&.
|
to all questions. This will bypass all questions and immediately proceed
|
||||||
.RE
|
with the task.
|
||||||
.PP
|
.It Fl V
|
||||||
\fB\-V\fR
|
Shows the current XBPS release version (version, API, index).
|
||||||
.RS 4
|
.Sh TARGETS
|
||||||
Shows the current XBPS release version (library and code)\&.
|
Please note that all targets are case insensitive.
|
||||||
.RE
|
.Pp
|
||||||
.SH "TARGETS"
|
.Bl -tag -width ident
|
||||||
.sp
|
.It Sy autoremove
|
||||||
Please note that all targets are case insensitive\&.
|
Removes package orphans. These packages were installed as dependencies and
|
||||||
.PP
|
currently there is not any package depending on it, directly or indirectly.
|
||||||
\fBautoremove\fR
|
Usually it is safe to always answer yes.
|
||||||
.RS 4
|
.It Sy autoupdate
|
||||||
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\&.
|
Updates all currently installed packages to the newest version available in
|
||||||
.RE
|
all repositories.
|
||||||
.PP
|
.It Sy check Ar pkgname | Ar all
|
||||||
\fBautoupdate\fR
|
Checks for integrity errors in installed packages. The checks are to found
|
||||||
.RS 4
|
missing run-time dependencies, missing and modified package files and
|
||||||
Updates all currently installed packages to the newest version available in all repositories\&.
|
metadata files. If the all keyword is used, all packages currently installed
|
||||||
.RE
|
will be checked, otherwise just pkgname.
|
||||||
.PP
|
.It Sy find-files Ar pattern
|
||||||
\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
|
Prints the name of the installed
|
||||||
\fIpackage(s)\fR
|
.Em package(s)
|
||||||
matching the pattern on its file list\&.
|
matching the pattern on its file list.
|
||||||
.RE
|
.It Sy install Ar pkgname(s) | Ar pkgpattern(s)
|
||||||
.PP
|
|
||||||
\fBinstall \fR\fB\fIpkgname(s) | pkgpattern(s)\fR\fR
|
|
||||||
.RS 4
|
|
||||||
Install binary package(s) from repository pool by specifying
|
Install binary package(s) from repository pool by specifying
|
||||||
\fIpkgname(s)\fR
|
.Em pkgname(s)
|
||||||
or
|
or
|
||||||
\fIpackage pattern(s)\fR\&. The first repository matching the arguments will be used\&. The package(s) will be
|
.Em package pattern(s) .
|
||||||
\fIdownloaded\fR
|
The first repository matching the arguments will be used. The package(s) will be
|
||||||
|
.Em downloaded
|
||||||
(if found in a remote repository),
|
(if found in a remote repository),
|
||||||
\fIunpacked\fR
|
.Em unpacked
|
||||||
and
|
and
|
||||||
\fIconfigured\fR\&. The
|
.EM configured .
|
||||||
\fIunpack\fR
|
The
|
||||||
stage will execute the pre\-install action on its INSTALL script, and unpack its files\&. The
|
.Em unpack
|
||||||
\fIconfigure\fR
|
stage will execute the pre-install action on its INSTALL script, and unpack its files.
|
||||||
stage will run the post\-install action set on its INSTALL script and will change its
|
The
|
||||||
\fIstate\fR
|
.Em configure
|
||||||
to installed in the package database\&.
|
stage will run the post-install action set on its INSTALL script and will change its
|
||||||
.RE
|
.Em state
|
||||||
.PP
|
to installed in the package database.
|
||||||
\fBlist [\fR\fB\fIstate\fR\fR\fB]\fR
|
.It Sy list Op state
|
||||||
.RS 4
|
Lists all currently installed packages. Optionally another argument can be specified
|
||||||
Lists all currently installed packages\&. Optionally another argument can be specified to list only packages with the specified
|
to list only packages with the specified
|
||||||
\fIstate\fR\&. By default only packages that are
|
.Op state .
|
||||||
\fIfully installed\fR
|
By default only packages fully installed will be listed if
|
||||||
will be listed if
|
.Em state
|
||||||
\fIstate\fR
|
has not been specified. Accepted states are:
|
||||||
has not been specified\&. Accepted states are:
|
.Em config-files ,
|
||||||
\fIconfig\-files\fR,
|
.Em half-unpacked ,
|
||||||
\fIhalf-unpacked\fR,
|
.Em unpacked ,
|
||||||
\fIunpacked\fR,
|
|
||||||
and
|
and
|
||||||
\fIinstalled\fR\&.
|
.Em installed .
|
||||||
.RE
|
.It Sy list-manual
|
||||||
.PP
|
Lists packages that were installed manually by the user, i.e not as dependencies
|
||||||
\fBlist\-manual\fR
|
of any other package.
|
||||||
.RS 4
|
.It Sy purge Ar pkgname | Ar all
|
||||||
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:
|
Purge an installed package:
|
||||||
\fIpkgname\fR
|
.Em pkgname
|
||||||
or
|
or
|
||||||
\fIall\fR
|
.Em all
|
||||||
packages\&. The purge stage runs the post\-remove action set in the REMOVE script in its metadata directory
|
packages. The purge stage runs the post-remove action set in the REMOVE script
|
||||||
\fI(/var/db/xbps/metadata/pkgname)\fR
|
in its metadata directory
|
||||||
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
|
.Pa (/var/db/xbps/metadata/pkgname)
|
||||||
\fB\-f\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
|
||||||
|
.Ql -f
|
||||||
option is used, configuration files that have been
|
option is used, configuration files that have been
|
||||||
\fImodified WILL BE REMOVED\&. BEWARE WITH THIS!\fR
|
.Em modified WILL BE REMOVED. BEWARE WITH THIS!
|
||||||
.RE
|
.It Sy reconfigure Ar pkgname | Ar all
|
||||||
.PP
|
Reconfigure an unpacked package. Packages in this state are not fully installed,
|
||||||
\fBreconfigure \fR\fB\fIpkgname | all\fR\fR
|
because they were not configured for whatever reason. The configure stage will
|
||||||
.RS 4
|
run the post-install action set on its INSTALL script and will change its state
|
||||||
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
|
to installed in the package database. The
|
||||||
\fIall\fR
|
.Em all
|
||||||
keyword can be used to reconfigure all not configured packages\&. If
|
keyword can be used to reconfigure all not configured packages. If
|
||||||
\fB\-f\fR
|
.Ql -f
|
||||||
option is used, the package will be reconfigured even if its state is already installed\&.
|
option is used, the package will be reconfigured even if its state is already installed.
|
||||||
.RE
|
.It Sy remove Ar pkgname(s)
|
||||||
.PP
|
|
||||||
\fBremove \fR\fB\fIpkgname(s)\fR\fR
|
|
||||||
.RS 4
|
|
||||||
Removes the installed package
|
Removes the installed package
|
||||||
\fIpkgname(s)\fR\&. Its files will be removed and its state will be changed to
|
.Em pkgname(s) .
|
||||||
\fIconfig\-files\fR
|
Its files will be removed and its state will be changed to
|
||||||
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
|
.Em config-files
|
||||||
\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
|
||||||
|
.Em config-files
|
||||||
state, it must be purged with the
|
state, it must be purged with the
|
||||||
\fIpurge\fR
|
.Em purge
|
||||||
command or alternatively use the
|
command or alternatively use the
|
||||||
\fB\-p\fR
|
.Ql -p
|
||||||
flag \&. If
|
flag. If
|
||||||
\fB\-f\fR
|
.Ql -f
|
||||||
option is used, package files will be
|
option is used, package files will be
|
||||||
\fBremoved even if its SHA256 hash don\(cqt match\fR\&.
|
.Em removed even if its SHA256 hash don't match .
|
||||||
.RE
|
.It Sy show Ar pkgname
|
||||||
.PP
|
|
||||||
\fBshow \fR\fB\fIpkgname\fR\fR
|
|
||||||
.RS 4
|
|
||||||
Shows information for installed package
|
Shows information for installed package
|
||||||
\fIpkgname\fR\&. This will print the size it takes in filesystem, description, maintainer, architecture and other information\&.
|
.Em pkgname .
|
||||||
.RE
|
This will print the size it takes in filesystem, description, maintainer,
|
||||||
.PP
|
architecture and other useful information.
|
||||||
\fBshow\-deps \fR\fB\fIpkgname\fR\fR
|
.It Sy show-deps Ar pkgname
|
||||||
.RS 4
|
Shows the list of dependencies that
|
||||||
Shows the list of dependencies that pkgname requires at run time\&.
|
.Em pkgname
|
||||||
.RE
|
requires at run time.
|
||||||
.PP
|
.It Sy show-files Ar pkgname
|
||||||
\fBshow\-files \fR\fB\fIpkgname\fR\fR
|
Shows the list of files that
|
||||||
.RS 4
|
.Em pkgname
|
||||||
Shows the list of files that pkgname contains\&.
|
contains.
|
||||||
.RE
|
.It Sy show-orphans
|
||||||
.PP
|
Shows the list of package orphans currently installed. Package orphans are
|
||||||
\fBshow\-orphans\fR
|
packages that were installed as dependencies of another package, but no other
|
||||||
.RS 4
|
package currently depends on.
|
||||||
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\&.
|
.It Sy show-revdeps Ar pkgname
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\fBshow\-revdeps \fR\fB\fIpkgname\fR\fR
|
|
||||||
.RS 4
|
|
||||||
Shows the reverse dependencies for
|
Shows the reverse dependencies for
|
||||||
\fIpkgname\fR\&. Reverse dependencies are packages that are currently depending in pkgname directly\&.
|
.Em pkgname .
|
||||||
.RE
|
Reverse dependencies are packages that are currently depending in
|
||||||
.PP
|
.Em pkgname
|
||||||
\fBupdate \fR\fB\fIpkgname(s)\fR\fR
|
directly.
|
||||||
.RS 4
|
.It Sy update Ar pkgname(s)
|
||||||
Updates
|
Updates
|
||||||
\fIpkgname(s)\fR
|
.Em pkgname(s)
|
||||||
to the most newer version available in repository pool\&. This can be used if only
|
to the most newer version available in repository pool. This can be used if only
|
||||||
\fIpkgname(s)\fR
|
.Em pkgname(s)
|
||||||
need to be updated, unlike the
|
need to be updated, unlike the
|
||||||
\fIautoupdate\fR
|
.Em autoupdate
|
||||||
target that will update all currently installed packages\&.
|
target that will update all currently installed packages.
|
||||||
.RE
|
.Sh PACKAGE STATES
|
||||||
.SH "PACKAGE STATES"
|
A package can be in a different state while it is being
|
||||||
.sp
|
.Em installed ,
|
||||||
A package can be in a different state while it is being installed, removed, unpacked, configured or purged\&. The following states are available:
|
.Em removed ,
|
||||||
.PP
|
.Em unpacked ,
|
||||||
\fBinstalled\fR
|
.Em configured
|
||||||
.RS 4
|
or
|
||||||
The package is fully installed, that means it was unpacked and configured correctly\&.
|
.Em purged .
|
||||||
.RE
|
The following states are available:
|
||||||
.PP
|
.Bl -tag -width ident
|
||||||
\fBhalf\-unpacked\fR
|
.It Sy installed
|
||||||
.RS 4
|
The package is fully installed, that means it was unpacked and configured correctly.
|
||||||
|
.It Sy half-unpacked
|
||||||
The package was being unpacked but didn't finish properly for unknown reasons.
|
The package was being unpacked but didn't finish properly for unknown reasons.
|
||||||
.RE
|
.It Sy unpacked
|
||||||
.PP
|
The package has been unpacked in destination root directory, but it is not fully
|
||||||
\fBunpacked\fR
|
installed because it was not yet configured. Please note that some packages will
|
||||||
.RS 4
|
do not work if they are only unpacked.
|
||||||
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\&.
|
.It Sy config-files
|
||||||
.RE
|
The package has been removed but configuration files and its metadata directory
|
||||||
.PP
|
are still available (and it is still registered in the package database).
|
||||||
\fBconfig\-files\fR
|
You can purge safely packages that are in this state, modified configuration
|
||||||
.RS 4
|
files will be preserved.
|
||||||
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\&.
|
.Sh FILES
|
||||||
.RE
|
.Bl -tag -width /var/db/xbps/metadata/<pkgname>/props.plist -compact
|
||||||
.PP
|
.It Pa /etc/xbps/xbps.conf
|
||||||
.SH "FILES"
|
Default XBPS configuration file.
|
||||||
.PP
|
.It Pa /var/db/xbps
|
||||||
\fB/etc/xbps/conf.plist\fR
|
XBPS global metadata directory.
|
||||||
.RS 4
|
.It Pa /var/db/xbps/metadata/<pkgname>/files.plist
|
||||||
Default XBPS configuration file\&.
|
Installed package metadata list of files.
|
||||||
.RE
|
.It Pa /var/db/xbps/metadata/<pkgname>/props.plist
|
||||||
.PP
|
Installed package metadata properties.
|
||||||
\fB/etc/xbps/repositories.plist\fR
|
.It Pa /var/db/xbps/regpkgdb.plist
|
||||||
.RS 4
|
XBPS master packages/properties database plist file.
|
||||||
Defaults XBPS repositories configuration file\&.
|
.It Pa /var/cache/xbps
|
||||||
.RE
|
XBPS cache directory for downloaded binary packages.
|
||||||
.PP
|
.Sh EXAMPLES
|
||||||
\fB/var/db/xbps\fR
|
Install a package by specifying a
|
||||||
.RS 4
|
.Em pkgname :
|
||||||
xbps global metadata directory\&.
|
.Pp
|
||||||
.RE
|
.Dl $ xbps-bin install foo
|
||||||
.PP
|
.Pp
|
||||||
\fB/var/db/xbps/metadata/<pkgname>\fR
|
Install a package by specifying a
|
||||||
.RS 4
|
.Em package pattern :
|
||||||
Installed package metadata directory\&.
|
.Pp
|
||||||
.RE
|
.Dl $ xbps-bin install \*qfoo>=3.0\*q
|
||||||
.PP
|
.Pp
|
||||||
\fB/var/db/xbps/metadata/<pkgname>/files\&.plist\fR
|
Install multiple packages by specifying
|
||||||
.RS 4
|
.Em pkgnames
|
||||||
Installed package metadata list of files\&.
|
and
|
||||||
.RE
|
.Em package patterns :
|
||||||
.PP
|
.Pp
|
||||||
\fB/var/db/xbps/metadata/<pkgname>/prop\&.plist\fR
|
.Dl $ xbps-bin install foo \*qblah<=4.0\*q baz-2.0 \*qblob>4.[0-9]\*q
|
||||||
.RS 4
|
.Pp
|
||||||
Installed package metadata properties\&.
|
Find the package that owns the file
|
||||||
.RE
|
.Pa /bin/mount :
|
||||||
.PP
|
.Pp
|
||||||
\fB/var/db/xbps/regpkgdb\&.plist\fR
|
.Dl $ xbps-bin find-files /bin/mount
|
||||||
.RS 4
|
.Pp
|
||||||
xbps master packages/properties database plist file\&.
|
Find the packages that match the pattern
|
||||||
.RE
|
.Pa "/usr/lib/libav*" :
|
||||||
.PP
|
.Pp
|
||||||
\fB/var/cache/xbps\fR
|
.Dl $ xbps-bin find-files \*q/usr/lib/libav*\*q
|
||||||
.RS 4
|
.Pp
|
||||||
xbps cache directory for downloaded binary packages\&.
|
Remove and purge the package
|
||||||
.RE
|
.Em proplib-devel :
|
||||||
.SH "EXAMPLES"
|
.Pp
|
||||||
.PP
|
.Dl $ xbps-bin -yp remove proplib-devel
|
||||||
\fBInstall\fR a package by specifying its \fBname\fR:
|
.Pp
|
||||||
.RS 4
|
Remove and purge the package
|
||||||
|
.Em bsdtar
|
||||||
$ xbps\-bin install foo
|
and
|
||||||
.RE
|
.Em recursively
|
||||||
.PP
|
all packages that were installed automatically by it:
|
||||||
\fBInstall\fR a package by specifying a \fBpackage pattern\fR:
|
.Pp
|
||||||
.RS 4
|
.Dl $ xbps-bin -Rp remove bsdtar
|
||||||
|
.Pp
|
||||||
$ xbps\-bin install "foo>=3\&.0"
|
.Sh SEE ALSO
|
||||||
.RE
|
.Xr xbps-repo 8 ,
|
||||||
.PP
|
.Xr http://code.google.com/p/xbps
|
||||||
\fBInstall multiple\fR packages by specifying \fBnames\fR and \fBpackage patterns\fR:
|
.Sh AUTHORS
|
||||||
.RS 4
|
.An Juan Romero Pardines <xtraeme@gmail.com>
|
||||||
|
.Sh BUGS
|
||||||
$ xbps\-bin install foo "blah<=4\&.0" baz\-2\&.0 "blob>4\&.[0\-9]"
|
Probably, but I try to make this not happen. Use it under your own
|
||||||
.RE
|
responsability and enjoy your life.
|
||||||
.PP
|
.Pp
|
||||||
\fBFind\fR the package that owns the file \fB/bin/mount\fR:
|
Report bugs in http://code.google.com/p/xbps.
|
||||||
.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>\&.
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user