<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY ktimemon "<application>ktimemon</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="fr">
<bookinfo>
<title>Manuel de KTimemon</title>
<authorgroup>
<author>
<surname>Martin Maierhofer </surname>
<affiliation>
<address><email><ulink url="mailto:m.maierhofer@tees.ac.uk">m.maierhofer@tees.ac.uk</ulink></email></address>
</affiliation>
</author>
</authorgroup>
<date> Dernière mise à jour le 16 avril 1999</date>
<releaseinfo><!-- information about this particular version --></releaseinfo>
<abstract>
<para>Aide en ligne et introduction à KTimemon version 0.3a.</para>
<para>Visualisation graphique des ressources du système</para><!-- Merge this with the previous paragraph; it comes from <META NAME="description" CONTENT="..."> --></abstract>
<keywordset>
<keyword>KTimemon</keyword>
<keyword>CPU</keyword>
<keyword>ressources du système</keyword>
</keywordset>
</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>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.</para>

<para>Respectant la philosophie de <ulink url="http://www.kde.org/">KDE</ulink>,
il est configurable par une interface graphique et peut
afficher ses informations sur le tableau de bord et non dans une fenêtre.</para>

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

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

<chapter id="installation">
<title>Installation</title>

<para>Vous pouvez trouver KTimemon sur le <ulink url="ftp://ftp.kde.org/pub/kde/unstable/apps/utils/ktimemon-0.3a.tgz">serveur FTP de KDE</ulink> (et ses sites miroirs). Téléchargez-le
dans le répertoire de votre choix et tapez les commandes suivantes :</para>

<para><screen>$ cd &lt;le_répertoire_où_vous_avez_mis_ktimemon-0.3a.tgz&gt;
$ gzip -cd ktimemon-0.3a.tgz | tar xfv -
$ cd ktimemon-0.3a
$ ./configure
$ make install
</screen>
</para>

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

<chapter id="fund">
<title>Techniques de base à l'écran</title>

<para>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 <emphasis>bulle d'aide</emphasis> (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 <link linkend="config">Configuration</link>).</para>

<sect1 id="modes">
<title>Modes d'affichage </title>

<para>KTimemon peut afficher deux catégories différentes d'informations
système. Comme il est expliqué dans le chapitre
<link linkend="config">Configuration</link>, 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.</para>

<sect2 id="mode-normal">
<title>Mode normal</title>

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

<para><variablelist>
<varlistentry>
<term>Charge CPU.</term>
<listitem>
<para>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é
(<emphasis>nice</emphasis>) - 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
(<emphasis>wait</emphasis>) 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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Utilisation de la mémoire.</term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Utilisation de la partition d'échange.</term>
<listitem>
<para>Cette barre contient un seul champ
représentant la partition d'échange utilisée, le reste de la barre étant celle
non utilisée.</para>
</listitem>
</varlistentry>
</variablelist>
</para>

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

<sect2 id="xtndmode">
<title>Mode étendu </title>

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

<para><variablelist>
<varlistentry>
<term>Activité de pagination.</term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Activité de la partition d'échange.</term>
<listitem>
<para>La deuxième barre affiche des
informations analogues mais pour l'activité de la partition d'échange.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Changements de contexte.</term>
<listitem>
<para>Là encore, ce graphique comporte un seul
champ avec le nombre de changements de contexte au cours du dernier
intervalle d'échantillonnage.</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>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 <link linkend="autoscaling">Questions et réponses</link>).
Il est toutefois possible de spécifier des échelles (voir le chapitre
<link linkend="config">Configuration</link>).</para>

<para>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
<link linkend="config">Configuration</link> pour la façon de changer ces
couleurs).</para>
</sect2>
</sect1>

<sect1 id="menu">
<title>Structure du menu </title>

<para>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).</para>

<sect2 id="aide">
<title>Aide</title>

<para>Le menu <emphasis>Aide</emphasis> est assez conventionnel. Vous devriez déjà être
familier avec ses fonctionnalités.</para>
</sect2>

