This is Gentoo's testing wiki. It is a non-operational environment and its textual content is outdated.

Please visit our production wiki at https://wiki.gentoo.org

Gentoolkit

From Gentoo Wiki (test)
Jump to:navigation Jump to:search
This page is a translated version of the page Gentoolkit and the translation is 100% complete.

Not to be confused with Genkernel.

Resources

Gentoolkit es un conjunto de herramientas que facilitan la administración de un sistema Gentoo. Este documento cubre las acciones básicas de algunas de las herramientas que ofrece Gentoolkit.

Introducción

¿Qué es Gentoolkit?

Gentoo es una distribución única y presenta algunas complejidades que simplemente no se presentan en otras distribuciones. A medida que los desarrolladores y colaboradores de Gentoo descubrían algunas de estas complejidades, escribieron herramientas para ayudar a usuarios y administradores a resolverlas. Muchas de estas herramientas se han escrito para el proyecto Gentoo y se incluyen en el paquete app-portage/gentoolkit.

Nota
Actualmente hay dos versiones de Gentoolkit: app-portage/gentoolkit and app-portage/gentoolkit-dev. La primera contiene guiones de administración, la segunda contiene guiones específicos para ayudar al desarrollo en Gentoo. Los desarrolladores de Gentoo pueden conseguir que sus guiones se incluyan en gentoolkit-dev contactando con el mantenedor de Gentoolkit. El resto de este documento trata el paquete app-portage/gentoolkit.
Nota
app-portage/gentoolkit-dev se ha incluido en app-portage/gentoolkit a partir de la versión 0.4.0.

Gentoolkit contiene un amplio conjunto de herramientas útiles para ayudar a administrar los paquetes y seguirle la pista a lo que ocurre en los sistemas. La mayoría de usuarios, particularmente aquellos que a menudo actualizan sus sistemas, se beneficiarán de la instalación de Gentoolkit.

Instalación

Emerge

Al igual que la mayoría de los paquetes de Gentoo, la instalación es tan simple como hacer emerge:

root #emerge --ask app-portage/gentoolkit
Nota
Muchas de las herramientas en Gentoolkit revelan información importante sobre el sistema en el que está instalado o requieren permisos de usuario root. Por esta razón, algunos de los programas solo se pueden lanzar (o funcionarán correctamente) si se lanzan con un usuario con privilegios de root.

Encontrar documentación

Cualquier documentación que un programa debe tener (aparte de las páginas del manual) se almacena en /usr/share/doc/gentoolkit-[versión]/[nombre-del -programa]/.

euse

euse es una herramienta para ver, activar y desactivar los ajustes USE en varios lugares. Para más información acerca de los ajustes USE, por favor consulte el documento sobre los ajustes USE. Lea la salida de euse -h para ver la ayuda completa y todas las opciones.

Ver, activar y desactivar ajustes USE

La orden euse -a lee los ajustes USE actuales que están activos y los muestra.

Nota
Hay cinco "columnas" que euse utiliza para mostrar si un ajuste está activo o inactivo y donde se ha activado cada uno de ellos. El significado del valor de las columnas es el siguiente: +/-, activado en el E ntorno, activado en make. C onf, activado en make. D efaults y activado en make. G lobals. La salida se parece a [+ECDG].
root #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, se puede utilizar la orden euse -a -g para ver ajustes USE globales activos. La orden euse -a -l hace lo mismo para los ajustes USE locales activados. Las subopciones -g y -l de euse requieren una opción anterior a ellas (como -a) para funcionar correctamente.

root #euse -a -l
 bitmap-fonts [+ D ]
 font-server [+ D ]
 fortran [+ D ]
 gimpprint [+ C ]
 md5sum [+ C ]
 mpeg4 [+ C ]
 nvidia [+ C ]
 offensive [+ ]
 truetype [+ CD ]

euse puede activar o desactivar ajustes USE. Las órdenes empleadas para ello son euse -E nombredeajuste (activa un ajuste) y euse -D nombredeajuste (desactiva un ajuste).

Advertencia
No utilice las órdenes euse -E ni euse -D por ellas mismas (sin un ajuste). Activarán o desactivarán TODOS los ajustes USE en /etc/portage/make.conf. Aunque se mantiene una copia de seguridad en /etc/portage/make.conf.euse_backup, por favor, ¡Tenga cuidado a la hora de usar euse -E o euse -D!

Activar un ajuste USE:

root #euse -E 3dfx
/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup

El fichero /etc/portage/make.conf tiene este aspecto después de ejecutar la orden:

ARCHIVO make.confDespués de activar el ajuste USE 3dfx
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"

Desactivar un ajuste USE:

root #euse -D 3dfx
/etc/portage/make.conf was modified, a backup copy has been placed at /etc/portage/make.conf.euse_backup

De nuevo, el fichero /etc/portage/make.conf después de la órden:

ARCHIVO Después de desactivar el ajustes USE 3dfx
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 elimina físicamente el ajuste incluído en /etc/portage/make.conf. Añade un - (menos) antes del ajuste para desactivarlo. Puede necesitarse una limpieza manual de /etc/portage/make.conf para evitar variables no deseadas. Otra forma es utilizar la opción -P (purge o eliminar) para eliminar el ajuste. Por ejemplo, euse -P 3dfx debería eliminar el ajuste 3dfx.

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 emerge de esos paquetes automáticamente pero puede ocurrir que un paquete determinado ya no funcione con las dependencias actuales instaladas, en cuyo caso, debe actualizar el paquete que no funciona a una versión más reciente. La herramienta revdep-rebuild le pasará ajustes a emerge que le permiten hacer uso de --pretend para ver de qué paquetes se va a hacer emerge de nuevo antes de proceder.

