<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY ktimemon "<application>ktimemon</application>">
]>
<book lang="de">

<bookinfo>

<title>Das KTimemon Handbuch</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>02/19/2000</date>
<releaseinfo>Version 0.3a</releaseinfo>

<abstract>
<para>Online Hilfe / Einf&uuml;hrung in KTimemon, Version 0.3a.</para>
</abstract>

<keywordset>
<keyword>system</keyword>
<keyword>timemon</keyword>
<keyword>monitor</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Einf&uuml;hrung</title>

<para>KTimemon ist ein kleines Programm, mit dessen Hilfe Sie die
Systemauslastung ihres Computers verfolgen k&ouml;nnen.
Es ist m&ouml;glich, sowohl Graphen mit Informationen &uuml;ber die Nutzung von CPU,
Speicher und Auslagerungsdatei als auch &uuml;ber die Nutzung und Aktivit&auml;t
der Festplatte darzustellen. Ganz im Sinne von <ulink url="http://www.kde.org/">KDE</ulink>
unterst&uuml;tzt es die Konfiguration &uuml;ber eine graphische Benutzeroberfl&auml;che.
Es unterst&uuml;tzt weiterhin das <emphasis>"Andocken"</emphasis>, d.h. es kann
z.B. Informationen in der Kontrollleiste anzeigen.</para>

<para><emphasis remap="bf">Hinweis:</emphasis> Gegenw&auml;rtig unterst&uuml;tzt
KTimemon nur eine begrenzte Anzahl von Systemen: auf Linux basierte Installationen
mit dem <literal remap="tt">/proc</literal>-Dateisystem, auf Solaris basierte
Installationen mit der <emphasis>kstat</emphasis>-Bibliothek und auf Digital Unix
(fr&uuml;her DEC/OSF1) basierte Installationen mit dem
<emphasis>table(2)</emphasis>-Systemaufruf. Hilfe bei der Portierung auf
andere Plattformen ist sehr willkommen.</para>

<para>KTimemon kann entweder von der Befehlszeile oder vom KDE-Startmen&uuml;
(Untermen&uuml; <emphasis>Dienstprogramme</emphasis>) aus gestartet werden.
Wenn Sie von der Befehlszeile aus starten, k&ouml;nnen Sie KTimemon die &uuml;blichen
Startparamater des X-Window-Systems mitgeben wie z.B. <literal remap="tt">-geometry</literal>. 
KTimemon ist <emphasis>sitzungskonform</emphasis>, d.h. es speichert die
gegenw&auml;rtigen Einstellungen (Farben, usw.) und stellt sie in der n&auml;chsten
Sitzung wieder her.</para>

</chapter>

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

<para>Sie k&ouml;nnen KTimemon &uuml;ber den <ulink
url="ftp://ftp.kde.org/pub/kde/unstable/apps/utils/ktimemon-0.3a.tgz">
FTP-Server</ulink> von KDE (oder seinen Spiegelservern) beziehen. Speichern
Sie das Paket in einem Verzeichnis Ihrer Wahl und geben Sie danach die
folgenden Befehle ein:</para>

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

<para>KTimemon wird nun kompiliert und installiert. Falls hierbei
irgendwelche Probleme auftreten, schicken Sie bitte eine Nachricht an die Adresse
<ulink url="mailto:m.maierhofer@tees.ac.uk">m.maierhofer@tees.ac.uk</ulink>.
KTimemon bindet sich in die Verzeichnis-Hierarchie von KDE ein. Sie
k&ouml;nnen es &uuml;ber das Men&uuml; <emphasis>Dienstprogramme</emphasis> aufrufen,
nachdem Sie die Kontrollleiste neu gestartet haben.</para>

</chapter>

<chapter id="fund">
<title>Grunds&auml;tzliches</title>

