.Dd July 26, 2013 .Os Void Linux .Dt xbps-query 8 .Sh NAME .Nm xbps-query .Nd XBPS utility to query for package and repository information .Sh SYNOPSYS .Nm xbps-query .Op OPTIONS .Ar MODE .Op PKG .Sh DESCRIPTION The .Nm utility prints information of a specific package or packages stored in target root directory or in registered repositories. 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 . .It by exact package name and version, i.e: .Dq Sy foo-1.0_1 . .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 . .Sh OPTIONS .Bl -tag -width -x .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 -defrepo Ar uri Default repository to be used if no repository is specified in configuration file. .It Fl d, Fl -debug Enables extra debugging shown to stderr. .It Fl h, Fl -help Show the help usage. .It Fl R, Fl -repository Enable repository mode. This mode explicitly looks in repositories, rather than looking in the target root directory. .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 V, Fl -version Shows the XBPS version. .Sh MODE Only one of the following modes can be used at a time. By default and unless the .Fl R option is specified, the target .Ar PKG will be queried in the root directory, otherwise it will be queried in registered repositories. .Bl -tag -width -x .It Fl l, Fl -list-pkgs Lists registered packages in the package database (pkgdb). A package can be in any of the following states: .Bl -item -width xx -compact .Pp .It .Sy ii Package is installed. .It .Sy uu Package is unpacked but must be configured with .Xr xbps-reconfigure 8 . .It .Sy hr Package is .Sy half-removed , and can be fully removed with .Xr xbps-remove 8 . .It .Sy ?? Package state is unknown. .El .It Fl L, Fl -list-repos Lists repositories and the number of packages contained on them. If a repository is not available the number of packages will be .Sy -1 . .It Fl m, Fl -list-manual-pkgs Lists registered packages in the package database (pkgdb) that were installed manually by the user (i.e not as dependency of any package). .It Fl O, Fl -list-orphans Lists package orphans in the package database (pkgdb), i.e packages that were installed as dependencies and no package is currently depending on them directly. .It Fl o, Fl -ownedby Ar PATTERN... Search for packages owning the files specified by .Ar PATTERN . The .Ar PATTERN argument can be a simple string or a shell wildcard pattern as explained in .Xr fnmatch 3 . Multiple patterns may be specified. .It Fl s, Fl -search Ar PATTERN... Search for packages matching .Ar PATTERN on its .Em pkgver and/or .Em short_desc properties. The same rules explained in the .Fl -ownedby option are applied, but a .Sy PACKAGE EXPRESSION is also supported. .It Fl f, Fl -files Ar PKG Show the package files for .Ar PKG . .It Fl p, Fl -property Ar PROP[,...] Ar PKG Show a property for .Ar PKG . Multiple properties can be specified by delimiting them with commas. .It Fl x, Fl -deps Ar PKG Show the required dependencies for .Ar PKG . Only direct dependencies are shown. To see a full dependency tree set it twice. .It Fl X, Fl -revdeps Ar PKG Show the reverse dependencies for .Ar PKG . .Sh ENVIRONMENT .Bl -tag -width XBPS_TARGET_ARCH .It Sy XBPS_TARGET_ARCH Overrides .Xr uname 2 machine result with this value. Useful to install packages of a different architecture. .Sh FILES .Bl -tag -width /var/db/xbps/..plist .It Ar /etc/xbps/xbps.conf Default configuration file. .It Ar /var/db/xbps/..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-create 8 , .Xr xbps-dgraph 8 , .Xr xbps-install 8 , .Xr xbps-pkgdb 8 , .Xr xbps-reconfigure 8 , .Xr xbps-remove 8 , .Xr xbps-rindex 8 .Sh AUTHORS .An Juan Romero Pardines .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 http://code.google.com/p/xbps.