READPROFILE(1)

NOMBRE
readprofile - una herramienta para leer la información del perfil (profile) del núcleo

SINOPSIS
readprofile [ options ]

VERSIÓN
Esta página de manual documenta la versión 2.0 del programa.

DESCRIPCIÓN

El comando readprofile usa la información de /proc/profile para imprimir datos ASCII por la salida estándar. La salida está organizada en tres columnas: la primera es el número de impulsos de reloj, la segunda es el nombre de la función C en el núcleo donde esos impulsos ocurrieron y el tercero es la `carga' normalizada del procedimiento, calculada como un ratio entre el número de impulsos de reloj y la duración del procedimiento. La salida es rellenada con espacios en blanco para mejorar la lectura.

Las opciones de línea de comandos disponibles son los siguientes:

-m mapfile
    Especifica un fichero de mapa, el defecto es /usr/src/linux/System.map. Puede especificar el fichero de mapa en la línea de comandos si su núcleo actual no es el último que compiló. Si el nombre del fichero de mapa termina con `.gz' es descomprimido transparentemente.

-p pro-file
    Especifica un búffer de perfil diferente, por defecto es /proc/profile. Es útil especificar un nuevo búffer si desea tener una `instantánea' del perfil del núcleo en un instante determinado y desea leerla más tarde. El fichero /proc/profile puede ser copiado usando `cat' o `cp'. No existe soporte para buffers de perfil comprimidos, como en readprofile-1.1, porque el programa necesita saber de antemano el tamaño del buffer.

-i  Información. Esto hace que readprofile sólo imprima el paso de perfil usado por el núcleo. El `paso de perfil' es la resolución del buffer de perfil y es seleccionado durante la configuración del núcleo (a través de `make config'), o en la línea de comandos del núcleo. Si la opción -t (conciso) es usada junto con -i sólo se imprime el número decimal.

-a  Imprime todos los símbolos del fichero de mapa. Por defecto los procedimientos con 0 impulsos de reloj no son impresos.

-r  Reiniciar el buffer de perfil. Esto sólo puede ser invocado por el usuario root, porque /proc/profile puede ser leído por cualquiera pero sólo puede ser modificado por el superusuario. De todas maneras, puede hacer readprofile setuid 0, para poder reiniciar el buffer sin necesidad de los privilegios.

-v  Prolijo. La salida es organizada en cuatro columnas y rellenada con blancos. La primera columna es la dirección RAM de la función del núcleo, la segunda es el nombre de la función, la tercera es el número de impulsos de reloj y la última es la carga normalizada.

-V  Versión. Esto hace que readprofile imprima su número de versión y termine.

EJEMPLOS
Ver el buffer de perfil ordenándolo por impulsos de reloj:
   readprofile | sort -nr | less
Imprimir los 20 procedimientos más cargados:
   readprofile | sort -nr +2 | head -20
Imprimir sólo el perfil del sistema de ficheros:
   readprofile | grep _ext2
Mirar toda la información del núcleo, con las direcciones de RAM:
   readprofile -av | less
Ver una `instantánea' del buffer de perfil para un núcleo que no es el actual:
   readprofile -p ~/profile.instantanea -m /zImage.map.gz

FALLOS

readprofile sólo funciona con núcleos 1.3.x o superiores, porque /proc/profile cambió en el paso entre el 1.2 y el 1.3

Este programa sólo funciona con núcleos ELF. El cambio para núcleos a.out es trivial y se deja como ejercicio para el usuario de a.out.

Para habilitar el perfil, el núcleo debe ser reiniciado, porque no existe un módulo para el perfil y no sería fácil de implementar. Para habilitar el perfil, debe especificar "profile=2" (u otro número) en la línea de comandos del núcleo. El número que especifique es el exponente de dos usado como paso de perfil.

El perfil se encuentra deshabilitado cuando las interrupciones son deshabilitadas. Esto significa que muchos de los impulsos de reloj ocurren cuando las interrupciones se habilitan de nuevo. Guarde atención con la información que puede inducirle a error.

FICHEROS
/proc/profile              Una imagen binaria del buffer de perfil.
/usr/src/linux/System.map  El mapa de símbolos del núcleo.
/usr/src/linux/*           El programa que se está perfilando :-)