<para>Nach dem Start von KTimemon erscheint ein Fenster, das verschiedene
Informationen &uuml;ber das Betriebssystem enth&auml;lt. Wenn Sie den Mauszeiger &uuml;ber
das KTimemon-Fenster f&uuml;hren und ihn f&uuml;r kurze Zeit nicht bewegen, so erscheint
ein <emphasis>Kurztip</emphasis> (d.h. ein kleines Fenster). Der
Kurztip enth&auml;lt Informationen &uuml;ber die in Form von Graphen dargestellten
Systemparameter. Dieses Verhalten kann abgeschaltet werden (siehe <link
linkend="config">Konfiguration</link>).</para>

<sect1 id="modes">
<title>Anzeigemodi</title>

<para>KTimemon kann die Systeminformationen auf zwei unterschiedliche Arten
darstellen. Wie im Abschnitt <link linkend="config">Konfiguration</link>
beschrieben, k&ouml;nnen Maustasten mit verschiedenen Aktionen belegt
werden. Standardm&auml;&szlig;ig bewirkt ein Druck auf die linke Maustaste im
KTimemon-Fenster ein Umschalten vom Normalmodus in den erweiterten
Modus und zur&uuml;ck.</para>

<sect2 id="normalmode">
<title>Normalmodus</title>

<para>Nach seinem ersten Start zeigt KTimemon Informationen &uuml;ber die
gegenw&auml;rtige CPU-Nutzung sowie &uuml;ber die Nutzung von Speicher- und
Auslagerungsdatei an. Dies geschieht in Form von drei Graphen, welche
regelm&auml;&szlig;ig aktualisiert werden (das Standardintervall betr&auml;gt 0,5 Sekunden,
kann aber ge&auml;ndert werden, siehe <link
linkend="config">Konfiguration</link>). Die drei Graphen stehen (von links
nach rechts) f&uuml;r:

<variablelist>
<varlistentry>

<term>CPU-Nutzung</term>

<listitem>
<para>KTimemon zeigt den Balken in drei verschiedenen Farben
an, welche jeweils die CPU-Nutzung in verschiedenen Modi repr&auml;sentieren. Von
unten nach oben sind dies: Kernel-Modus, Benutzer-Modus und Benutzer-Modus mit
heruntergesetzter Priorit&auml;t (<emphasis>Nice</emphasis>). Da Solaris
Statistiken f&uuml;r den Nice-Modus nicht zu unterst&uuml;tzen scheint, steht der
oberste Teil des Balkens auf diesen Systemen f&uuml;r die Zeit, die im
<emphasis>wait</emphasis>-Status verbracht wurde. Die L&uuml;cke zwischen der
Oberseite des Balkens und der Oberseite des Fensters zeigt den Prozentsatz
der CPU-Inaktivit&auml;t an.</para>

</listitem>
</varlistentry>

<varlistentry>
<term>Speichernutzung</term>

<listitem>
<para>&Auml;hnlich wie der CPU-Nutzungsbalken, besteht auch dieser aus drei
Feldern, die folgendes anzeigen (von unten nach oben): Speicher, der von
Prozessen belegt ist, Speicher, der f&uuml;r Eingabe/Ausgabe Bufferung benutzt
wird und Speicher, der als Dateicache benutzt wird. Bei auf Digital Unix
basierten Systemen, zeigt der mittlere Bereich "inaktiven" Speicher an, d.h.
Speicher, der belegt ist und f&uuml;r eine bestimmte Zeit nicht genutzt wird. Bei
Solaris Systemen wird der mittlere Teil des Balkens nicht benutzt, w&auml;hrend
der obere Teil hier den Teil des Speichers anzeigt, der vom Kernel genutzt
wird. Die L&uuml;cke zwischen der Oberseite des Balkens und der Oberseite des
Fensters zeigt den freien Speicher an.</para> </listitem>
</varlistentry>

<varlistentry>
<term>Nutzung der Auslagerungsdatei</term>

<listitem>
<para>Dieser Balken besteht aus einem einzigen Feld, welches die
gegenw&auml;rtige Nutzung der Auslagerungsdatei relativ zur Gesamtgr&ouml;sse des vorhandenen
Auslagerungsbereichs anzeigt.</para>
</listitem>

