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 :-)

4th Berkeley Distribution                           Mayo 1996                                     READPROFILE(1)