]>

# Manuel de KTimemon

Martin Maierhofer

    m.maierhofer@tees.ac.uk

Dernière mise à jour le 16 avril 1999

Aide en ligne et introduction à KTimemon version 0.3a.

Visualisation graphique des ressources du système

KTimemon
CPU
ressources du système

## Introduction

KTimemon est un petit programme permettant de surveiller l'utilisation des ressources de votre ordinateur. Il peut afficher sous forme de graphiques en barres des informations sur le CPU, la mémoire et l'utilisation de la partition d'échange, ou encore l'encombrement des disques et l'activité de changement de contexte.

Respectant la philosophie de KDE, il est configurable par une interface graphique et peut afficher ses informations sur le tableau de bord et non dans une fenêtre.

Note : Actuellement, KTimemon ne fonctionne que sur un nombre limité de plateformes : Linux avec support du système de fichiers `/proc`, Solaris avec la bibliothèque kstat, et Digital Unix (anciennement DEC/OSF1) supportant l'appel système table(2). Toute aide pour le porter sur d'autres plateformes est la bienvenue.

KTimemon peut être démarré depuis la ligne de commande, ou bien par le biais du lanceur d'applications (sous-menu Utilitaires). Dans le premier cas, KTimemon reconnaît les arguments habituels de X-Window, comme `-geometry`. KTimemon supporte la gestion de session, i.e. il mémorise sa configuration courante (couleurs, etc) et la restaure à la session suivante.

## Installation

Vous pouvez trouver KTimemon sur le serveur FTP de KDE (et ses sites miroirs). Téléchargez-le dans le répertoire de votre choix et tapez les commandes suivantes :

    $ cd <le_répertoire_où_vous_avez_mis_ktimemon-0.3a.tgz>
    $ gzip -cd ktimemon-0.3a.tgz | tar xfv -
    $ cd ktimemon-0.3a
    $ ./configure
    $ make install

Normalement, KTimemon devrait se compiler et s'installer sans intervention supplémentaire de votre part (sinon, envoyez-moi un courrier à l'adresse m.maierhofer@tees.ac.uk). Il devrait en outre se placer dans l'arborescence des répertoires KDE, et vous devriez pouvoir le lancer depuis le sous-menu Utilitaires après avoir redémarré le tableau de bord.

## Techniques de base à l'écran

Une fois KTimemon lancé, une petite fenêtre apparaît avec des informations sur votre système d'exploitation. Si vous amenez la souris sur la fenêtre de KTimemon et la laissez immobile quelques instants, une bulle d'aide (i.e. une petite fenêtre flottante) apparaîtra. Elle contient des informations numériques sur les paramètres système affichés par les graphes. Les bulles d'aide peuvent être désactivées (reportez-vous au chapitre Configuration).

### Modes d'affichage

KTimemon peut afficher deux catégories différentes d'informations système. Comme il est expliqué dans le chapitre Configuration, les boutons de la souris peuvent être associés à diverses actions. Par défaut, le bouton gauche change de mode, i.e. si vous cliquez n'importe où dans la fenêtre de KTimemon, les informations affichées passent du "mode normal" (par défaut) au "mode étendu" et vice-versa.

#### Mode normal

Lors de son premier démarrage, KTimemon affiche des informations sur l'activité CPU, l'utilisation de la mémoire et de la partition d'échange avec trois graphiques en barres ; ils sont mis à jour à intervalles réguliers (toutes les 0,5 secondes par défaut, mais vous pourrez le changer). Les trois graphiques représentent (de gauche à droite) :

Charge CPU.

  KTimemon utilise trois couleurs pour cette barre, symbolisant le temps passé dans différents modes. De bas en haut : mode noyau, mode utilisateur, et mode utilisateur basse priorité (nice) - comme Solaris ne semble pas supporter les statistiques pour le mode basse priorité, la partie supérieure de la barre représente le temps passé dans l'état d'attente (wait) sur de tels systèmes. La zone vide entre le haut de la barre supérieure et l'extrémité de la fenêtre représente le pourcentage de son temps où le CPU est oisif.

Utilisation de la mémoire.

  De même que pour la charge CPU, cette barre est divisée en trois champs représentant (de bas en haut) : la mémoire allouée aux processus, celle utilisée pour le tampon d'entrée / sortie, et celle utilisée pour le tampon fichier. Sur les systèmes Digital Unix, la partie centrale représente la mémore "inactive" (i.e. allouée et pas utilisée depuis un certain temps). Sur les systèmes Solaris elle n'est pas utilisée et la partie supérieure représente la quantité de mémoire utilisée par le noyau. Là encore, la zone vide entre le haut de la barre supérieure et l'extrémité de la fenêtre représente la mémoire libre.

