# KTimemon 取り扱い説明書

Martin Mainerhofer

    m.maierhofer@tees.ac.uk

最終更新1999年4月16日

KTimemon バージョン0.3aのオンラインヘルプならびにご紹介

これはktimemon(KDE用のシステムモニタ)の取り扱い説明書です。

system monitor
timemon

## はじめに

KTimemonはシステムの動作状況を追跡調査するためのユーティリティです。ハードディスクの使用状況やコンテクスト交換動作はもちろんのこと、CPU、メモリ、スワップディスクの稼働状況について棒グラフで表示します。KDE 精神にのっとり, マウスで簡単に操作できるようにしてあります。更には、システムパネルに情報を表示できるよう(docking対応)にしてあります。

注意： 今のところKTimemonは限られたプラットフォームでしか動作しません。`/proc`ファイルシステムでのリナックス, kstatライブラリ付きのソラリス、table(2)システムコール付きのデジタルユニックス(昔のDEC/OSF1) がそれです。他のプラットフォームへの移植を手伝っていただける方、大歓迎いたします。

KTimemonはコマンド入力するか、KDEの(ユーティリティ サブメニュー)から選択して立ち上げます。 コマンド入力で立ち上げたときには`-geometry`のようなＸウインドウのプログラムフラッグに迎えられることでしょう。KTimemonはセッションを感知するので、次にコンピュータを立ち上げたときに前回の状態(色、その他)を再現することができます。

## インストールのしかた

KTimemonはKDE ftp serverとそのミラーサイトからダウンロードできます。 ダウンロード後に、以下の手順にしたがってインストールして下さい。

    $ cd <the_directory_where_you_put_ktimemon-0.3a.tgz>
    $ gzip -cd ktimemon-0.3a.tgz | tar xfv -
    $ cd ktimemon-0.3a
    $ ./configure
    $ make install

うまくインストールできるはずですが、もし問題が生じたときには次のアドレスまで御連絡下さい。m.maierhofer@tees.ac.uk

インストール後に、KTimemonがKDEに組み込まれ、ユーティリティ メニューから起動できるはずです。

## 基本操作

KTimemonを起動すると小さなウインドウが開き、OSが管理しているシステム情報が棒グラフで表示されます。マウスをこのウインドウ上に持って来てちょっと待つとtool-tip、すなわち小さな一時的ウインドウが開きます。このtool-tipには棒グラフの値が数値で示されます。Tool-tipは不活性にしておくことができます。詳しくは、「自由調整」)の章を参照して下さい。

### 表示モード

KTimemonでは二種類のシステム情報を表示することができます。後で「自由調整」について見ていただければわかると思いますが, マウスのボタンを色々に使うことができ、インスト−ル直後では、左ボタンをKTimemonウインドウのどこかでクリックすれば画面が 切り替わるように設定してあります。画面は標準モ−ドと拡張モ−ドの間で切り替わります。

#### 標準モ−ド

KTimemonは初めて起動されたとき、その場のCPU、メモリ、スワップディスクの稼働状況を表示します。この情報は定期的に更新されます。更新の頻度は設定し直さない限り0.5秒に一回の割合です。この設定を変えたいときは「自由調整」の章をご覧下さい。表示されるこれら三つの棒グラフは左から右の順で

CPUの稼働状況

  KTimemonの棒グラフは三色表示になっています。各色はそれぞれ、下から上へ順に、カ−ネルモ−ド、ユ−ザ−モ−ド、低順位ユ−ザ−モ−ド(ナイスモ−ド)でのCPUに対する割当時間を示します。

  -ただし、ソラリスの場合にはナイスモ−ドでの状況把握ができないらしく、棒グラフの最上部には演算待ち時間 が示されます-

  棒グラフの最上部とウインドウの間のすき間はCPUが遊んでいる時間の割合を表わします。

メモリの使用状況

  メモリの使用状況については、下から上へ、プロセス占有容量、入出力バッファ容量、キャッシュ容量の順で示されます。デジタルユニックス系では中間部に不活性メモリ容量(確保されているが一定時間放置されている容量)が示されます。 ソラリス系では中間部には何も表示されず、また、最上部にはカーネル占有容量が示されます。棒グラフ最上部とウインドウの間のすき間はメモリ残量を表します。

