.\" generated by mkman.py, please do NOT edit!
.TH q "1" "Jan 2024" "Gentoo Foundation" "q"
.SH NAME
q \- invoke a portage utility applet
.SH SYNOPSIS
.B q
\fI<applet> <args> \fR
.SH DESCRIPTION
.I q
is a collection of utilities for use with Gentoo systems regarding
installed and available packages.
.P
After version 0.74 of portage-utils, the cache functionality was removed
in favour of using various trees directly, and optionally the caches
therein.  As such the \fB-r\fR and \fB-m\fR options were removed.  It is
no longer necessary to initialise the cache at any time.
.P
After version 0.82, the \fB-m\fR flag got repurposed for listing masks.
.SH OPTIONS
.TP
\fB\-i\fR, \fB\-\-install\fR
Install symlinks for applets.
.TP
\fB\-o\fR, \fB\-\-overlays\fR
Print available overlays (read from repos.conf).  Use \fI-v\fR to
see the source (file) where the overlay was declared.
.TP
\fB\-e\fR, \fB\-\-envvar\fR
Print used environment variables and found values.  Use \fI-v\fR to
see the source (file, environment) where the variable was declared.
Additional arguments are treated as variable names to print the
values for.  If just one name is given, only the value is printed if
matched.  When no arguments or more than one argument is given, the
variable name and the value is printed as a shell-style declaration.
.TP
\fB\-m\fR, \fB\-\-masks\fR
Print the masks from package.mask files found.  Use \fI-v\fR to see
the source (file) where the mask was declared.  Use multiple
\fI-v\fR to print the comment right before the mask.  Additional
arguments are treated as atom selectors which must match the masks.
.TP
\fB\-\-root\fR \fI<arg>\fR
Set the ROOT env var.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Report full package versions, emit more elaborate output.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Tighter output; suppress warnings.
.TP
\fB\-C\fR, \fB\-\-nocolor\fR
Don't output color.
.TP
\fB\-\-color\fR
Force color in output.
.TP
\fB\-h\fR, \fB\-\-help\fR
Print this help and exit.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version and exit.
.SH APPLETS
.nf
.B This applet also has sub applets:
         q <applet> <args> : virtual applet
     qatom <pkg>           : split atom strings
    qcheck <pkgname>       : verify integrity of installed packages
  qdepends <pkgname>       : show dependency info
     qfile <filename>      : list all pkgs owning files
     qgrep <expr> [pkg ...]: grep in ebuilds
  qkeyword <action> <args> : list packages based on keywords
     qlist <pkgname>       : list files owned by pkgname
      qlop <pkgname>       : emerge log analyzer
 qmanifest <misc args>     : verify or generate thick Manifest files
    qmerge <pkgnames>      : fetch and merge binary package
      qpkg <misc args>     : create or manipulate Gentoo binpkgs
   qsearch <regex>         : search pkgname/desc
     qsize <pkgname>       : calculate size usage
     qtbz2 <misc args>     : manipulate tbz2 packages
  qtegrity <misc args>     : verify files with IMA
      quse <useflag>       : find pkgs using useflags
    qwhich <pkg ...>       : find path to pkg
     qxpak <misc args>     : manipulate xpak archives
.fi
.SH "REPORTING BUGS"
Please report bugs via http://bugs.gentoo.org/
.br
Product: Gentoo Linux; Component: Current packages
.SH AUTHORS
.nf
Ned Ludd <solar@gentoo.org>
Mike Frysinger <vapier@gentoo.org>
Fabian Groffen <grobian@gentoo.org>
.fi
.SH "SEE ALSO"
.BR qatom (1),
.BR qcheck (1),
.BR qdepends (1),
.BR qfile (1),
.BR qgrep (1),
.BR qkeyword (1),
.BR qlist (1),
.BR qlop (1),
.BR qmanifest (1),
.BR qmerge (1),
.BR qpkg (1),
.BR qsearch (1),
.BR qsize (1),
.BR qtbz2 (1),
.BR qtegrity (1),
.BR quse (1),
.BR qwhich (1),
.BR qxpak (1)