Gentoo es una distribución única y presenta algunas complejidades que simplemente no existen en otras distribuciones. A medida que desarrolladores y colaboradores de Gentoo descubrían algunas de estas complejidades, escribieron herramientas para ayudar a usuarios y administradores a trabajar entre ellas. Muchas de estas herramientas han sido escritas para el proyecto Gentoo y se incluyen en el paquete app-portage/gentoolkit.
Nota: En la actualidad existen dos versiones de gentoolkit: app-portage/gentoolkit y app-portage/gentoolkit-dev. Mientras que el primero contiene scripts de administración, el último contiene scripts específicos para reforzar el desarrollo en Gentoo. Si es desarrollador, puede incluir sus scripts en gentoolkit-dev poniéndose en contacto con el responsable del mantenimiento de Gentoolkit. Este documento únicamente habla de gentoolkit. |
Gentoolkit contiene un gran grupo de herramientas útiles para ayudar a administrar los paquetes y seguirle la pista a lo que ocurre en su sistema. La mayoría de usuarios --particularmente aquellos que a menudo actualizan sus sistemas-- se beneficiarán de tener gentoolkit instalado.
Como en cualquier paquete de Gentoo, la instalación es sólo un simple emerge.
Listado de Código 1.1: Obtener gentoolkit |
# emerge gentoolkit
|
Nota: Muchas de las herramientas en gentoolkit revelan información importante sobre el sistema o requieren permisos de usuario root. Por esa razón, algunos de los programas sólo pueden ser ejecutados (o sólo funcionan correctamente) si se ejecutan con un usuario con permisos de root. |
Cualquier documentación que un programa pudiera tener (exceptuando las páginas man) se encuentra en /usr/share/doc/gentoolkit-[versión]/[nombre-del-programa]/.
equery es una herramienta que proporciona muchísima información acerca de los paquetes de su sistema y más. equery --help le da el listado completo de opciones.
Nota: No todas las características listadas por equery --help han sido implementadas todavía. Las que no, están claramente marcadas. También verá que cada comando tiene una opción reducida; p.e. b en vez de belongs. |
Nota: Sea consciente de que equery actualmente cambia el formato de la salida si ésta es enviada a través de una tubería. Este tipo de formato está pensado para facilitar a las herramientas el análisis de la salida, aunque también puede deshabilitarlo añadiendo la opción --no-pipe. Si escribe scripts que emplean equery, debería ser cuidadoso con esto. |
Averiguar el paquete del que proviene un fichero
equery también proporciona la funcionalidad de encontrar el paquete del cual proviene un fichero empleando para ello el comando belongs (o solamente b).
Listado de Código 2.1: Averiguar el ebuild que instaló un fichero dado |
# equery belongs /usr/bin/audacious
[ Searching for file(s) /usr/bin/audacious in *... ]
media-sound/audacious-1.1.2 (/usr/bin/audacious)
|
Utilizando la opción -f, puede buscar paquetes con los ficheros que coincidan con cualquier expresión regular. La opción -e es útil para detener su búsqueda inmediatamente cuando se encuentre una coincidencia.
Comprobar la integridad de los paquetes
A veces es útil comprobar la integridad de un paquete. equery puede verificar sumas md5 así como marcas de tiempo para indicar cuándo un paquete pudo haber sido corrompido, reemplazado o borrado.
Listado de Código 2.2: Comprobar la integridad de un paquete |
# equery check gentoolkit
[ Checking app-portage/gentoolkit-0.2.0 ]
* 54 out of 54 files good
|
Por favor, dese cuenta de que si cambia ficheros de configuración después de una instalación, éstos serán reportados como "not good"
Lista de todos los paquetes que dependen de ...
equery es capaz de listar todas las dependencias directas relacionadas con un paquete. La función que debemos utilizar para ello es depends y es tan fácil cómo:
Listado de Código 2.3: Buscar paquetes que dependan de pygtk |
# equery depends pygtk
[ Searching for packages depending on pygtk... ]
app-office/dia-0.93
dev-python/gnome-python-2.0.0-r1
gnome-extra/gdesklets-core-0.26.2
media-gfx/gimp-2.0.4
x11-libs/vte-0.11.11-r1
|
equery es capaz de darnos un gráfico de dependencias para un determinado paquete. Este gráfico ofrece un listado de todos los paquetes que tienen dependencias directas e indirectas con el paquete en cuestión.
Listado de Código 2.4: El gráfico de dependencias para cdrtools |
# equery depgraph cdrtools
Displaying dependencies for app-cdr/cdrtools-2.01_alpha37
`-- app-cdr/cdrtools-2.01_alpha37
`-- sys-libs/glibc-2.3.4.20040808 (virtual/libc)
`-- sys-kernel/linux-headers-2.4.22 (virtual/os-headers)
`-- sys-apps/baselayout-1.10.4
`-- sys-apps/sysvinit-2.85-r1
`-- sys-apps/gawk-3.1.3-r1
`-- sys-apps/util-linux-2.12-r4
`-- sys-apps/sed-4.0.9
`-- sys-libs/ncurses-5.4-r4
`-- sys-apps/pam-login-3.14
`-- sys-libs/pam-0.77-r1
`-- sys-libs/cracklib-2.7-r10
`-- sys-apps/miscfiles-1.3-r1
`-- app-arch/gzip-1.3.5-r1
`-- sys-apps/portage-2.0.50-r10
|
Por ejemplo, mientras que glibc es una dependencia directa para cdrtools, los linux-headers le son una dependencia indirecta. Observe que la salida también incluye información sobre paquetes virtuales. En el ejemplo de arriba, cdrtools está realmente escrito para requerir virtual/libc y no sys-libs/glibc pero en el sistema dado en el ejemplo sys-libs/glibc proporciona virtual/libc.
Listar los ficheros que pertenezcan a un ebuild
equery puede listar los ficheros que pertenecen a un ebuild instalado. Si no conozco los ficheros que Gentoolkit ha instalado en el sistema, usaré equery para mostrarlos.
Listado de Código 2.5: Listar los ficheros |
# equery files gentoolkit
[ Searching for packages matching gentoolkit... ]
app-portage/gentoolkit-0.2.0
* Contents of app-portage/gentoolkit-0.2.0:
/usr
/usr/bin
/usr/bin/equery
/usr/bin/etcat
/usr/bin/euse
/usr/bin/glsa-check
/usr/bin/qpkg
/usr/bin/revdep-rebuild
/usr/lib
/usr/lib/gentoolkit
/usr/lib/gentoolkit/pym
/usr/lib/gentoolkit/pym/gentoolkit
/usr/lib/gentoolkit/pym/gentoolkit/__init__.py
/usr/lib/gentoolkit/pym/gentoolkit/gentoolkit.py
/usr/lib/gentoolkit/pym/gentoolkit/pprinter.py
/usr/lib/gentoolkit/pym/glsa.py
/usr/sbin
/usr/share
/usr/share/doc
/usr/share/doc/gentoolkit-0.2.0_pre10
[...]
|
El comando files de equery proporciona algunas opciones para modificar la salida. Puede encontrarlas todas en la página man deequery.
Buscar paquetes que usan un parámetro USE específico
Si quiere encontrar los paquetes de su sistema que hacen uso de un parámetro USE en concreto, equery tiene para ello la función hasuse:
Listado de Código 2.6: Buscar paquetes que usan el parámetro USE firefox |
# equery hasuse firefox
[ Searching for USE flag firefox in all categories among: ]
* installed packages
[I--] [ ] dev-python/gnome-python-extras-2.14.0-r1 (0)
[I--] [ ] media-video/totem-2.16.4 (0)
|
equery tiene una potente característica para listar paquetes que pertenecen a nuestro sistema, a portage o incluso en el overlay (directorio extensión de portage). Probemos ésto:
Listado de Código 2.7: Listar paquetes con equery |
# equery list gentoolkit
[ Searching for package 'gentoolkit' in all categories among: ]
* installed packages
[I--] [ ] app-portage/gentoolkit-0.2.0 (0)
|
La consulta estándar buscará nuestros paquetes instalados para el nombre dado. Si encuentra algo, la siguiente información será mostrada: la localización del paquete entre el primer par de corchetes (I para paquetes instalados, P para Portage, O para Overlay), las posibles máscaras entre el segundo par (~ para keyword, - para arquitectura o M para hard masked), luego la categoría, el nombre completo y, por último, el slot en el que el paquete está almacenado.
Otro ejemplo, esta vez vamos a usar las opciones locales en orden para buscar paquetes en nuestro árbol portage y overlay.
Listado de Código 2.8: Empleando opciones locales con equery |
# equery list -p -o vim
[ Searching for package 'vim' in all categories among: ]
* installed packages
[I--] [ ] app-editors/vim-6.3-r4 (0)
* Portage tree (/usr/portage)
[-P-] [M~] app-editors/vim-7.0_alpha20050126 (0)
[-P-] [M~] app-editors/vim-7.0_alpha20050201 (0)
[-P-] [ ] app-editors/vim-6.3-r2 (0)
[-P-] [M~] app-editors/vim-7.0_alpha20050122 (0)
[-P-] [M~] app-editors/vim-core-7.0_alpha20050126 (0)
[-P-] [ ] app-editors/vim-core-6.3-r3 (0)
[-P-] [M~] app-editors/vim-core-7.0_alpha20050122 (0)
[-P-] [M~] app-editors/vim-core-7.0_alpha20050201 (0)
[-P-] [ ] app-editors/vim-core-6.3-r4 (0)
* overlay tree (/opt/ebuilds)
|
Averiguar el tamaño de los paquetes
¿Alguna vez ha tenido la curiosidad de averiguar cuánto espacio ocupa un paquete concreto? Desde que un paquete puede tener sus archivos repartidos en más de un directorio, puede que el habitual du -hc no le proporcione una cifra correcta. No se preocupe, ¡equery viene al rescate!
Listado de Código 2.9: Tamaño del paquete |
# equery size openoffice-bin
* app-office/openoffice-bin-1.1.2
Total Files : 2908
Total Size : 223353.31 KiB
|
Como puede ver, equery escribe el espacio total ocupado en kilobytes y además lista la cantidad de archivos que tiene el paquete.
Listado de parámetros USE por paquete
equery puede usarse para darnos información acerca de qué parámetros USE están siendo usados por un paquete en concreto. También nos dice cuáles son nuestros parámetros USE actuales para un paquete y, además, cuáles están disponibles para ese paquete.
Listado de Código 2.10: Activar y desactivar parámetros USE |
# equery uses wireshark
[ Colour Code : set unset ]
[ Legend : (U) Col 1 - Current USE flags ]
[ : (I) Col 2 - Installed With USE flags ]
U I [ Found these USE variables in : net-analyzer/wireshark-0.99.4 ]
- - adns : Adds support for the adns DNS client library
+ + gtk : Adds support for x11-libs/gtk+ (The GIMP Toolkit)
- - ipv6 : Adds support for IP version 6
- - kerberos : Adds kerberos support
- - portaudio : Adds support for the crossplatform portaudio audio API
- - selinux : !!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur
- - snmp : Adds support for the Simple Network Management Protocol if available
+ + ssl : Adds support for Secure Socket Layer connections
- - threads : Adds threads support for various packages. Usually pthreads
|
He instalado wireshark con sólo los parámetros gtk y ssl activados, aunque hay varios otros disponibles para wireshark. Para más información sobre los parámetros USE, por favor consulte el capítulo Parámetros USE del Manual Gentoo.
Podemos averiguar qué ebuild está siendo utilizado por un paquete en concreto con equery. Esto se hace con el comando equery which, que muestra la ruta completa del ebuild.
Listado de Código 2.11: Mostrar la ruta del ebuild |
# equery which cdrtools
/usr/portage/app-cdr/cdrtools/cdrtools-2.01_alpha37.ebuild
|
euse es una herramienta para ver, activar y desactivar los parámetros USE en varios lugares. Para más información acerca de los parámetros USE, por favor consulte el documento Parámetros USE. Por favor, use euse -h para ver la ayuda completa y todas las opciones.
Ver, activar y desactivar los parámetros USE
El comando euse -a lee y muestra los actuales parámetros USE activos.
Nota: Hay 5 "columnas" que euse utiliza para mostrar si un parámetro está activo/inactivo y donde se ha activado cada uno de ellos. Las columnas están como sigue: +/-, activado en el Entorno, activado en make.Conf, activado en make.Defaults y activado en make.Globals. La salida se asemeja a [+ECDG]. |
Listado de Código 3.1: Mostrar todos los parámetros USE activos |
# euse -a
X [+ CD ]
aalib [+ ]
acpi [+ C ]
alsa [+ C ]
apache2 [+ C ]
apm [+ D ]
avi [+ D ]
berkdb [+ D ]
bitmap-fonts [+ D ]
bonobo [+ ]
cdr [+ C ]
crypt [+ CD ]
cscope [+ C ]
cups [+ CD ]
curl [+ ]
emboss [+ D ]
encode [+ D ]
esd [+ ]
fam [+ ]
fbcon [+ C ]
firefox [+ C ]
font-server [+ D ]
foomaticdb [+ D ]
fortran [+ D ]
gd [+ C ]
gdbm [+ D ]
gif [+ CD ]
gimpprint [+ C ]
gnome [+ CD ]
gphoto2 [+ ]
gpm [+ CD ]
gstreamer [+ C ]
gtk [+ D ]
gtkhtml [+ C ]
guile [+ ]
imagemagick [+ ]
imlib [+ CD ]
innodb [+ ]
ipv6 [+ D ]
javascript [+ C ]
jpeg [+ CD ]
kde [+ D ]
ldap [+ ]
libg++ [+ CD ]
libwww [+ CD ]
mad [+ CD ]
mbox [+ C ]
md5sum [+ C ]
mikmod [+ CD ]
mmx [+ C ]
motif [+ CD ]
mp3 [+ ]
mpeg [+ CD ]
mpeg4 [+ C ]
mysql [+ C ]
ncurses [+ CD ]
nls [+ D ]
nvidia [+ C ]
odbc [+ ]
offensive [+ ]
ogg [+ CD ]
opengl [+ CD ]
oss [+ D ]
pam [+ CD ]
pdflib [+ CD ]
perl [+ CD ]
png [+ CD ]
python [+ CD ]
qt [+ D ]
quicktime [+ CD ]
readline [+ CD ]
ruby [+ ]
sdl [+ CD ]
slang [+ D ]
spell [+ CD ]
sse [+ C ]
ssl [+ CD ]
svga [+ CD ]
tcltk [+ C ]
tcpd [+ D ]
tiff [+ C ]
truetype [+ CD ]
usb [+ C ]
vanilla [+ C ]
x86 [+ C ]
xml [+ ]
xosd [+ C ]
xv [+ CD ]
xvid [+ C ]
zlib [+ CD ]
|
Del mismo modo, puede usar el comando euse -a -g para ver sólo los parámetros USE globales activados. El comando euse -a -l hace lo mismo para los parámetros USE locales activados. -g & -l son subopciones de euse y requieren de una opción anterior a ellos (como -a) para funcionar correctamente.
Listado de Código 3.2: Mostrar los parámetros USE locales activados |
# euse -a -l
bitmap-fonts [+ D ]
font-server [+ D ]
fortran [+ D ]
gimpprint [+ C ]
md5sum [+ C ]
mpeg4 [+ C ]
nvidia [+ C ]
offensive [+ ]
truetype [+ CD ]
|
También podemos usar euse para activar o desactivar parámetros use. Los comandos empleados para ello son euse -E flagname (habilita un parámetro) y euse -D flagname (inhabilita un parámetro).
Aviso: No utilice los comandos euse -E y euse -D por ellos mismos (sin un parámetro). Sino activará/desactivará TODOS los parámetros USE en /etc/make.conf. Aunque se mantenga una copia de seguridad en /etc/make.conf.euse_backup, por favor tenga cuidado a la hora de usar euse -E o euse -D. |
Listado de Código 3.3: Activar y desactivar parámetros USE |
(Habilitar un parámetro USE) # euse -E 3dfx /etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup (/etc/make.conf después de ejecutar el comando) USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ ogg odbc offensive opengl pam pdflib perl png python \ quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ vanilla X xosd xv xvid x86 zlib 3dfx" (Inhabilitar un parámetro USE) # euse -D 3dfx /etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup (/etc/make.conf después de ejecutar el comando) USE="alsa acpi apache2 -arts cups cdr crypt cscope -doc fbcon \ firefox gd gif gimpprint gnome gpm gstreamer gtkhtml imlib \ innodb -java javascript jpeg libg++ libwww mad mbox md5sum \ mikmod mmx motif mpeg mpeg4 mysql ncurses nvidia \ ogg odbc offensive opengl pam pdflib perl png python \ quicktime readline sdl spell sse ssl svga tcltk tiff truetype usb \ vanilla X xosd xv xvid x86 zlib -3dfx" |
Nota: euse no borra físicamente el parámetro de make.conf. Solo le antepone el signo - (menos) para desactivarlo. Puede que tenga que limpiar manualmente su make.conf para deshacerse de parámetros que no quiera. |
Esta herramienta es el reconstructor de dependencias inversas de Gentoo. Realizará una búsqueda de todos los ebuilds instalados que no funcionen a causa de alguna actualización de un paquete del cual dependan. Puede hacer un emerge de esos paquetes por usted pero puede ocurrir que un paquete determinado ya no funcione con las actuales dependencias instaladas, en cuyo caso, debe actualizar el paquete que no funciona a una versión más reciente. revdep-rebuild le pasará parámetros a emerge que te permiten hacer uso de --pretend para ver qué paquetes se van a emerger de nuevo antes de proceder.
Listado de Código 4.1: Ejecutar revdep-rebuild en modo pretend |
# revdep-rebuild -p
Checking reverse dependencies...
Packages containing binaries and libraries broken by any package update,
will be recompiled.
Collecting system binaries and libraries... done.
(/root/.revdep-rebuild.1_files)
Collecting complete LD_LIBRARY_PATH... done.
(/root/.revdep-rebuild.2_ldpath)
Checking dynamic linking consistency...
broken /usr/lib/ao/plugins-2/libarts.so (requires libartsc.so.0)
broken /usr/lib/kde3/libkpresenterpart.so (requires libartskde.so.1 libqtmcop.so.1
libsoundserver_idl.so.1 libkmedia2_idl.so.1 libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
broken /usr/lib/ruby/site_ruby/1.8/i686-linux/fox.so (requires libFOX-1.0.so.0)
broken /usr/lib/xine/plugins/1.0.0/xineplug_ao_out_arts.so (requires libartsc.so.0)
broken /usr/lib/perl5/vendor_perl/5.8.0/i686-linux/auto/SDL_perl/SDL_perl.so (requires libSDL_gfx.so.0)
broken /usr/lib/libloudmouth-1.so.0.0.0 (requires libgnutls.so.10)
broken /usr/bin/k3b (requires libartskde.so.1 libqtmcop.so.1 libsoundserver_idl.so.1 libkmedia2_idl.so.1
libartsflow.so.1 libartsflow_idl.so.1 libmcop.so.1)
broken /usr/bin/lua (requires libhistory.so.4)
broken /usr/bin/lyx (requires libAiksaurus-1.0.so.0)
broken /usr/bin/luac (requires libhistory.so.4)
broken /usr/bin/avidemux2 (requires libartsc.so.0)
broken /usr/bin/pptout (requires libxml++-0.1.so.11)
broken /usr/bin/xml2ps (requires libxml++-0.1.so.11)
done.
(/root/.revdep-rebuild.3_rebuild)
Assigning files to ebuilds... done.
(/root/.revdep-rebuild.4_ebuilds)
Evaluating package order... done.
(/root/.revdep-rebuild.5_order)
All prepared. Starting rebuild...
emerge --oneshot --nodeps -p =app-cdr/k3b-0.11.14 =app-office/koffice-1.3.2 =app-office/lyx-1.3.4 \
=app-office/passepartout-0.2 =dev-lang/lua-5.0.2 =dev-ruby/fxruby-1.0.29 =media-libs/libao-0.8.5 \
=media-libs/xine-lib-1_rc5-r3 =media-video/avidemux-2.0.26 =net-libs/loudmouth-0.16
These are the packages that I would merge, in order:
Calculating dependencies ...done!
[ebuild R ] app-cdr/k3b-0.11.14
[ebuild R ] app-office/koffice-1.3.2
[ebuild R ] app-office/lyx-1.3.4
[ebuild R ] app-office/passepartout-0.2
[ebuild R ] dev-lang/lua-5.0.2
[ebuild R ] dev-ruby/fxruby-1.0.29
[ebuild R ] media-libs/libao-0.8.5
[ebuild R ] media-libs/xine-lib-1_rc5-r3
[ebuild R ] media-video/avidemux-2.0.26
[ebuild R ] net-libs/loudmouth-0.16
Ahora ya puede eliminar -p (o --pretend) de los argumentos y volver a ejecutar
revdep-rebuild.
|
Si necesita reconstruir algunos paquetes, puede ejecutar revdep-rebuild sin el parámetro -p y los paquetes listados serán emergidos de nuevo.
glsa-check es principalmente una herramienta de verificación que le sigue la pista a los diversos GLSA's (Advertencia de Seguridad de Gentoo Linux, Gentoo Linux Security Advisory en inglés) y que acabará por integrarse en emerge y equery. Para más información, por favor visite la Página de integración Portage GLSA.
eread es una sencilla herramienta para visualizar ficheros elog creados por Portage a partir de la versión >=portage-2.1. Puede habilitar la grabación de ficheros elog definiendo un par de variables en /etc/make.conf:
Listado de Código 4.2: Habilitar elog en /etc/make.conf |
PORTAGE_ELOG_CLASSES="log" PORTAGE_ELOG_SYSTEM="save" |
Nota: Éste es sólo uno de los modos de grabar mensajes elog. Para obtener más información de cómo funciona el sistema elog de Portage, por favor consulte su correspondiente página en el Manual Gentoo. |
Una vez haya configurado elog del modo deseado, simplemente ejecute eread para ver sus ficheros de registro.
Listado de Código 4.3: Utilizar eread |
$ eread
This is a list of portage log items. Choose a number to view that file or type q to quit.
1) app-portage:gentoolkit-0.2.4_pre2:20070320-000256.log
2) app-portage:gentoolkit-0.2.4_pre2:20070320-000258.log
3) app-portage:gentoolkit-0.2.4_pre2:20070320-000319.log
4) app-portage:gentoolkit-0.2.3:20070320-000408.log
Choice?
|
Seleccione un número y el fichero se mostrará mediante el programa de paginación especificado en la variable de entorno PAGER. Si ésta no está definida, se utilizará less.
Una vez mostrado el elemento elog, se le preguntará si desea eliminar el fichero.