<sect2 id="configmenu">
<title>Configuration...</title>

<para>Le menu <emphasis>Configuration...</emphasis> est utilisé pour faire apparaître la
boîte de dialogue de configuration. Les options de configuration
sont décrites dans le chapitre <link linkend="config">Configuration</link>.</para>
</sect2>

<sect2 id="integration-au-tableau-de-bord">
<title>Intégration au tableau de bord</title>

<para>En sélectionnant <emphasis>Intégrer au tableau de bord</emphasis> 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.</para>
</sect2>

<sect2 id="barres-horizontales">
<title>Barres horizontales</title>

<para>En sélectionnant <emphasis>Barres horizontales</emphasis> 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 ;-)</para>
</sect2>

<sect2 id="quitter">
<title>Quitter</title>

<para>L'entrée <emphasis>Quitter</emphasis> 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.</para>

<para>Ces informations de configuration sont enregistrées dans le fichier
<literal remap="tt">$(HOME)/.kde/share/config/ktimemonrc</literal>, où <literal remap="tt">$(HOME)</literal>
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.</para>
</sect2>
</sect1>
</chapter>

<chapter id="config">
<title>Configuration</title>

<para>KTimemon peut être configuré par une boîte de dialogue simple (voir
la description du <link linkend="configmenu">menu Configuration</link>).</para>

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

<para>L'onglet <emphasis remap="bf">Couleurs</emphasis> permet de choisir les couleurs des graphiques en
barres à sa convenance. Un petit exemple permet de voir les changements
au fur et à mesure.</para>

<para>L'onglet <emphasis remap="bf">Interaction</emphasis> 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 <link linkend="modes">Modes d'affichage</link>), faire
apparaître un menu contextuel (voir aussi <link linkend="menu">Structure du menu</link>),
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).</para>

<para>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 <link linkend="fund">Techniques de base à l'écran</link>).</para>
</chapter>

<chapter id="autoscaling">
<title>Questions et réponses </title>

<para><variablelist>
<varlistentry>
<term>Quels systèmes d'exploitation sont supportés par KTimemon ?</term>
<listitem>
<para>KTimemon fonctionne sous Linux avec support du système de fichiers
<literal remap="tt">/proc</literal>, Solaris avec la bibliothèque <emphasis>kstat</emphasis>, et
Digital Unix (anciennement DEC/OSF1) avec l'appel système
<emphasis>table(2)</emphasis>. 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.</para>
<para>De plus, ceux qui souhaitent contribuer au portage de KTimemon sur
d'autres plateformes sont les bienvenus ! Contactez-moi à
<ulink url="mailto:m.maierhofer@tees.ac.uk">m.maierhofer@tees.ac.uk</ulink>
si vous êtes volontaire pour porter KTimemon sous d'autres Unix.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Comment fonctionne le changement d'échelle automatique ?</term>
<listitem>
<para>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 :
<itemizedlist>
<listitem>
<para> Chacun des trois graphiques en barres décrit dans la
<link linkend="xtndmode">section Mode étendu</link> a un facteur
d'échelle associé. Les valeurs initiales sont prédéterminées.</para>
</listitem>
<listitem>
<para> 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).</para>
</listitem>
<listitem>
<para> 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.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Pourquoi un message "Diagnostic : sortie de la commande fille"
apparaît-il ?</term>
<listitem>
<para>Si vous associez un bouton de la souris à une commande
externe (voir le chapitre <link linkend="config">Configuration</link>),
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 <emphasis>sortie d'erreur standard</emphasis> (stderr) de la commande shell, et la
copie dans une fenêtre message.</para>
<para>Bien qu'utile en cas de commande inconnue, cela peut devenir assez
énervant si la commande en question affiche des informations normales
dans sa <emphasis>sortie standard</emphasis>. Une solution simple et élégante à ce problème
est d'ajouter <literal remap="tt">2&gt;/dev/null</literal> à la fin de la commande. Cela
redirige les messages de la <emphasis>sortie standard</emphasis> vers le Nirvana et
empêche les fenêtres messages de vous embêter.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</chapter>

