sprof

NOM

sprof - Lire et afficher les données de profilage des objets partagés

SYNOPSIS

sprof [option]... chemin_objet_partagé [chemin_données_profil]

La commande sprof affiche un résumé de profilage de l'objet (la bibliothèque) partagé indiqué comme premier paramètre de la ligne de commande. Le résumé du profilage est créé à partir de données de profilage précédemment générées dans le second paramètre (optionnel) de la ligne de commande. Si le chemin vers les données de profilage est absent, sprof tentera de le déduire à partir du soname de l'objet partagé, en recherchant dans le répertoire actuel un fichier avec le nom <soname>.profile.

OPTIONS

Les options suivantes de la ligne de commande indiquent la sortie de profilage à produire :

-c, --call-pairs: Afficher une liste des paires de chemins d'appel pour les interfaces exportées par l'objet partagé, ainsi que le nombre de fois que chaque chemin est utilisé.

-p, --flat-profile: Générer un fichier de profilage plat de toutes les fonctions de l'objet examiné, avec le nombre d'appels et de tics.

-q, --graph: Générer un graphe d'appels.

Si aucune des options ci-dessus n'est spécifiée, le comportement par défaut consiste à afficher un profilage plat et un graphe des appels.

Les options supplémentaires suivantes sont disponibles en ligne de commande :

-?, --help: Afficher un résumé des options et paramètres de la ligne de commande, puis terminer.

--usage: Afficher un court message d'aide et terminer.

-V, --version: Afficher la version du programme et terminer.

STANDARDS

La commande sprof est une extension GNU non présente dans POSIX.1.

EXEMPLES

L'exemple suivant illustre l'utilisation de sprof. Il consiste dans un programme principal qui appelle deux fonctions d'un objet partagé. D'abord, le code du programme principal :

$  cat prog.c
#include <stdlib.h>

void x1(void);
void x2(void);

int
main(int argc, char *argv[])
{
    x1();
    x2();
    exit(EXIT_SUCCESS);
}

Les fonctions x1() et x2() sont définies dans le fichier source suivant, utilisé pour construire l'objet partagé :

$  cat libdemo.c
#include <unistd.h>

void
consumeCpu1(int lim)
{
    for (unsigned int j = 0; j < lim; j++)
getppid();
}

void
x1(void) {
    for (unsigned int j = 0; j < 100; j++)
consumeCpu1(200000);
}

void
consumeCpu2(int lim)
{
    for (unsigned int j = 0; j < lim; j++)
getppid();
}

void
x2(void)
{
    for (unsigned int j = 0; j < 1000; j++)
consumeCpu2(10000);
}

Maintenant, nous construisons l'objet partagé avec le nom réel libdemo.so.1.0.1 et le soname libdemo.so.1 :

$  cc -g -fPIC -shared -Wl,-soname,libdemo.so.1 \
         -o libdemo.so.1.0.1 libdemo.c

Puis, nous construisons les liens symboliques pour le soname de la bibliothèque et le nom de l'éditeur de liens de la bibliothèque :

$  ln -sf libdemo.so.1.0.1 libdemo.so.1
$  ln -sf libdemo.so.1 libdemo.so

Ensuite, nous compilons le programme principal en le liant à l'objet partagé, puis nous affichons les dépendances dynamiques du programme :

$  cc -g -o prog prog.c -L. -ldemo
$  ldd prog
	linux-vdso.so.1 =>  (0x00007fff86d66000)
	libdemo.so.1 => not found
	libc.so.6 => /lib64/libc.so.6 (0x00007fd4dc138000)
	/lib64/ld-linux-x86-64.so.2 (0x00007fd4dc51f000)

Afin d'avoir les informations de profilage de l'objet partagé, nous positionnons la variable d'environnement LD_PROFILE sur le soname de la bibliothèque :

$  export LD_PROFILE=libdemo.so.1

Puis, nous définissons la variable d'environnement LD_PROFILE_OUTPUT avec le chemin du répertoire où devrait être écrite la sortie de profilage et nous créons ce répertoire s'il n'existe pas encore :

$  export LD_PROFILE_OUTPUT=$(pwd)/prof_data
$  mkdir -p $LD_PROFILE_OUTPUT

LD_PROFILE a pour conséquence que la sortie de profilage s'ajoute au fichier de sortie s'il existe, aussi nous nous assurons qu'il n'y a pas de données de profilage préexistantes :

$  rm -f $LD_PROFILE_OUTPUT/$LD_PROFILE.profile

Puis, nous lançons le programme pour produire la sortie de profilage, écrite dans un fichier du répertoire indiqué dans LD_PROFILE_OUTPUT :

$  LD_LIBRARY_PATH=. ./prog
$  ls prof_data
libdemo.so.1.profile

Nous utilisons alors l'option sprof -p pour générer un fichier de profilage plat avec le nombre d'appels et de tics :

$  sprof -p libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile
Profil plat :

Chaque échantillon est compté toutes les 0.01 secondes.
  %   cumulative   self              self     total
 time   seconds   seconds    calls  us/call  us/call  name
 60.00      0.06     0.06      100   600.00           consumeCpu1
 40.00      0.10     0.04     1000    40.00           consumeCpu2
  0.00      0.10     0.00        1     0.00           x1
  0.00      0.10     0.00        1     0.00           x2

L'option sprof -q génère un graphe d'appel :

$  sprof -q libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile

index % time    self  children    called     name

                0.00    0.00      100/100         x1 [1]
[0]    100.0    0.00    0.00      100         consumeCpu1 [0]
-----------------------------------------------
                0.00    0.00        1/1           <UNKNOWN>
[1]      0.0    0.00    0.00        1         x1 [1]
                0.00    0.00      100/100         consumeCpu1 [0]
-----------------------------------------------
                0.00    0.00     1000/1000        x2 [3]
[2]      0.0    0.00    0.00     1000         consumeCpu2 [2]
-----------------------------------------------
                0.00    0.00        1/1           <UNKNOWN>
[3]      0.0    0.00    0.00        1         x2 [3]
                0.00    0.00     1000/1000        consumeCpu2 [2]
-----------------------------------------------

Ci-dessus et ci-dessous, les chaînes "<UNKNOWN>" représentent les identifiants à l'extérieur du fichier de l'objet examiné (dans cet exemple, il s'agit des instances de main()).

L'option sprof -c génère une liste d’une paire d’appels et du nombre de leurs occurrences :

$  sprof -c libdemo.so.1 $LD_PROFILE_OUTPUT/libdemo.so.1.profile
<UNKNOWN>                  x1                                 1
x1                         consumeCpu1                      100
<UNKNOWN>                  x2                                 1
x2                         consumeCpu2                     1000

VOIR AUSSI

gprof(1), ldd(1), ld.so(8)

TRADUCTION

La traduction française de cette page de manuel a été créée par Gérard Delafond <[email protected]>, Alain Portal <[email protected]>, Christophe Blaess <https://www.blaess.fr/christophe/>, David Prévot <[email protected]>, Denis Barbier <[email protected]>, Florentin Duneau <[email protected]>, François Micaux, Jean-Luc Coulon (f5ibh) <[email protected]>, Jean-Philippe Guérard <[email protected]>, Julien Cristau <[email protected]>, Nicolas François <[email protected]>, Simon Paillard <[email protected]>, Stéphan Rafin <[email protected]>, Thierry Vignaud <[email protected]>, Thomas Blein <[email protected]>, Thomas Huriaux <[email protected]> et Jean-Philippe MENGUAL <[email protected]>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à [email protected]

7 janvier 2023

Pages du manuel de Linux 6.03