Gentoolkit
1.
Introducción
¿Qué es Gentoolkit?
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.
Instalación
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.
|
Encontrar documentación
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]/.
2.
equery
Introducción
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
|
Gráficos de dependencias
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)
|
Listar paquetes
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.
¿Dónde está el ebuild?
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
|
3.
euse
Introducción
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 |
# euse -E 3dfx
/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
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"
# euse -D 3dfx
/etc/make.conf was modified, a backup copy has been placed at /etc/make.conf.euse_backup
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.
|
4.
Otras herramientas
revdep-rebuild
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
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
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.
|