<chapter id="historique-des-changements">
<title>Historique des changements</title>

<para><variablelist>
<varlistentry>
<term>Version 0.1.</term>
<listitem>
<para>(29 juillet 1998) Sortie initiale.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Version 0.2.</term>
<listitem>
<para>(20 août 1998)
<itemizedlist>
<listitem>
<para>Ajout du support pour le <link linkend="xtndmode">mode étendu</link>.</para>
</listitem>
<listitem>
<para>Modification de la boîte de dialogue afin d'utiliser une géométrie
paramétrable plutôt que fixe.</para>
</listitem>
<listitem>
<para>Changement de quelques détails dans la boîte de dialogue de
configuration (par exemple la localisation du point de montage
de <literal remap="tt">/proc</literal> est détectée automatiquement).</para>
</listitem>
<listitem>
<para>Ajout du support pour l'internationalisation.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Version 0.2a.</term>
<listitem>
<para>(29 août 1998)
<itemizedlist>
<listitem>
<para>Correction d'un petit bug dans l'auto-détection du système de fichiers
<literal remap="tt">/proc</literal> depuis <literal remap="tt">/etc/mtab</literal>.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Version 0.2b.</term>
<listitem>
<para>(3 décembre 1998)
<itemizedlist>
<listitem>
<para>Correction de petits problèmes de compatibilité avec l'allocation des
couleurs par défaut (quelqu'un aurait-il changé Qcolor "récemment" ?).</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Version 0.3.</term>
<listitem>
<para>(11 février 1999)
<itemizedlist>
<listitem>
<para>Correction d'un bug dans la configuration grâce à Cristian Tibirna.
Vous devriez effacer le fichier <literal remap="tt">ktimemonrc</literal> du répertoire
<literal remap="tt">$(HOME)/.kde/share/config</literal> pour démarrer avec une configuration
"propre".</para>
</listitem>
<listitem>
<para>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.</para>
</listitem>
<listitem>
<para>Portage initial sous Digital Unix (DEC/OSF1) et Solaris.</para>
</listitem>
<listitem>
<para>Barres horizontales et verticales configurables.</para>
</listitem>
<listitem>
<para>L'affichage de l'utilisation de la mémoire a été légèrement réarrangé.</para>
</listitem>
<listitem>
<para>Associations configurables des boutons de la souris à des actions.</para>
</listitem>
<listitem>
<para>Premiers essais pour le support SMP. Ne comptez pas trop dessus...</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Version 0.3a.</term>
<listitem>
<para>(16 avril 1999)
<itemizedlist>
<listitem>
<para>Ajout de bulles d'aide pour le widget timemon (d'après une suggestion
de Mark Krischer).</para>
</listitem>
<listitem>
<para>Ajout de chaînes d'internationalisation manquantes dans le panneau
de configuration et coup de balai dans les traductions (merci à
Lubos Lunak).</para>
</listitem>
<listitem>
<para>Nettoyage mineur du code dans la classe sample.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</chapter>

<chapter id="remerciements">
<title>Remerciements</title>

<para>KTimemon est basé sur une version Xt écrite par mon frère.</para>

<para>Remerciements à :
<ulink url="mailto:ttoben@artis.uni-oldenburg.de">Tobe Toben</ulink>,
<ulink url="mailto:ctibirna@gch.ulaval.ca">Cristian Tibirna</ulink>, 
<ulink url="mailto:dmuell@rhrk.uni-kl.de">Dirk A. Mueller</ulink>,
<ulink url="mailto:krischem@amp.com">Mark Krischer</ulink>
et <ulink url="mailto:l.lunak@sh.cvut.cz">Lubos Lunak</ulink>
pour les rapports de bugs, correctifs, commentaires et suggestions.</para>
</chapter>
<![ %addindex; [ &docindex; ]]>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
sgml-general-insert-case: lower
End:
-->