Utilisation de la partition d'échange.

  Cette barre contient un seul champ représentant la partition d'échange utilisée, le reste de la barre étant celle non utilisée.

En cliquant dans la fenêtre de KTimemon avec le bouton de la souris assigné au changement de mode, on passe en "Mode étendu".

#### Mode étendu

Dans ce mode, les trois graphiques en barres affichent d'autres informations. De droite à gauche :

Activité de pagination.

  Cette barre comporte deux parties. La partie inférieure montre le nombre de pages mémoire écrites dans le support de stockage secondaire au cours du dernier intervalle d'échantillonnage. De même, la partie supérieure indique le nombre de pages lues depuis le support de stockage secondaire.

Activité de la partition d'échange.

  La deuxième barre affiche des informations analogues mais pour l'activité de la partition d'échange.

Changements de contexte.

  Là encore, ce graphique comporte un seul champ avec le nombre de changements de contexte au cours du dernier intervalle d'échantillonnage.

Comme il n'y a pas de méthode "naturelle" pour définir l'échelle des graphiques affichés dans le "mode étendu", KTimemon règle par défaut automatiquement les échelles (voir Questions et réponses). Il est toutefois possible de spécifier des échelles (voir le chapitre Configuration).

Remarquez que les deux ensembles de graphiques en barres utilisent les mêmes couleurs, i.e. les couleurs choisies pour le "mode normal" sont aussi utilisées pour le "mode étendu" (voir aussi Configuration pour la façon de changer ces couleurs).

### Structure du menu

Par défaut, le bouton droit de la souris est lié au menu contextuel, i.e. en cliquant sur le bouton droit n'importe où dans la fenêtre de KTimemon on fait apparaître un menu (décrit ci-dessous).

#### Aide

Le menu Aide est assez conventionnel. Vous devriez déjà être familier avec ses fonctionnalités.

#### Configuration...

Le menu Configuration... est utilisé pour faire apparaître la boîte de dialogue de configuration. Les options de configuration sont décrites dans le chapitre Configuration.

#### Intégration au tableau de bord

En sélectionnant Intégrer au tableau de bord dans le menu, KTimemon bascule de l'affichage standard (i.e. en fenêtre) à l'affichage dans le tableau de bord, et vice-versa. Mise à part sa moindre taille, la version intégrée dans le tableau de bord se comporte exactement comme sa grande soeur.

#### Barres horizontales

En sélectionnant Barres horizontales dans le menu, KTimemon bascule d'un affichage avec des barres verticales à un autre avec des barres horizontales, et vice-versa. Pas très utile, mais c'était facile à implémenter ;-)

#### Quitter

L'entrée Quitter du menu permet - surprise, surprise - de quitter KTimemon. La configuration courante (couleurs, taille de la fenêtre, intégration ou non dans le tableau de bord) est enregistrée pour être restaurée au prochain lancement.

Ces informations de configuration sont enregistrées dans le fichier `$(HOME)/.kde/share/config/ktimemonrc`, où `$(HOME)` représente le répertoire personnel de l'utilisateur. Si ce fichier est effacé, KTimemon démarrera au prochain lancement avec une configuration par défaut.

## Configuration

KTimemon peut être configuré par une boîte de dialogue simple (voir la description du menu Configuration).

Dans l'onglet Général, il est possible de régler l'intervalle de temps entre deux échantillonnages, les échelles des graphiques (voir la description du mode étendu). Si la case Echelle automatique est cochée (ceci est décrit dans la section Questions et réponses), les facteurs d'échelle ne peuvent être modifiés, puisqu'ils sont déterminés automatiquement par KTimemon.

L'onglet Couleurs permet de choisir les couleurs des graphiques en barres à sa convenance. Un petit exemple permet de voir les changements au fur et à mesure.