</varlistentry>
</variablelist>

</para>

<para>Durch Dr&uuml;cken derjenigen Maustaste, die f&uuml;r das Umschalten eingestellt
wurde, wechselt das Programm in den "Erweiterten Modus". </para>

</sect2>

<sect2 id="xtndmode">
<title>Erweiterter Modus</title>

<para>In diesem Modus zeigen die drei Balken andere Systeminformationen an.
Auch hier wieder von links nach rechts: 

<variablelist>
<varlistentry>

<term>Speicheraktivit&auml;t</term>

<listitem>
<para>Dieser Balken besteht aus zwei Teilen. Die untere H&auml;lfte zeigt die
Anzahl der Schreibzugriffe auf den Speicher w&auml;hrend des letzten
Aktualisierungsintervalls. Entsprechend zeigt die obere H&auml;lfte die 
Lesezugriffe an.</para>
</listitem>

</varlistentry>
<varlistentry>

<term>Auslagerungsaktivit&auml;t</term>

<listitem>
<para>Der zweite Balken zeigt die entsprechenden Informationen &uuml;ber die
Auslagerungsaktivit&auml;t an.</para>
</listitem>

</varlistentry>

<varlistentry>

<term>Kontext-Umschaltung</term>

<listitem>
<para>Dieser Balken besteht aus einem Feld und zeigt die
Kontext-Umschaltungen im letzten Aktualisierungsintervall an.</para>
</listitem>

</varlistentry>
</variablelist>
</para>

<para>Da es keinen "normalen" Weg gibt, die im erweiterten Modus angezeigten
Informationen zu skalieren, benutzt KTimemon standardm&auml;&szlig;ig eine
<emphasis>automatische Skalierung</emphasis> (dies wird im Abschnitt <link
linkend="autoscaling">Allgemeine Fragen</link> n&auml;her erl&auml;utert). Es gibt
jedoch trotzdem einen Weg der manuellen Skalierung (siehe den Abschnitt <link
linkend="config">Konfiguration</link>).</para>

<para>Beachten Sie, da&szlig; die beiden Balken-Fenster die gleichen Farben
benutzen, d.h., da&szlig; die Farben im "Normalmodus" auch f&uuml;r den "Erweiterten
Modus" verwendet werden (siehe auch unter <link
linkend="config">Konfiguration</link> "Wie ver&auml;ndere ich die
Farbeinstellungen?").</para> </sect2> </sect1>

<sect1 id="menu">
<title>Men&uuml;struktur</title>

<para>Standardm&auml;&szlig;ig ist die rechte Maustaste mit dem Kontextmen&uuml; verkn&uuml;pft,
d.h. ein Klick auf die rechte Maustaste irgendwo im KTimemon-Fenster &ouml;ffnet
ein Men&uuml;, welches im folgenden Abschnitt beschrieben wird.</para>

<sect2 id="help">
<title>Hilfe</title>

<para>Das <emphasis>Hilfe</emphasis>-Men&uuml; ist nichts au&szlig;ergew&ouml;hnliches.
Sie werden es vermutlich schon kennen.</para> </sect2>

<sect2 id="configmenu">
<title>Einstellungen</title>

<para>Das Men&uuml; <emphasis>Einstellungen</emphasis> &ouml;ffnet ein
Konfigurationsfenster. Dessen Optionen werden im Abschnitt <link
linkend="config">Konfiguration</link> n&auml;her erl&auml;utert.</para> </sect2>

<sect2 id="dockedinpanel">
<title>Andocken</title>

<para>Bei Anwahl des Men&uuml;s <emphasis>Andocken</emphasis>, schaltet KTimemon
zwischen dem normalen Fenster und dem Andocken um, wobei in diesem Fall das
normale Fenster verschwindet und durch eine minimierte Version in der
Kontrollleiste ersetzt wird. Bis auf die Gr&ouml;&szlig;e weist das minimierte
Fenster die gleichen Funktionen wie das gro&szlig;e auf. </para>

</sect2>

<sect2 id="horizontalbars">
<title>Horizontale Balken</title>

