131 lines
3.7 KiB
Groff
131 lines
3.7 KiB
Groff
.Dd April 21, 2014
|
|
.Os Void Linux
|
|
.Dt xbps-install 8
|
|
.Sh NAME
|
|
.Nm xbps-install
|
|
.Nd XBPS utility to install and update packages
|
|
.Sh SYNOPSYS
|
|
.Nm xbps-install
|
|
.Op OPTIONS
|
|
.Op PKG...
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility installs and updates packages in the target root directory.
|
|
The argument
|
|
.Ar PKG
|
|
is a package expression, which is explained in the
|
|
.Em PACKAGE EXPRESSION
|
|
section.
|
|
.Sh PACKAGE EXPRESSION
|
|
A package expression is a form to match a pattern; currently xbps
|
|
supports 3 ways to specify them:
|
|
.Bl -dash
|
|
.It
|
|
by package name, i.e:
|
|
.Dq Sy foo .
|
|
The package with the greatest version available in all repositories will be choosen.
|
|
.It
|
|
by exact package name and version, i.e:
|
|
.Dq Sy foo-1.0_1 .
|
|
The first package matching expression in a repository will be choosen.
|
|
.It
|
|
by specifying a package name and version separated by any of the following version comparators:
|
|
.Bl -item -width xx -compact
|
|
.Pp
|
|
.It
|
|
.Sy <
|
|
less than
|
|
.It
|
|
.Sy >
|
|
greater than
|
|
.It
|
|
.Sy <=
|
|
less or equal than
|
|
.It
|
|
.Sy >=
|
|
greater or equal than
|
|
.Pp
|
|
Example:
|
|
.Dq Sy foo>=2.0 .
|
|
The first package matching expression in a repository will be choosen.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width -x
|
|
.It Fl A, Fl -automatic
|
|
Enables automatic installation mode, i.e. package will be treated as orphan
|
|
if no package is depending on it directly.
|
|
.It Fl C, Fl -config Ar file
|
|
Specifies a full path to the XBPS configuration file.
|
|
.It Fl c, Fl -cachedir Ar dir
|
|
Specifies a full path to the cache directory, where binary packages are stored.
|
|
.It Fl d, Fl -debug
|
|
Enables extra debugging shown to stderr.
|
|
.It Fl f, Fl -force
|
|
Forcefully install target package even if another version is already installed,
|
|
overwritting regular package files and symlinks (if they have been modified) but
|
|
.Em preserving configuration files .
|
|
If
|
|
.Fl f
|
|
is specified twice,
|
|
.Em configuration files will also be overwritten .
|
|
.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 do anything.
|
|
.It Fl R, Fl -repository=uri
|
|
Repository to be added to the top of the list. This option can be specified multiple times.
|
|
.It Fl r, Fl -rootdir Ar dir
|
|
Specifies a full path for the target root directory.
|
|
.It Fl S, Fl -sync
|
|
Synchronize remote repository index files.
|
|
.It Fl u, Fl -update
|
|
Update target package(s) rather than install. If
|
|
.Op PKG
|
|
not set, all installed packages will be updated.
|
|
.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.
|
|
.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).
|
|
.Sh FILES
|
|
.Bl -tag -width /var/db/xbps/.<pkgname>.plist
|
|
.It Ar /etc/xbps/xbps.conf
|
|
Default configuration file.
|
|
.It Ar /var/db/xbps/.<pkgname>.plist
|
|
Package metadata properties.
|
|
.It Ar /var/db/xbps/pkgdb-0.21.plist
|
|
Default package database (0.21 format). Keeps track of installed packages and properties.
|
|
.It Ar /var/cache/xbps
|
|
Default cache directory to store downloaded binary packages.
|
|
.Sh SEE ALSO
|
|
.Xr xbps-checkvers 8 ,
|
|
.Xr xbps-create 8 ,
|
|
.Xr xbps-dgraph 8 ,
|
|
.Xr xbps-pkgdb 8 ,
|
|
.Xr xbps-query 8 ,
|
|
.Xr xbps-reconfigure 8 ,
|
|
.Xr xbps-remove 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
|