L'onglet Interaction permet de paramétrer la souris. Un clic de souris sur la fenêtre de KTimemon peut être ignoré, provoquer un changement de mode (voir Modes d'affichage), faire apparaître un menu contextuel (voir aussi Structure du menu), ou encore appeler un processus externe. La ligne de commande pour les processus externes sera interprétée de façon standard par le shell (commandes shell, variables d'environnement, redirections, etc).

L'onglet Interaction comporte aussi une case à cocher permettant de désactiver les bulles d'aide avec les informations numériques sur les graphiques en barres (voir Techniques de base à l'écran).

## Questions et réponses

Quels systèmes d'exploitation sont supportés par KTimemon ?

  KTimemon fonctionne sous Linux avec support du système de fichiers `/proc`, Solaris avec la bibliothèque kstat, et Digital Unix (anciennement DEC/OSF1) avec l'appel système table(2). Seule la version Linux a été testée exhaustivement. Si vous rencontrez des problèmes avec les versions Solaris ou Digital Unix, n'hésitez pas à me contacter.

  De plus, ceux qui souhaitent contribuer au portage de KTimemon sur d'autres plateformes sont les bienvenus ! Contactez-moi à m.maierhofer@tees.ac.uk si vous êtes volontaire pour porter KTimemon sous d'autres Unix.

Comment fonctionne le changement d'échelle automatique ?

  Merci d'avoir posé la question. Comme il n'y a pas de facteurs d'échelle prédéterminés raisonnables pour les opérations de pagination / swapping et de changement de contexte (alors que pour l'utilisation de la mémoire, par exemple, il est possible de prendre la mémoire totale comme base), KTimemon utilise un mécanisme de détermination de l'échelle semi-intelligent (enfin presque). Il fonctionne comme suit :

  - Chacun des trois graphiques en barres décrit dans la section Mode étendu a un facteur d'échelle associé. Les valeurs initiales sont prédéterminées.

  - Chaque fois qu'un nouvel échantillonnage est affiché, les valeurs affichées par les graphiques sont multipliées par le même facteur. Si un graphique peut être affiché avec cette échelle, aucun changement supplémentaire n'est fait (i.e. de petites variations d'activité entraînent un changement de la hauteur de la barre).

  - Si la valeur affichée est toujours trop grande ou trop petite pour tenir dans le graphique avec ce facteur d'échelle, ce dernier est ajusté de façon à ce que la valeur affichée soit à peu près au milieu du graphique en barres. Ainsi, des changements ultérieurs devraient pouvoir être affichés avec cette nouvelle échelle sans la modifier.

Pourquoi un message "Diagnostic : sortie de la commande fille" apparaît-il ?

  Si vous associez un bouton de la souris à une commande externe (voir le chapitre Configuration), KTimemon ne vérifie pas le nom de la commande. A la place, un shell est lancé pour exécuter cette commande, donc les commandes shell, les variables d'envirionnement, etc, peuvent être utilisées. Afin de permettre à l'utilisateur de voir le résultat de sa commande, KTimemon surveille la sortie d'erreur standard (stderr) de la commande shell, et la copie dans une fenêtre message.

  Bien qu'utile en cas de commande inconnue, cela peut devenir assez énervant si la commande en question affiche des informations normales dans sa sortie standard. Une solution simple et élégante à ce problème est d'ajouter `2>/dev/null` à la fin de la commande. Cela redirige les messages de la sortie standard vers le Nirvana et empêche les fenêtres messages de vous embêter.

## Historique des changements

Version 0.1.

  (29 juillet 1998) Sortie initiale.

Version 0.2.

  (20 août 1998)

  - Ajout du support pour le mode étendu.

  - Modification de la boîte de dialogue afin d'utiliser une géométrie paramétrable plutôt que fixe.

  - Changement de quelques détails dans la boîte de dialogue de configuration (par exemple la localisation du point de montage de `/proc` est détectée automatiquement).

  - Ajout du support pour l'internationalisation.

Version 0.2a.

  (29 août 1998)

  - Correction d'un petit bug dans l'auto-détection du système de fichiers `/proc` depuis `/etc/mtab`.

Version 0.2b.

  (3 décembre 1998)

  - Correction de petits problèmes de compatibilité avec l'allocation des couleurs par défaut (quelqu'un aurait-il changé Qcolor "récemment" ?).

Version 0.3.

  (11 février 1999)

  - Correction d'un bug dans la configuration grâce à Cristian Tibirna. Vous devriez effacer le fichier `ktimemonrc` du répertoire `$(HOME)/.kde/share/config` pour démarrer avec une configuration "propre".

  - La boîte de dialogue de configuration est désormais allouée sur demande. Ceci réduit quelque peu l'empreinte de KTimemon en mémoire.

  - Portage initial sous Digital Unix (DEC/OSF1) et Solaris.

  - Barres horizontales et verticales configurables.

  - L'affichage de l'utilisation de la mémoire a été légèrement réarrangé.

  - Associations configurables des boutons de la souris à des actions.

  - Premiers essais pour le support SMP. Ne comptez pas trop dessus...

Version 0.3a.

  (16 avril 1999)

  - Ajout de bulles d'aide pour le widget timemon (d'après une suggestion de Mark Krischer).

  - Ajout de chaînes d'internationalisation manquantes dans le panneau de configuration et coup de balai dans les traductions (merci à Lubos Lunak).

  - Nettoyage mineur du code dans la classe sample.

## Remerciements

KTimemon est basé sur une version Xt écrite par mon frère.

Remerciements à : Tobe Toben, Cristian Tibirna, Dirk A. Mueller, Mark Krischer et Lubos Lunak pour les rapports de bugs, correctifs, commentaires et suggestions.