スワップディスクの使用状況

  棒グラフは単純に現時点でのスワップディスクの稼働率を示します。

KTimemonウインドウ内である特定のマウスボタンをクリックすると画面が拡張モードに切り替わります。

#### 拡張モード

このモードでは標準モードで表示されるシステム情報とは別のシステム情報が表示されます。これらは左から右に以下のものを示します。

呼び出し動作

  この棒グラフの下半分は二次記憶へ書き込まれたメモリページ枚数、上半分は二次記憶から読み込まれたメモリページ枚数を表します。これらの数値は時々刻々更新されているのではなく、測定命令が出されたときの状態を反映しているに過ぎません。

スワップ動作

  これはスワップ動作を時々刻々連続表示します。

コンテクスト交換動作

  ここにはコンテクスト交換数が表示されます。この数値も、命令が出されたときの一回の測定結果を表示しているに過ぎません。

拡張モードでは特に何も指定しない限り、自動的にグラフ目盛りが調整された上で情報が示されます。(「よくある質問」を参照のこと) というのは、このモードで表示される情報に対しては、適当な目盛り方というのが見当たらないからです。 しかしながら、目盛り方を特定することは可能です。「自由調整」の章を参照して下さい。

棒グラフの色使いについては標準、拡張の両モードで共通です。色使いを変えたいときは「自由調整」の章を参照して下さい。

### メニュー構成

改めて設定し直さない限り、KTimemonウインドウ内で右マウスボタンをクリックすることでメニューがとび出すようにしてあります。

#### ヘルプ

ヘルプ はきわめて一般的にまとめられています。賢明なKDE ユーザの皆さんに改めて説明する必要もないでしょう。

#### 諸設定

諸設定を変更するには、メニューから「自由調整」を選んで下さい。「自由調整」でどんなことができるのかについては「自由調整」の章で説明してあります。

#### パネルへの組み込み

パネルへの組み込みを選ぶとKTimemon本来のウインドウとパネル組み込みウインドウが入れ替わります。組み込みウインドウは小さいながら機能はまったく同等です。

#### 横棒グラフ化

横棒グラフ化を選ぶ毎に棒グラフの表示が垂直か水平に切り替わります。あまり、深い意味はありませんが、やりやすかったので入れてみたまでです(^_^)

#### 終了

終了が選択されたとき、KTimemonの諸設定(色使い、ウインドウの大きさ、パネルへ組み込みの有無)が保存され、次に起動されたときに再現されます。

これら、調整に関係するデータは`$(HOME)/.kde/share/config/ktimemonrc`というファイルに保存されます。 ここで`$(HOME)`はユーザのホームディレクトリを指します。もし、このファイルがみつからないときは、予めKTimemonに組み込んである初期設定が採用されます。

## 自由調整

KTimemonの調整のため、簡便な設定画面を用意しました。詳しくは「自由調整」の各メニュー項目を御覧下さい。 一般事項ではシステム状態の測定頻度と結果表示のグラフ目盛りについて設定できます。併せて、拡張モード)につていの説明にも目を通しておいて下さい。目盛りを手動設定するときは自動目盛り調整のチェックをはずしてから行って下さい。自動目盛り調整についてはよくある質問を御覧下さい。

色使いではユーザーの好みに棒グラフの色を指定できます。かわいい見本が現れ、指定した色を確認できます。

連係動作では、マウス設定ができます。KTimemonウインドウ内でのマウスクリックを無効にしたり、表示モードの変更、コンテクストメニュー表示、外部プロセスの実行に指定できます。詳しくは、「モード」)メニューを御覧下さい。外部コマンドは標準シェルによって中断できます。つまり、シェルコマンド、環境変数、再指定等が可能です。

また、この項では棒グラフの数値データを自動表示(tool-tips)するかどうかを選択することができます。チェックボックスの印を確認して下さい。ここでの説明事項は「基本操作」と比較していただければ理解が深まると思います。

## よくある質問

KTimemonが動くOSは?

  KTimemonは`/proc`ファイルシステムでのリナックス、 kstatライブラリ付きのソラリス、table(2)システムコール付きのデジタルユニックス(昔のDEC/OSF1) で動きます。Linux上でしか綿密に動作確認していませんので 、もしソラリスやデジタルユニックス上で不具合がありましたら遠慮なくご連絡下さいますようお願い致します。

  また、他のプラットフォームへの移植を手伝っていただける方、大歓迎いたします。 次のアドレスまでご連絡下さい。 m.maierhofer@tees.ac.uk

