# KDatドキュメンテーション

Sean
Vyain

    svyain@mail.tds.net

??/??/??
バージョン 2.0

このドキュメンテーションは、KDat 2.0について解説しています。

KDE
KDat
Tape management

## はじめに

KDatは、tar ベースのテープアーカイバで、単一のテープ上の複数のアーカイブを処理する設計となっています。KDat の開発には、2つの別々の目標がありました。第１の目標は、dds2tarプログラムの高速選択的抽出機能をサポートする tar に対して、体裁のいいGUIのフロントエンドを提供することでした。第2の目標は、私の妻の「バックアップにかかる時間は一体どれだけ長くなるの?!」という質問に対する回答をもたらすことでした。

### 特長

- ローカルファイルシステムとテープコンテンツへの単純なグラフィカルインタフェース。

- 1つの物理テープ上に複数のアーカイブがある。

- アーカイブとファイルの完備したインデックスがローカルハードディスクに格納されている。

- アーカイブからのファイルの選択的復元。

- 頻繁に使用するバックアップに対するバックアッププロファイル。

## KDatの使い方

### テープの搭載／取外し

テープは、KDat によって搭載されてからでなければ使うことができません。テープを搭載する方法は次の3通りです。

1. メニューの“File”から“Mount Tape”を選択する。

2. ツールバーのテープドライブのアイコンをクリックする。

3. テープドライブのツリーノードを右クリックして、“Mount Tape”を選択する。

はテープを巻き戻して、テープからヘッダー情報を読み込みます。KDat がテープのヘッダーを認識しない場合は、テープをフォーマットしてください、というメッセージが表示されます。

KDat がヘッダーを認識した場合は、ローカルディスク上に対応するテープインデックスがないか、探します。該当のテープインデックスが見つからないときは、テープからインデックスを作成することを求めるメッセージが表示されます。

すべて順調なら、テープドライブのアイコンは、テープの搭載が完了していることを示すものに変わり、ステータスバーにメッセージが表示されます。テープの内容は、テープドライブのツリーノードを調べれば分かります。

テープを取り出すには、まず取り外す必要があります。テープを取り外す方法は次の3通りです。

1. “File”メニューの“Unmount Tape”を選択する。

2. ツールバーのテープドライブのアイコンをクリックする。

3. テープドライブのツリーノードを右クリックして、“Unmount Tape”を選択する。

KDat によってテープが取り外されていることが確認されると、テープドライブのアイコンが変わり、ステータスバーのメッセージが表示されます。 そうなれば、テープを安全に取り出すことができます。

### テープのフォーマット

KDat は、フォーマットしてからしかテープを使うことができません。 テープの種類によっては、フォーマットしなければデータの保存に使用できないものもあります。KDat の行うフォーマットはそれとは別のものです。 使用しているテープドライブの要件として、テープは使用する前にフォーマットする必要がある場合は、KDat による「フォーマット」に先だって（通常の）フォーマットを行っておかなければなりません。一般的には、フロッピー用のテープドライブは媒体のフォーマットが必要ですが、DATドライブの場合は不要です。

テープをフォーマットする方法は次の2通りです。

1. “File”メニューから“Select Format Tape...”を選択する。

2. テープドライブのツリーノードを右クリックして、“Format Tape...”を選択する。

テープの名前と記載容量を求めるメッセージが現われます。この2つのパラメータは共に、テープのフォーマット後に変更することができます。テープ名は、ユーザがそのテープを識別するのに使うだけです。テープに対応するテープインデックスの識別に使うわけではありません。このテープ名ではなく、一意のテープ識別子が生成されて、それがテープに書き込まれます。テープの記載容量は、バックアップ用スペースが不足しそうな場合に、KDat がユーザに警告するベースとして使われます。

テープの名前と容量を入力したら、KDatによるテープのフォーマットが始まります。テープ上のデータはすべて失われます。 KDat によるテープのフォーマットが完了したら、テープは、自動的に搭載されて使えるようになります。

### ファイルをテープにバックアップする方法

バックアップを開始する前に、アーカイブの対象とするファイルを選択する必要があります。バックアップするテープを選択する方法は次の3通りです。

1. ローカルのファイルツリーで、該当のファイルまたはディレクトリを強調表示させる。 選択されたファイルあるいはサブディレクトリだけがアーカイブされます。

2. ツリーで、バックアッププロファイルを強調表示させる。 バックアッププロファイルにあるファイルだけがアーカイブされます。

3. ローカルのファイルツリーで選択したファイルにチェックマークを付ける。 チェックされたファイルおよびサブディレクトリだけがアーカイブされます。

Tバックアップを開始する方法は次の4通りです。

1. “File”メニューから“Backup...”を選択する。