root #revdep-rebuild -p
 * Configuring search environment for revdep-rebuild
 * Checking reverse dependencies
 * Packages containing binaries and libraries broken by a package update
 * will be emerged.

 * Collecting system binaries and libraries
 * Generated new 1_files.rr
 * Collecting complete LD_LIBRARY_PATH
 * Generated new 2_ldpath.rr
 * Checking dynamic linking consistency [ 48% ]
 * broken /usr/lib/gstreamer-0.10/libgsttaglib.la (requires /usr/lib/libtag.la) [ 64% ]
 * broken /usr/lib/libgdkglext-x11-1.0.la (requires /usr/lib/libGLU.la) [ 67% ]
 * broken /usr/lib/libgtkglext-x11-1.0.la (requires /usr/lib/libGLU.la) [ 85% ]
 * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la (requires /usr/lib/libGLU.la)
 * broken /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la (requires /usr/lib/libGLU.la) [ 97% ]
 * broken /usr/qt/3/lib/libqt-mt.la (requires -lpng) [ 100% ]
 * Generated new 3_broken.rr
 * Assigning files to packages
 * /usr/lib/gstreamer-0.10/libgsttaglib.la -> media-plugins/gst-plugins-taglib
 * /usr/lib/libgdkglext-x11-1.0.la -> x11-libs/gtkglext
 * /usr/lib/libgtkglext-x11-1.0.la -> x11-libs/gtkglext
 * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gdkgl/_gdkgl.la -> dev-python/pygtkglext
 * /usr/lib/python2.6/site-packages/gtk-2.0/gtk/gtkgl/_gtkgl.la -> dev-python/pygtkglext
 * /usr/qt/3/lib/libqt-mt.la -> x11-libs/qt
 * Generated new 4_raw.rr and 4_owners.rr
 * Cleaning list of packages to rebuild
 * Generated new 4_pkgs.rr
 * Assigning packages to ebuilds
 * Generated new 4_ebuilds.rr
 * Evaluating package order
 * Generated new 5_order.rr
 * All prepared. Starting rebuild emerge --oneshot --pretend dev-python/pygtkglext:0 media-plugins/gst-plugins-taglib:0.10 x11-libs/gtkglext:0 x11-libs/qt:3


 These are the packages that would be merged, in order:


 Calculating dependencies... done!
 [ebuild R ] media-plugins/gst-plugins-taglib-0.10.17
 [ebuild R ] x11-libs/gtkglext-1.2.0
 [ebuild R ] x11-libs/qt-3.3.8b-r2
 [ebuild R ] dev-python/pygtkglext-1.1.0
 * Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild.

Para reconstruir algunos paquetes, lance revdep-rebuild sin la opción -p y se hará emerge de nuevo de los paquetes listados.

glsa-check

glsa-check es principalmente una herramienta de verificación que le sigue la pista a los diversos GLSAs (Advertencia de Seguridad de Gentoo Linux o Gentoo Linux Security Advisory) y que acabará por integrarse en emerge y equery.

eread

eread es una sencilla herramienta para visualizar ficheros elog creados por Portage a partir de la versión 2.1. Se puede habilitar la grabación de ficheros elog definiendo un par de variables en /etc/portage/make.conf:

ARCHIVO make.confHabilitar elog
PORTAGE_ELOG_CLASSES="log"
PORTAGE_ELOG_SYSTEM="save"
Nota
Este es solo uno de los modos de grabar mensajes elog. Para obtener más información sobre cómo funciona el sistema elog de Portage, por favor, consulte su correspondiente página en el Manual de Portage.

Una vez se ha configurado elog de la forma deseada, se debe lanzar eread para ver los ficheros de registro.

user $eread
This is a list of portage log items. Choose a number to view that file or type q to quit.

1&#41 app-portage:gentoolkit-0.2.4_pre2:20070320-000256.log
2&#41 app-portage:gentoolkit-0.2.4_pre2:20070320-000258.log
3&#41 app-portage:gentoolkit-0.2.4_pre2:20070320-000319.log
4&#41 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 esta variable no está definida, se utilizará less. La variable de entorno PAGER puede definirse utilizando eselect (módulo pager).

Una vez mostrado el elemento elog, se le preguntará si desea eliminar el fichero.

eclean

eclean es una herramienta para eliminar ficheros fuente y paquetes antiguos del sistema.

Cuando se construyen e instalan los paquetes, los ficheros fuente se descargan y conservan en DISTDIR, normalmente en el directorio /usr/portage/distfiles. Esto puede acumular varios gigabytes de material a lo largo del tiempo si no se limpia periodicamente. Los usuarios deberían lanzar eclean-dist para limpiar únicamente los ficheros fuente de DISTDIR.

Es posible crear archivos de los paquetes instalados mediante quickpg o FEATURES="buildpkg". Estos paquetes archivados se guardan en PKGDIR, normalmente en el directorio /usr/portage/packages. Cuando no se necesitan más, o son muy antiguos, se puede lanzar eclean-pkg̣ para eliminarlos de PKGDIR. Es una buena forma de asegurarse de que el sistema tiene las últimas versiones de los paquetes binarios.

Para más información sobre eclean y los consejos sobre el mantenimiento de un sistema libre de código obsoleto, por favor, lea man eclean o eche un vistazo al artículo sobre eclean.

Vea también


This page is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: Matt Butcher, John P. Davis, Erwin, Shyam Mani, Xavier Neys, Karl Trygve, José Luis Rivero, Joshua Saddler, Douglas Anderson
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.