グラフ目盛はどんな風に自動設定されるの？

  お尋ねいただき光栄です。というのは、メモリのように装着容量を基準にとれる場合は例外として、呼び出し、入れ替え、コンテクスト交換という動作に対しては適当な計量方法が決められていないからです。そこでKTimemonでは以下の半感応式自動目盛を採用しました。

  - 拡張モードのところで説明したように、棒グラフは三本、表示されます。そして、それぞれが専用の目盛り設定情報を保有し、それらは既に棒グラフを表示するのに使用されています。

  - 表示が改まる度に三本の棒グラフは試験的に仮の目盛りを用いて描かれます。もし、それがちょうど具合がよければ目盛幅はそのままになります。つまり、一定目盛幅の棒グラフにシステム活動状況の変化が高低変化として表現されます。

  - 試験目盛が大きすぎたり、小さすぎるときは棒グラフの高さがだいたいウインドウの半分くらいになるように調整されます。このような半自動調整により、目盛り幅をその後再調整することなく、データが見易く表示されます。

"diagnostic output from childcommand" メッセージはなぜ出て来るの？

  「自由調整」のところでも述べたように、KTimemonではマウスボタンのクリックを外部コマンドの実行に使うことができますが、そのコマンドが正しいかどうかまでは確認しません。そのため、そのコマンドはすぐ実行されてしまいます。その代わりと言ってはなんですが、stderrに出力されるエラーメッセージが見れるようにしてあります。

  この機能はコマンドが不適切な時は有用ですが、場合によっては分かり切ったことをくどくどと言ってきて、邪魔になることがあるかもしれません。これを解決する必殺技はコマンド入力の際に`2>/dev/null`を付け加えることです。これで、煩わしいメッセージを葬り去ることができます。

## 改訂履歴

ヴァージョン0.1.

  初版(1998年7月29日)

ヴァージョン0.2.

  (1998年8月20日)

  - 拡張モードを追加しました。

  - 「自由調整」ダイアログを固定枠から任意調整枠へ変更しました。

  - 「自由調整」ダイアログの内容変更(`/proc`マウントポイントが自動的に消去されるようにしました)。

  - 多言語化に対応しました。

ヴァージョン0.2a.

  (1998年8月29日)

  - `/etc/mtab`から`/proc`ファイルシステムが読み込まれる時にに発生していた小さなバグを修正しました。

ヴァージョン0.2b.

  (1998年12月3日)

  - 色使いの初期設定にあったちょっとした互換性に関する問題点を解決しました。どなたか最近、QColorを変更してこの問題に気づかれたでしょうか？

ヴァージョン0.3.

  (1999年2月11日)

  - クリスチャン　ティバーナさんからご指摘いただきました「自由調整」におけるバグを修正しました。まっさらな状態からやり直すために、`ktimemonrc`ファイルを`$(HOME)/.kde/share/config`から消去してから再調整すると良いでしょう。

  - これで、呼ばれたときにだけ「自由調整」ダイアログがメモリに読み込まれるようになり、KTimemonがいくぶん身軽になりました。

  - デジタルユニックス(DEC/OSF1)とソラリスへの初期ポート

  - 調整可能な垂直・水平バー

  - メモリ使用状況の表示形態を少し変えました。

  - 調整可能なマウス設定

  - 驚く程のことでもありませんが、SMPに試験的に対応させました。

ヴァージョン0.3a.

  (1999年4月16日)

  - マーク　クリシャーさんのご提案に従い、ツールティップスをtimemonのウイジェットに仲間入りさせました。

  - 行方不明になっておりました多言語機能をパネルに組み込むと同時に翻訳機能を削除しました。ルーボス　ルナークさん、ご報告ありがとうございました。

  - 測定クラスのあまり重要でないコードを削除しました。

## 謝辞

KTimemonはXt上に構築されました。 Xtを開発した兄に感謝します。

バグ報告、パッチの開発、有用なご意見をお寄せ頂きました諸氏に御礼申し上げます。 Tobe Toben, Cristian Tibirna, Dirk A. Mueller, Mark Krischer Lubos Lunak