2. ツールバーのバックアップのアイコンをクリックする。

3. ローカルのファイルツリーでファイルまたはディレクトリを右クリックし、“Backup...”を選択する。

4. バックアッププロファイルを右クリックして、“Backup...”を選択する。

バックアップが開始されると、“Backup Options”ダイアログが現われます。このダイアログでは、選択したファイルを見直し、バックアップ処理のオプションを変更することができます。

バックアップ処理のオプションが受け入れられたら、“Backup”ダイアログが現われます。このダイアログでは、スループットと残り時間をはじめとするバックアップ処理の進捗状況が表示されます。

### テープファイルとローカルファイルを照合して確認する方法

確認操作を開始するには、その前に確認したいファイルを選択する必要があります。確認対象のテープを選択する方法は次の2通りです。

1. テープドライブのツリーノードにあるアーカイブの一つでファイルまたはディレクトリを強調表示させる。 選択されたファイルあるいはサブディレクトリだけが確認されます。

2. テープドライブのツリーノードにあるアーカイブの一つで選択したファイルにチェックマークを付ける。 チェックされたファイルおよびサブディレクトリだけが確認されます。

確認処理を開始する方法は次の3通りです。

1. “File”メニューから“Verify...”を選択する。

2. ツールバーの確認のアイコンをクリックする。

3. アーカイブの一つでファイルまたはディレクトリを右クリックし、“Verify...”を選択する。

確認処理が開始されたら、“Verify Options”ダイアログが現われます。このダイアログでは、選択したファイルを見直して、確認処理を実行する作業ディレクトリを変更することができます。

確認処理のオプションが受け入れられたら、“Verify”ダイアログが現われます。このダイアログでは、スループットと残り時間をはじめとする確認処理の進捗状況が表示されます。

### テープからファイルを復元する方法

復元処理を開始するには、まず、復元するファイルを選択する必要があります。復元するファイルを選択する方法は次の2通りです。

1. テープドライブのツリーノードにあるアーカイブの一つでファイルまたはディレクトリを強調表示させる。 選択されたファイルあるいはサブディレクトリだけが復元されます。

2. テープドライブのツリーノードにあるアーカイブの一つで選択したファイルにチェックマークを付ける。 チェックされたファイルおよびサブディレクトリだけが復元されます。

復元処理を開始する方法は次の3通りです。

1. “File”メニューから“Restore...”を選択する。

2. ツールバーの復元のアイコンをクリックする。

3. アーカイブの一つでファイルまたはディレクトリを右クリックし、“Restore...”を選択する。

復元処理が開始されたら、“Restore Options”ダイアログが現われます。このダイアログでは、選択したファイルを見直して復元処理を実行する作業ディレクトリを変更することができます。

復元処理のオプションが受け入れられたら、“Restore”ダイアログが現われます。このダイアログでは、スループットと残り時間をはじめとする復元処理の進捗状況が表示されます。

### テープからインデックスを作成し直す方法

テープの内容からテープインデックスを作成し直すことが必要となる場合もあります。このプロセスを実行すると、そのテープの既存のインデックスファイルは上書きされます。 テープからインデックスを作成し直す方法は次の2通りです。

1. “File”メニューから“Recreate Tape Index”を選択する。

2. テープドライブのツリーノードを右クリックし、“Recreate Tape Index”を選択する。

“Index”ダイアログが現われます。このダイアログでは、インデックスファイル作成の進捗状況が表示されます。

### バックアッププロファイルの作成方法

バックアッププロファイルを作成する方法は次の2通りです。

1. “File”メニューから“Create Backup Profile”を選択する。

2. Rツリーノードの“Backup Profiles”を右クリックして、“Create Backup Profile”を選択する。

この操作で、現在チェックされているファイルとバックアップ処理のデフォルトのオプションを使って新しいバックアッププロファイルが作成されます。バックアッププロファイルに対して設定できるオプションは以下のとおりです。

アーカイブ名

  アーカイブを象徴的に表す名前です。後で変更可能です。

作業ディレクトリ

  バックアップ処理を実行する現在の作業ディレクトリです。バックアップするファイルのリストは、選択された作業ディレクトリを反映するように自動的に更新されます。

Stay on one filesystem（一つのファイルシステム上に常駐）

  “Backup files”にリストされたファイルの各ディレクトリについて、当該ディレクトリにあるファイルのうち、そのディレクトリと同じファイルシステム上にあるディレクトリのファイルだけがアーカイブされます。異なるファイルシステム上のディレクトリは“Backup files”にリストすることができますが、tarはそれぞれを別々に扱います。

