日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.3-RELEASE-K, 13.0-RELEASE-K から 13.2-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
DUMP(8) FreeBSD システム管理者マニュアル DUMP(8)
名称
dump, rdump -- ファイルシステムのバックアップ
書式
dump [-0123456789acLnrRSu] [-B records] [-b blocksize] [-C cachesize]
[-D dumpdates] [-d density] [-f file | -P pipecommand] [-h level]
[-s feet] [-T date] filesystem
dump -W | -w
解説
dump ユーティリティは、ファイルシステムを調べてバックアップする必要のある
ファイルを決定します。これらのファイルは、指定されたディスク、テープや、
その他の記憶メディアへ保存のためコピーされます (リモートバックアップにつ
いては、-f オプションを参照)。ダンプの大きさが記録メディアの容量より大き
い場合は、複数ボリュームに分割します。たいていのメディアの容量は、メディ
アの終りを通知されるまで書き込んでみることで決定します。この方法は、-a オ
プションにより強制的に使用することもできます。
メディアの終りを正しく通知できないメディア (一部のカートリッジ・テープド
ライブ等) の容量は、テープ長と記録密度や -B オプションから求め、各ボ
リュームは、すべて同じ容量を持つものとします。デフォルトでは、オペレータ
にメディア交換を要求した後の各ボリュームにも同じ出力ファイル名を使用しま
す。
ダンプ対象のファイルシステムは、引数 filesystem にて、デバイス特殊ファイ
ルか (/etc/fstab 中の標準エントリの場合) マウントポイントで指定します。
また、dump は、rdump として起動されます。4.3BSD オプションの構文は、後方
互換性のために実装されていますが、ここで文書化されていません。
次のオプションが dump によってサポートされています:
-0-9 ダンプレベル。レベル 0 は、フルバックアップを意味し、ファイルシス
テム全体をコピーすることを保証します (ただし以下の -h オプション
にも注意して下さい)。0 より大きなレベル番号は、インクリメンタル
バックアップを意味し、前回のダンプ (今回指定したものより低いレベ
ルのダンプ) 以降に作られたか修正されたすべてのファイルをコピーし
ます。デフォルトのレベルは、0 です。
-a ``オートサイズ'' 全てのテープ長の考慮をせず、メディアの終了を通知
されるまで、強制的に書き込みを続けます。現在のほとんどのテープド
ライブでは、この方法によりもっとも良い結果が得られます。特に、使
いかけのテープに追加したり、ハードウェア圧縮機能のあるテープドラ
イブ (圧縮率がどの程度になるか不確かなもの) を使用したりする場合
にこのオプションを使用することをお薦めします。
-B records
ボリュームあたりのキロバイト数です。この値が出力ブロックサイズの
整数倍でない場合、コマンドは、この値より小さい整数倍値を使用しま
す。このオプションは、テープ長と記録密度を基にしたテープ容量より
優先されます。
-b blocksize
出力ブロックあたりのキロバイト数です。
-C cachesize
キャッシュサイズをメガバイト単位で指定します。性能が劇的に向上し
ますが、パス間のファイルシステムへの変更に dump が気付かない可能
性があります。スナップショットダンプ時には、本オプションを常に使
用することをお勧めします。dump は、フォークしますので、実際に使用
されるメモリ量は、キャッシュサイズより大きいかもしれないことに注
意してください。推奨キャッシュサイズは、8 から 32 (メガバイト) の
間です。
-c カートリッジテープドライブ用に、記録密度とテープ長のデフォルトを
それぞれ 8000 bpi、1700 feet に変更します。
-D dumpdates
dumpdates ファイルの代替パスを指定します。デフォルトは、
/etc/dumpdates です。
-d density
テープの記録密度を density に設定します。デフォルトは、1600BPI で
す。
-f file
バックアップの出力先ファイル file を指定します。出力先ファイル
file としては、/dev/sa0 (テープドライブ) や /dev/fd1 (フロッピ
ディスクドライブ) のようなデバイスファイル、通常ファイル、`-' (標
準出力) を指定することができます。複数のファイル名を、コンマで区
切って一つの引数として指定することができます。各ファイルは、リス
トされた順に一つのダンプボリュームに使用されます。指定した名前の
数より多くのボリュームが必要な場合、メディアの交換を要求した後、
最後のファイル名を残りのすべてのボリュームに使用します。ファイル
名が、``host:file'' または、``user@host:file'' の形式である場合、
dump は、rmt(8) を使用してリモートホスト上の指定されたファイルに
書き込みます。リモートの rmt(8) のデフォルトのパス名は、/etc/rmt
ですが、環境変数 RMT の値が優先されます。
-P pipecommand
pipecommand で定義された sh(1) スクリプト文字列を各ボリュームの出
力デバイスに対して実行するために popen(3) を使います。この子のパ
イプラインの標準入力 (/dev/fd/0) は、dump の出力ストリームからリ
ダイレクトされ、環境変数 DUMP_VOLUME には現在書き込んでいるボ
リューム番号が設定されます。各ボリュームを書き込んだ後で、パイプ
の書き手側がクローズされ、pipecommand が再び実行されます。-B でメ
ディアの大きさが指定されていれば、出力がテープドライブであるかの
ように、各ボリュームを上記のように書き込みます。
-h level
ダンプレベルが level 以上の時に、ユーザが指定した ``nodump'' フラ
グ (UF_NODUMP) に従います (h: honor the flag)。デフォルトの honor
レベルは、1 ですから、そのようなファイルは、インクリメンタルダン
プからは省かれますが、フルバックアップには含まれます。
-L ライブファイルシステムをダンプ中であることを dump に通知します。
一貫性のあるダンプイメージを得るために、ダンプ対象のファイルシス
テムのルートの .snap ディレクトリに、dump は、ファイルシステムの
スナップショットを取り、それからスナップショットをダンプします。
スナップショットは、ダンプが開始されるすぐにアンリンクされます、
したがって、ダンプが完了したときに削除されます。アンマウントされ
たファイルシステムや読み込み専用のファイルシステムに対しては、こ
のオプションは、無視されます。ダンプ対象のファイルシステムのルー
トに .snap ディレクトリが存在しない場合、警告が出て dump は、標準
の動作に戻ります。この問題は、ダンプ対象のファイルシステムのルー
トに .snap ディレクトリを作成することで、解決可能です。このディレ
クトリの所有者は、``root'' で、グループは、``operator'' で、モー
ドは、``0770'' であるべきです。
-n dump がオペレータに注意を促す時に、wall(1) に似た方法で
``operator'' グループに属するすべてのユーザにメッセージを送りま
す。
-r rsync フレンドリにします。通常、ダンプは、ダンプを通して、現在と
前のダンプの日付を多数の場所に格納します。これらの点在している変
更は、日付が各ダンプ毎にで変化するので、それらがレベル 0 のリモー
トコピーを更新するために使用されるとき、rsync または別のインクリ
メンタル (増加) ファイル転送プログラムをかなり遅くします。このオ
プションは、ダンプファイルを転送するとき、rsync がはるかに効率的
であることを許可して、エポックへの両方の日付を設定します。
-R さらに rsync フレンドリにします。このオプションは、実際の inode
アクセス時刻の格納を無効にします (代わりに inode の更新時刻を格納
します)。このオプションは、それらのアクセスタイム以外に変化しない
多数のファイルでファイルシステムから生成されるダンプの転送のと
き、rsync をさらに効率的にすることができます。-R オプションは、-r
も設定します。
-S バックアップの大きさと必要なテープ数の見積もりを表示し、実際のダ
ンプを実行せずに終了します。
-s feet
テープの容量を計算する時に記録密度とともに使います。この容量を超
えた場合に、dump は、新しいテープを要求します。このオプションは、
やや控え目に指定することをお勧めします。デフォルトのテープの長さ
は、2300 フィートです。
-T date
dumpdates ファイルを調べて決定される時間の代わりに、ダンプの開始
時間として指定された date を使用します。date の形式は、ctime(3)
のそれと同じです。このオプションは、期間を指定してバックアップを
取るダンプスクリプトで有用です。-T オプションは、-u オプションと
同時には指定できません。
-u ダンプが成功した後で、dumpdates ファイルを更新します。dumpdates
ファイルは、人が読めるファイルであり、各行に以下のレコードがフ
リーフォーマットで記録されています: ファイルシステム名、インクリ
メントレベル、ctime(3) 形式のダンプ日付。各レベルとファイルシステ
ムごとにエントリが一つだけ存在します。必要なら、dumpdates ファイ
ルの各フィールドを編集しても構いません。dumpdates ファイルのデ
フォルトは、/etc/dumpdates ですが、-D を使用してこれを変更可能で
す。
-W ダンプの必要があるファイルシステムをオペレータに表示します。この
情報は、dumpdates ファイルと /etc/fstab ファイルから集められま
す。-W オプションを指定すると、dump は、dumpdates ファイルの中の
各ファイルシステム毎に最新のダンプ日付とレベルを示し、ダンプする
べきファイルシステムを明らかにします。-W オプションが指定された場
合、その他のすべてのオプションは、無視され、dump は、直ちに終了し
ます。
-w -W と同様ですが、ダンプの必要のあるファイルシステムのみを表示しま
す。
``nodump'' フラグ (UF_NODUMP) が設定されたディレクトリおよび通常ファイル
と、そのようなディレクトリ配下のすべては、省略されます。-h オプションに従
います。
dump ユーティリティは、以下に示す場合にオペレータの介入を要求します: テー
プの終了、ダンプの終了、テープ書き込みエラー、テープオープンエラー、ディ
スク読み込みエラー (32 回を越えた場合)。処理を続けられない時や何か大変ま
ずい事態になった場合には、dump は、-n オプションがあればすべてのオペレー
タへ警告したうえで、dump の制御端末上でオペレータとやりとりします。dump
コマンドからのすべての質問には、``yes'' または ``no'' で適切に答えなけれ
ばなりません。
フルダンプの実施には多くの時間と労力がかかるので、dump は、各テープボ
リュームの先頭にチェックポイントを設定します。何らかの理由により、あるボ
リュームの書き込みを失敗した場合には、テープの巻き戻し、排出、新しいテー
プのマウントの後で、dump は、オペレータの許可の下でチェックポイントから実
行を再開します。
dump ユーティリティは、処理の進行を (5 分毎または SIGINFO 受信時に) 定期
的にオペレータに報告します。報告には、少なめに推定される書き込みブロック
数、必要なテープ数、完了までの時間、テープ交換までの時間、を含みます。
dump に使っている端末が使用中であることが他人にも分かるように、このメッ
セージは、冗長になっています。
ディスクに壊滅的なトラブルが起きた時に、バックアップテープやファイルから
ディスクを復元するために必要な時間は、インクリメンタルダンプを適当なシー
ケンスで実行する事によって最小にする事ができます。最小のテープ数でこれを
行なう効果的な方法を示します。
• 常にレベル 0 のバックアップから開始します。例えば以下の通りで
す。
/sbin/dump -0u -f /dev/nsa0 /usr/src
これを一ヵ月か二ヵ月毎に新しいテープに対して実施し、ずっと保存
します。
• 0 レベルのダンプの後は、アクティブなファイルシステム (データが
更新されるファイルシステムです。パーティションレイアウトによっ
ては、データが更新されないファイルシステムもあります) のダンプ
を、修正ハノイの塔アルゴリズムによる次の様なダンプレベルシーケ
ンスによって、毎日行います。
3 2 5 4 7 6 9 8 9 9 ...
毎日のダンプには、一週間毎に繰り返し使われる事になる一定の数の
テープを使う事ができます。週毎にレベル 1 ダンプを行ない、毎日の
ハノイ・シーケンスは、レベル 3 から開始します。週毎のダンプに
は、ダンプするファイルシステム毎に、これも繰り返し使われる事に
なる一定数のテープを使います。
何ヵ月かの後、毎日と毎週のテープは、ダンプサイクルから順に外し、新品の
テープを導入すべきです。
環境変数
TAPE -f オプションが使用されないなら、ダンプするための file またはデバイ
ス。
RMT リモートの rmt(8) プログラムのパス名。
RSH rsh(1) でない場合のリモートシェルプログラムのパス名。
関連ファイル
/dev/sa0 デフォルトのダンプテープユニット
/etc/dumpdates ダンプの日付を記録するファイル (これは、変更可能です。-D
オプションを参照してください)
/etc/fstab ダンプテーブル: ファイルシステムと頻度を決めるファイル
/etc/group operator グループを検索する
終了ステータス
正常時は、終了コード 0 で終了します。開始時のエラーは、終了コード 1 で、
異常終了は、終了コード 3 で表されます。
使用例
growisofs を使用して /u ファイルシステムを DVD にダンプします。16MB の
キャッシュを使用して、ダンプのスナップショットを作成して、dumpdates ファ
イルを記録します。
/sbin/dump -0u -L -C16 -B4589840 -P 'growisofs -Z /dev/cd0=/dev/fd/0' /u
診断
詳しいメッセージがたくさん出ます。
関連項目
chflags(1), fstab(5), restore(8), rmt(8)
歴史
dump ユーティリティは、Version 4 AT&T UNIX で登場しました。
バグ
32 個未満のファイルシステムからの読み取りエラーは、無視されますが、すべて
のエラーは、警告メッセージを生成します。これは、ちょっとした妥協です。現
実には、マウント中のパーティションをダンプするとき、dump 実行中にファイル
システムが更新されると、読み取りエラーが生じ得ます。ダンプは、しばしば
cron(8) を使って人が居ない状況で行われますので、オペレータの介入を要する
仕事は、dump を駄目にしてしまいます。この種の読み取りエラー発生時には書き
込まれたダンプテープには何も悪いところはありませんので、dump を止める理由
はなにもありません。
各リール (ボリューム) ごとに新たなプロセスが作られ、リールを書き終った親
プロセスは、テープ全体の書き込みが終るまで待っています。
dump ユーティリティの -W や -w オプションは、/etc/fstab にリストされてい
ても、dumpdates ファイルに記録のないファイルシステムについては報告しませ
ん。
dump コマンドが、ダンプシーケンスについて知っていて、使い散らかしたテープ
の使用履歴を管理でき、どのテープをマウントすれば良いかオペレータに教えて
くれ、restore(8) を実行するオペレータをもっと助けてくれたら、もっと使いや
すいでしょうね。
セキュリティ的な歴史により、dump ユーティリティは、root 以外のユーザでリ
モートバックアップを行うことはできません。これは、FreeBSD の今後のバー
ジョンでは修正されるでしょう。現状では、(従来通り) setuid されていれば正
常に動作しますが、セキュリティ的なリスクを伴います。
FreeBSD 11.2 October 3, 2016 FreeBSD 11.2