q applets/pt-br

Resources

Project

GitHub

GitWeb

As q applets são uma coleção de pequenas e rápidas ferramentas auxiliares do Portage escritas em C. Este guia aborda alguns usos comuns destas ferramentas auxiliares, que são fornecidas através do pacote app-portage/portage-utils.

O pacote app-portage/portage-utils é uma coleção de utilitários muito rápidos escritos em C, que são destinados a oferecer uma alternativa mais rápida, mas mais limitada que seu homólogo app-portage/gentoolkit. Por favor note que as q applets não destinam a substituir o gentoolkit. Os utilitários podem ser muito mais eficientes do que os equivalentes do gentoolkit e podem ser mais adequados para serem usados em scripts que precisam chamar o Portage repetidamente, mas elas "não" oferecem a mesma funcionalidade. q applets não consideram eclasses e não fornecem ferramentas como revdep-rebuild ou glsa-check.

Instalação

USE flags

USE flags for app-portage/portage-utils Small and fast Portage helper tools written in C

+qmanifest	Build qmanifest applet, this adds additional dependencies for GPG, OpenSSL and BLAKE2B hashing
+qtegrity	Build qtegrity applet, this adds additional dependencies for OpenSSL
openmp	Build support for the OpenMP (support parallel computing), requires >=sys-devel/gcc-4.2 built with USE="openmp"
static	!!do not set this during bootstrap!! Causes binaries to be statically linked instead of dynamically

Data provided by the Gentoo Package Database · Last update: 2025-01-25 03:40 More information about USE flags

Emerge

Instalar q applets:

root #emerge --ask app-portage/portage-utils

Configuração

Antes de usar os applets primeiro inicialize o cache:

root #q -r

Uso

Invocação

A lista completa das aplicações que são fornecidos pelo app-portage/portage-utils podem ser listados digitando man q ou q --help. Por favor, leia a página de manual para cada utilitário descrito, como este guia serve apenas para ser uma breve referência para as funções mais úteis e não inclui todas as informações sobre cada aplicação.

Para ver os applets disponíveis com uma breve descrição de suas funções, use q --help:

user $q --help

Usage: q <applet> <args>  : invoke a portage utility applet
  
Currently defined applets:
        q <applet> <args> : virtual applet
    qatom <pkg>           : split atom strings
   qcache <action> <args> : search the metadata cache
   qcheck <pkgname>       : verify integrity of installed packages
 qdepends <pkgname>       : show dependency info
    qfile <filename>      : list all pkgs owning files
    qgrep <misc args>     : grep in ebuilds
    qlist <pkgname>       : list files owned by pkgname
     qlop <pkgname>       : emerge log analyzer
   qmerge <pkgnames>      : fetch and merge binary package
     qpkg <misc args>     : manipulate Gentoo binpkgs
  qsearch <regex>         : search pkgname/desc
    qsize <pkgname>       : calculate size usage
    qtbz2 <misc args>     : manipulate tbz2 packages
     quse <useflag>       : find pkgs using useflags
    qxpak <misc args>     : manipulate xpak archives
  
Options: -[irmM:vqChV]
  -i, --install        * Install symlinks for applets
  -r, --reinitialize   * Reinitialize ebuild cache
  -m, --metacache      * Reinitialize metadata cache
  -M, --modpath  <arg> * Module path
  -v, --verbose        * Make a lot of noise
  -q, --quiet          * Tighter output; suppress warnings
  -C, --nocolor        * Don't output color
  -h, --help           * Print this help and exit
  -V, --version        * Print version and exit

Como encontrar um pacote ao qual um arquivo pertence (qfile)

O comando qfile encontra um pacote ao qual o arquivo pertence:

user $qfile /etc/fonts/fonts.conf

media-libs/fontconfig (/etc/fonts/fonts.conf)

user $qfile /usr/share/keymaps/atari/atari-uk-falcon.map.gz

sys-apps/kbd (/usr/share/keymaps/atari/atari-uk-falcon.map.gz)

Verificando a integridade dos pacotes (qcheck)

Para verificar as somas MD5 ou tempo de modificação dos arquivos instalados por algum pacote, use a aplicação qcheck:

user $qcheck portage-utils

Checking app-portage/portage-utils-0.1.13 ...
  * 36 out of 36 files are good

É claro, todos os arquivos que foram modificados após a instalação serão reportados aqui. Se a aplicação reportar arquivos de configuração que foram editados manualmente após a instalação, então não há nada para se preocupar.

Listando pacotes que dependem de algum pacote (qdepends)

Claro que há também uma aplicação que permite listar todos os pacotes que dependem de algum pacote. Isto é feito usando qdepends. Use a opção -a para mostrar todas as informações de DEPEND, RDEPEND e PDEPEND para um pacote.

user $qdepends -a pygtk

 * DEPEND
dev-python/pygtk-2.8.2: >=dev-lang/python-2.3 >=x11-libs/gtk+-2.8.0
>=dev-libs/glib-2.8.0 >=x11-libs/pango-1.10.0 >=dev-libs/atk-1.8.0
>=gnome-base/libglade-2.5.0 >=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl >=x11-libs/gtkglarea-1.99
>=dev-util/pkgconfig-0.9 sys-devel/patch
 * RDEPEND