<para>Durch Auswahl des Men&uuml;-Eintrags <emphasis>Horizontale
Balken</emphasis>, schaltet KTimemon von vertikaler Balkendarstellung auf
horizontale Darstellung.</para> </sect2>

<sect2 id="quit">
<title>Beenden</title>

<para>Das Men&uuml; <emphasis>Beenden</emphasis> schlie&szlig;t KTimemon. Es speichert
vorher die aktuellen Einstellungen (wie z.B. Farbschema, Fenstergr&ouml;&szlig;e usw.)
und stellt diese beim n&auml;chsten Aufruf wieder her.</para>

<para>Die Konfigurations-Informationen werden in der Datei <literal
remap="tt">$(HOME)/.kde/share/config/ktimemonrc</literal>, wobei sich <literal
remap="tt">$(HOME)</literal> auf das Pers&ouml;nliche Verzeichnis des Benutzers bezieht.
Falls die Datei gel&ouml;scht wird, startet KTimemon beim n&auml;chsten Aufruf mit seinen
Standardeinstellungen.</para>

</sect2>
</sect1>
</chapter>

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

<para>KTimemon kann &uuml;ber einen Dialog konfiguriert werden (siehe auch die
Bemerkungen zu den <link linkend="configmenu">Einstellungen</link>).
Auf der Seite <emphasis remap="bf">Allgemein</emphasis> kann sowohl das
Aktualisierungsintervall als auch die Skalierungsmethode eingestellt
werden (siehe auch die Bemerkungen zum <link
linkend="xtndmode">Erweiterten Modus</link>). Wenn die Option
<emphasis>Autoskalierung</emphasis> aktiviert ist (n&auml;here Informationen hierzu
gibt es im Abschnitt <link linkend="autoscaling">FAQ</link>), so kann der
Skalierungsfaktor nicht manuell festgelegt werden, da KTimemon diesen
selbstst&auml;ndig ermittelt.</para>

<para>&Uuml;ber die Seite <emphasis remap="bf">Farben</emphasis> k&ouml;nnen die
Balkenfarben eingestellt werden. Ein kleiner Balken liefert hierzu eine
Vorschau.</para>

<para>Auf der Seite <emphasis remap="bf">Interaktion</emphasis> k&ouml;nnen die
Mauseinstellungen angepasst werden. Mausklicks im KTimemon-Fenster
k&ouml;nnen ignoriert werden, einzelne Maustasten k&ouml;nnen als "Modus
umschaltend" definiert werden (siehe auch <link linkend="modes">Modi</link>),
das Kontextmen&uuml; aufrufen (siehe <link linkend="menu">Men&uuml;</link>) oder
einen externen Prozess starten. Eine hierf&uuml;r eingegebene Befehlsabfolge
wird von der Standard-Shell abgearbeitet.</para>

<para>Die Interaktionsseite enth&auml;lt desweiteren eine Option, die es
erm&ouml;glicht, den Kurztip auszuschalten (vergleiche <link
linkend="fund">Grunds&auml;tzliches</link>).</para>

</chapter>

<chapter id="autoscaling">
<title>H&auml;ufige Fragen und Antworten</title>

<para>
<variablelist>
<varlistentry>

<term>Welche Betriebssysteme werden von KTimemon unterst&uuml;tzt?</term>

<listitem>
<para>KTimemon unterst&uuml;tzt auf Linux basierte Systeme mit dem <literal
remap="tt">/proc</literal>-Dateisystem, auf Solaris basierte Systems mit der
<emphasis>kstat</emphasis>-Bibliothek, und auf Digital Unix (fr&uuml;her DEC/OSF1)
beruhende Systeme mit dem <emphasis>table(2)</emphasis>-Systemaufruf.
Lediglich die Linux-Version wurde gr&uuml;ndlich getestet. Falls Sie irgendwelche
Probleme unter Solaris/Digital Unix entdecken, kontaktieren Sie mich
bitte.</para>