GNU listed incremental（GNU 記載インクリメンタルバックアップ）

  インクリメンタルバックアップを実行します。スナップショットファイルを使って、直前のインクリメンタルバックアップ以降変更されているファイルが特定されます。変更されているファイルだけがアーカイブされます。

スナップショットファイル

  直前のインクリメンタルバックアップ以降変更されているファイルを特定するのに使われるファイルの名前です。

Remove snapshot file before backup.（バックアップ前にスナップショットファイルを削除）

  tar を呼び出す前にスナップショットファイルを削除します。この機能を使うと、すべてのファイルがバックアップされ、次回に使用できるスナップショットファイルが作成されます。

バックアップするファイルのリストは、“Files>>”ボタンを押して変更することができます。こうすると、現在チェックされているファイルがバックアップされるファイルのリストとなります。“<< Files”ボタンを使うと、チェックされているファイルのグループをバックアップ対象のファイルとしてリストすることができます。

バックアッププロファイルに対して行った変更をコミットするには、“Apply”ボタンを押す必要があります。

### ユーザプレファレンスのコンフィグレーション

ユーザプレファレンスを設定するには、“Edit”メニューから“Preferences...”を選択します。設定できるプレファレンスは以下のとおりです。

デフォルトのテープサイズ

  この値は、テープをフォーマットする際にデフォルトのテープサイズとして使われます。

テープブロックサイズ

  テープドライブのハードウェアブロックサイズです。フロッピーテープドライブの場合、この値は10240バイトです。

テープデバイス

  テープデバイスへのフルパス（通常は、/dev/tape)です。このパスは、ノンリワインドバージョンのテープデバイスをポイントするものでなければなりません。

tarコマンド

  システム上での tar コマンドへのフルパスです。

Load tape on mount（搭載時にテープの読込み）

  これがイネーブルされていると、KDat は、テープを搭載する前に、テープドライブに対して“mt load”コマンドを出します。ドライブによっては、テープの読込み・書込み に先だってこの設定が必要です。

Lock tape drive on mount（搭載時にテープドライブをロック）

  これがイネーブルされていると、KDat がテープを搭載すると必ず、テープドライブに対して、取出しボタンをディスエーブルするよう指示が出されます。テープドライブによっては、このオプションが機能しない場合があります。

Eject tape on unmount（テープ取外し時に取出し）

  これがイネーブルされていると、KDat がテープを取り外すと必ず、テープはドライブから自動的に取り出されます。このオプションはフロッピーテープドライブに対しては使わないでください。

Variable block size（可変ブロックサイズ）

  これがイネーブルされていると、KDat は、テープドライブが使っているハードウェアブロックサイズを変更しようとします。可変ブロックサイズをサポートしていないドライブもあります。この機能の使用可否にかかわらす、KDat には、テープドライブが使用するブロックサイズを知らせる必要があります（すなわち、フロッピーテープの場合は 10240）。

### KDatのテープフォーマット

KDat がテープをフォーマットするときは、冒頭に一つのファイルを書きます。このファイルが占めるのは、テープブロック1個だけです。ファイルの内容は、以下のとおりです。

- (9 バイト) リテラル文字列 "KDatMAGIC"

- (4 バイト) ファイルフォーマットのバージョンナンバー (現在は 1)。

- (4 バイト) テープのID文字列の長さ（バイト数）。

- (n バイト) テープの ID 文字列。この文字列のフォーマットは次のとおりです。 "<hostname>:<seconds>"ここで、<hostname> はテープのフォーマットを実行するマシンのフルネームで、 <seconds> は、テープがフォーマットされた時点からの経過秒数です。

テープ ID は、$HOME/.kdat ディレクトリで、同じ名前のファイルを見つけるのに使われます。

Eテープ上の残りの各ファイルは、従来の tar アーカイブです。それらは、GNU tarを使って直接操作できます。非GNUの tar でも非インクリメンタルバックアップに対しては有効です。

## 著作権

KDat

プログラムおよびドキュメンテーション：Copyright 1998 Sean Vyain<svyain@mail.tds.net>

ドキュメンテーションのLinuxdoc フォーマット 6/7/1999 への変換は、David Rugge <davidrugge@mindspring.com>が行いました。

このプログラムは、フリーソフトウェアです。Free Software Foundation が発行しているGNU General Public License のバージョン2以降の条項に基づいて、再配布あるいは変更、またはその両方を（任意に）行うことができます。

このプログラムは、広く役立てられることを希望して配布されているものですが、保証はありません。市販性あるいは特定の目的に対する適合性についての、黙示的保証も含めて何らの保証もされていません。詳細は、GNU General Public License を参照してください。

GNU General Public License は、このプログラムに付属して配布されているはずです。付属していない場合は、Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USAにご連絡ください。