dev-python/pygtk-2.8.2: >=dev-lang/python-2.3 >=x11-libs/gtk+-2.8.0
>=dev-libs/glib-2.8.0 >=x11-libs/pango-1.10.0 >=dev-libs/atk-1.8.0
>=gnome-base/libglade-2.5.0 >=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl >=x11-libs/gtkglarea-1.99
 * PDEPEND

Listando todos os pacotes (instalados ou não) que dependem de algum pacote (qgrep)

As q applets podem ser usadas para encontrar ebuilds que mencionam o nome de um ebuild ("libechonest" é usado no exemplo abaixo) com grande velocidade:

user $qgrep -H libechonest | cut -f1 -d":" | uniq

media-libs/libechonest/libechonest-2.0.2.ebuild
media-libs/libechonest/libechonest-2.2.0-r1.ebuild
media-libs/libechonest/libechonest-2.3.0.ebuild
media-libs/libechonest/libechonest-2.3.1.ebuild
media-libs/libechonest/libechonest-2.3.1-r1.ebuild
media-libs/libechonest/libechonest-9999.ebuild
media-sound/clementine/clementine-1.2.3.ebuild
media-sound/clementine/clementine-1.2.3-r1.ebuild
media-sound/clementine/clementine-1.3.1-r1.ebuild
media-sound/tomahawk/tomahawk-0.8.4-r3.ebuild
media-sound/tomahawk/tomahawk-9999.ebuild

Listando arquivos que pertencem à um ebuild (qlist)

O comando qlist apresenta uma lista de todos os arquivos que pertencem à um ebuild.

user $qlist vim

/usr/bin/gvim
/usr/bin/gvimdiff
/usr/bin/evim
/usr/bin/eview
/usr/bin/gview
/usr/bin/rgvim
[...]

Procurando por pacotes que usam alguma USE flag (quse)

Listar o uso de USE flags é feito com quse, que deve ser executado com permissões de root.

user $quse firefox

app-misc/tracker/tracker-0.12.10-r1.ebuild applet doc eds elibc_glibc exif firefox-bookmarks flac flickr gif
[...]

Encontrando o tamanho dos pacotes (qsize)

Para mostrar o tamanho de um pacote, use a aplicação qsize:

user $qsize vim

app-editors/gvim-6.4: 10 files, 7 non-files, 2327.516 KB
app-editors/vim-6.4: 6 files, 2 non-files, 2058.14 KB
app-editors/vim-core-6.4: 1024 files, 68 non-files, 10950.984 KB
[...]

Pesquisando na árvore do Portage (qsearch)

Uma das ferramentas mais poderosas do app-portage/portage-utils é o qsearch. Esta ferramenta permite pesquisar a árvore do Portage muito mais rápido do que usar o comando emerge -s.

Aqui estão alguns exemplos de seu uso:

user $qsearch terminus

media-fonts/terminus-font A clean fixed font for the console and X11

A página inicial dos pacotes pode ser consultada usando a opção -H:

user $qsearch -H terminus

media-fonts/terminus-font http://www.is-vn.bg/hamster/jimmy-en.html

Em outro exemplo, vamos olhar para o cliente jabber:

user $qsearch -S "jabber client"

app-emacs/emacs-jabber A Jabber client for Emacs.
net-im/gajim Jabber client written in PyGTK
net-im/gnome-jabber Gnome Jabber Client
net-im/gossip Lightweight Jabber client for GNOME
net-im/imcom Python commandline Jabber Client
net-im/psi QT 3.x Jabber Client, with Licq-like interface
net-im/tkabber Featureful Jabber client for tcl/tk.
x11-themes/psi-themes Iconsets for Psi, a QT 3.x Jabber Client

Extraindo informações de log do emerge (qlop)

Há também uma ferramenta que possibilita extrair informações úteis do arquivo emerge.log. É chamada de qlop e pode ser útil quando o tempo de compilação do pacote precisa ser estimado ou para comparar o tempo de construção com outros sistemas. Permite também verificar o que está compilando no momento e quanto tempo isso vai levar - o que é útil quando se trabalha no console e não tem nenhum outro meio para verificar.

Para ver quanto tempo uma construção do dev-lang/perl geralmente leva:

user $qlop -tH perl

perl: 7 minutes, 52 seconds for 4 merges

Para ver o que está instalando no momento e há quanto tempo o processo já está em execução:

user $qlop -c

* perl-5.8.8-r23
    started: Mon May 21 12:41:11 2007
    elapsed: 19 seconds

Veja também

• Gentoolkit - Um conjunto de ferramentas para facilitar a administração de um sistema Gentoo.
• Qcheck - Uma ferramenta de linha de comando usada para verificar a integridade dos pacotes instalados.

---

This page is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: Łukasz Damentko, Joshua Saddler, and Marcelo Góes
They are listed here because wiki history does not allow for any external attribution. If you edit the wiki article, please do not add yourself here; your contributions are recorded on each article's associated history page.