<para>Desweiteren ist Hilfe bei der Portierung auf
andere Plattformen ist sehr willkommen. Kontaktieren Sie mich unter <ulink
url="mailto:m.maierhofer@tees.ac.uk">m.maierhofer@tees.ac.uk</ulink>, falls
Sie beabsichtigen, KTimemon auf andere Unix-Systeme zu portieren.</para>

</listitem>
</varlistentry>

<varlistentry>
<term>Wie funktioniert die Autoskalierung?</term>

<listitem>
<para>Da es keinen vorbestimmten Skalierungsfaktor f&uuml;r
Paging/Auslagerungsaktivit&auml;t gibt, benutzt KTimemon einen
halbintelligenten Autoskalierungsmechanismus. Dies funktioniert so:

<itemizedlist>

<listitem>
<para> Jeder der drei Balkengraphen hat, wie
Abschnitt <link linkend="xtndmode">Erweiterter Modus</link> beschrieben,
einen entsprechenden Skalierungsfaktor. Die Anfangswerte der einzelnen
Faktoren werden anfangs auf einen vorbestimmten Wert gesetzt. </para>

</listitem>

<listitem>
<para>Sobald die Anzeige aktualisiert wird, wird der
entsprechende Wert abh&auml;ngig vom entsprechenden Faktor skaliert. Falls der
Wert in der vom Faktor gew&auml;hlten Skalierung angezeigt werden kann, wird keine
&Auml;nderung in der Darstellung vorgenommen (d.h. dass sich kleine &Auml;nderungen der
Aktivit&auml;t auf die H&ouml;he des Balkens auswirken).</para>
</listitem>

<listitem>
<para>Falls der skalierte Wert zu gro&szlig; oder zu klein ist, um mit dem
gegenw&auml;rtigen Skalierungsfaktor angezeigt werden zu k&ouml;nnen,
so wird die Skalierung dahin ge&auml;ndert, dass der neue Wert, welcher dargestellt
wird, etwas gr&ouml;sser als der dargestellte Balken ist. Hierdurch sollten sp&auml;tere
Werte ohne erneute Skalierung dargestellt werden k&ouml;nnen.</para>
</listitem>

</itemizedlist>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Warum erscheint die Meldung "diagnostic output from child command"
?</term>

<listitem>
<para>Wenn sie ihre Maustaste mit einem externen Befehl
verkn&uuml;pfen (wie im Abschnitt <link linkend="config">Konfiguration</link>
beschrieben), &uuml;berpr&uuml;ft KTimemon Ihre Eingabe nicht. Stattdessen wird eine
Shell aufgerufen, um den Befehl auszuf&uuml;hren. Um dem Benutzer eine
R&uuml;ckmeldung zu liefern, zeigt KTimemon die <emphasis>stderr</emphasis>-Ausgabe
der Shell in der Dialogbox an.</para>

<para>W&auml;hrend dieses Verhalten sehr sinnvoll sein kann, falls der Befehl
nicht gefunden wird, so ist es eher l&auml;stig, falls ein Befehl lediglich
R&uuml;ckmeldungen ausgibt. Eine sehr einfache und gleichzeitig zweckm&auml;&szlig;ige L&ouml;sung
dieses Problems ist es, an das Ende des Kommandos den Befehl <literal
remap="tt">2&gt;/dev/null</literal> anzuf&uuml;gen. Dieser Befehl leitet alle
Meldungen der Shell an das Nulldevice und verhindert somit das Erscheinen
der Nachricht.</para>

</listitem>
</varlistentry>
</variablelist>
</para>
</chapter>

<chapter id="revisionhistory">
<title>Abfolge der Versionen</title>

<para>
<variablelist>
<varlistentry>
<term>Version 0.1.</term>
<listitem>
<para>(29 Juli 1998) Erste Ver&ouml;ffentlichung.</para>
</listitem>
</varlistentry>

<varlistentry>

<term>Version 0.2.</term>

<listitem>
<para>(20 August 1998) 

<itemizedlist>

<listitem>
<para>Unterst&uuml;tzung f&uuml;r den <link linkend="xtndmode">Erweiterten Modus</link>
hinzugef&uuml;gt.</para> </listitem> <listitem>
<para>&Auml;nderung des Konfigurationsdialoges (Benutzung von Layouts statt
fester Geometrie).</para> </listitem> <listitem>
<para>&Auml;nderung einiger Details im Konfigurationsdialog  (z.B. wird der
<literal remap="tt">/proc</literal> Mount-Punkt jetzt automatisch
erkannt).</para>
</listitem>

<listitem>
<para>Unterst&uuml;tzung f&uuml;r
Internationalisierung hinzugef&uuml;gt.</para>
</listitem>

</itemizedlist>
</para>
</listitem>

</varlistentry>

<varlistentry>
<term>Version 0.2a.</term>

<listitem>
<para>(29 August 1998) 

<itemizedlist>
<listitem>
<para>Beseitigung eines kleinen Bugs in der Autoerkennung des <literal
remap="tt">/proc</literal> Dateisystems von <literal
remap="tt">/etc/mtab</literal>.</para> </listitem> </itemizedlist>
</para>
</listitem>

</varlistentry>

<varlistentry>
<term>Version 0.2b.</term>

<listitem>
<para>(3 Dezember 1998)
<itemizedlist>

<listitem>
<para>Behebung eines kleinen Kompatibilit&auml;tsproblems mit der
Farbzuteilung.</para>
</listitem>

</itemizedlist>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Version 0.3.</term>
<listitem>
<para>(11 Februar 1999)

<itemizedlist>
<listitem>
<para>Behebung eines Fehlers in der Handhabung der Konfigurationsdatei von
Cristian Tibirna. Sie k&ouml;nnen die Datei <literal
remap="tt">ktimemonrc</literal> aus dem Verzeichnis <literal
remap="tt">$(HOME)/.kde/share/config</literal> entfernen, um mit der
Standardkonfiguration zu starten.</para> </listitem> <listitem> <para>Der
Konfigurationsdialog wird nun nur noch auf Nachfrage zugeordnet. Dies
reduziert die Speicherbelegung von KTimemon</para> </listitem> <listitem>
<para>Erste Schnittstelle zu Digital Unix (DEC/OSF1) und Solaris.</para>
</listitem> <listitem> <para>Konfigurierbare vertikale und horizontale
Balken.</para> </listitem>

<listitem>
<para>Die Anordnung der Informationen zur Speicherbenutzung wurde leicht
ver&auml;ndert.</para>
</listitem>

<listitem>
<para>Konfigurierbare Maustasten.</para>
</listitem>

<listitem>
<para>Vorl&auml;ufige, geringf&uuml;gige Unterst&uuml;tzung f&uuml;r SMP.</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>

<varlistentry>
<term>Version 0.3a.</term>
<listitem>

<para>(16 April 1999)
<itemizedlist>
<listitem>
<para>Hinzuf&uuml;gung von Kurztips (vorgeschlagen von Mark Krischer).</para>
</listitem>

<listitem>
<para>Hinzuf&uuml;gung von fehlender Internationalisierung in der
Konfigurationsleiste und Verbesserung der &Uuml;bersetzung (Dank an Lubos Lunak
f&uuml;r den Hinweis).</para> </listitem> <listitem> <para>Geringf&uuml;gige
Verbesserung des Codes.</para>
</listitem>

</itemizedlist>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</chapter>

<chapter id="thanksandacknowledgements">
<title>Danksagungen</title>

<para>KTimemon basiert auf der Xt-Version meines Bruders.</para>

<para>Dank an 
<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>
und <ulink url="mailto:l.lunak@sh.cvut.cz">Lubos Lunak</ulink>
f&uuml;r Bug-Hinweise, Patches, Kommentare und Vorschl&auml;ge.</para> 
<para>&Uuml;bersetzung:

<itemizedlist>
<listitem>

<para>Christian Schmitt
<email>chris.81@gmx.de</email></para>

</listitem>
</itemizedlist></para>

</chapter>
</book>
