obtarのオプション

obtarのオプションをアルファベット順にリストしたものが、表B-2の各行です。各列は、オプションを指定できるobtarのモードを示しています。

表B-2 obtarのオプション

オプション	-c	-t	-x	-zz
-A	×
-b	×	×	×
-B		×	×
-C	×
-e	×^脚注1	×	×
-E	×^脚注2
-f	×	×	×	×
-F	×	×	×
-G	×	×
-h	×
-H	×		×
-J	×	×	×	×
-k			×
-K	×		×
-l	×		×
-L	×
-m			×
-M	×
-O			×
-P	×
-q		×	×
-R	×	×	×	×
-s			×
-u			×
-U	×
-v	×	×	×
-V
-w	×		×
-Xchkmnttab	×		×
-Xcleara	×
-Xcrossmp	×		×
-Xdepth	×	×	×
-Xfamily	×
-Xhighlatency	×
-Xhome	×		×
-Xincrrestore			×
-Xkv	×
-Xmarkerfiles	×
-Xnice	×	×	×	×
-Xno_mod_chk	×
-Xnochaselinks	×
-Xnostat	×
-Xow	×
-Xupdtu	×
-Xuq	×
-Xuse_ctime	×
-Xverifyarchive	×
-Xwq	×
-Xww	×
-y	×
-Z	×		×

^脚注1-Gも指定されている場合

^脚注2-Gも指定されている場合

-A

アクセス制御リスト（ACL）、コンテキスト依存ファイル（CDF）、およびHP社プラットフォーム（HP-UXオペレーティング・システム）でバックアップされたファイルのその他の拡張ファイルシステム属性を保存しません。デフォルトでは、各ファイルのすべてのファイルシステム属性が保存されます。HP社プラットフォームにこれらのファイルをリストアすると、拡張属性もリストアされます。

その他のプラットフォームでこれらのファイルをリストアすると、ACL情報は無視されます。Windowsプラットフォームの場合、-Aフラグを使用すると、各ファイルに関連付けられたプライマリ・データ・ストリームのみが保存されます。

-b blocking-factor

blocking-factorに512バイトを乗算した値であるブロック・サイズでデータを書き込みます。デフォルトでは、blockingfactorメディア・ポリシーによって指定されたブロッキング・ファクタが使用されます。ファイルをリストアする場合、データのバックアップ時に使用されたブロック・サイズが自動的に設定されます。

-B

読取りを複数回実行してブロックを埋めます。obtarをUNIXのパイプまたはソケットとともに使用している場合、UNIX read関数は、さらにデータを受け取っている場合でもデータのブロックの一部を戻すことがあります。

たとえば、Oracle Secure Backupがインストールされていないホストに接続されているテープ・デバイスからデータをリストアするとします。次のコマンドを実行すると、ホストloganに接続されているテープ・デバイスから/docディレクトリがリストアされます。

rsh logan cat /dev/nrst0 | obtar -x -B -f - /doc

-fオプションを使用してリモート・テープ・デバイスを指定する場合は、-Bを使用する必要はありません。これは、obtarのネットワーク・プロトコルによって全ブロックの読取りおよび書込みが保証されるためです。

-C directory

バックアップするファイルに関連付けられたディレクトリ構造を変更します。このオプションにより、obtarの作業ディレクトリがdirectoryに変更され、このディレクトリからの相対パスを使用して各ファイルがバックアップされます。コマンドラインで次の-Cオプションを実行するまでは、directoryが現行ディレクトリとして使用されます。ファイルをリストアする場合、これらのファイルは、directoryからの相対パスを使用してリストアされます。

-e volume-id

バックアップ時にはこのバックアップ・イメージのボリューム・ラベルのvolume-idを使用し、リストア時にはボリューム・ラベルのvolume-idを検索します。ボリュームIDは、英数字の任意の組合せで31文字まで指定できますが、最後の6文字は数字である必要があります。バックアップ時にボリュームIDを指定しない場合、管理ディレクトリにあるボリューム順序ファイル内のボリュームID（デフォルト）か、-Eオプションで指定したボリュームIDが使用されます。

通常、-eを使用するのは、スクリプトからobtar -xまたはobtar -tを実行する際に、リストアするボリュームが正しいかどうかを検証するためです。obtarは、ボリュームIDとラベルのボリュームIDを突き合せ、これらが一致しない場合には終了します。索引付けまたはリストアを行うデータの元となるテープ・ドライブがテープ・ライブラリに含まれている場合、コマンドラインに-eを指定すると、操作を開始する前に、そのテープ・ドライブへのこのボリュームのロードが試行されます。

-E volume-id-file

ボリューム・ラベルのvolume-id-file内のボリュームIDを使用します。管理サーバー上の管理ディレクトリにあるvolume-id-fileが検索されます。このオプションを指定しない場合、ボリューム順序（デフォルトのボリュームIDファイル）に含まれるボリュームIDが使用されます。

-f device

バックアップ・イメージを作成するテープ・デバイスの名前を指定します。-fのdevice引数は、管理ドメインのテープ・ドライブに割り当てた名前です。

-fオプションを指定しない場合は、TAPE環境変数（定義されている場合）によって指定されたテープ・デバイスが使用されます。

大量のデータをバックアップする場合、obtarは、必要に応じて、あるボリュームから次のボリュームにバックアップ・イメージを引き継がせようとします。テープ・ドライブがテープ・ライブラリ内にある場合、自動的に現行ボリュームがアンロードされ、バックアップを引き継がせるために適した別のボリュームを求めてテープ・ライブラリのインベントリが検索されます。テープ・デバイスがテープ・ライブラリ内にあるとobtarが考えるかどうかは、obtarのインストールおよび構成の方法によって決定されます。

スタンドアロンのテープ・ドライブを使用している場合、ボリュームが終わっても書き込む必要があるデータがまだある場合、テープは巻き戻されてアンロードされます。オペレータ・ホストには次のようなメッセージが表示されます。vol-idは、ボリューム・セット内の次のボリュームを示しています。

End of tape has been reached. Please wait while I rewind and unload the tape. The
Volume ID of the next tape to be written is vol-id.
The tape has been unloaded.

Please insert new tape on device
and press <return> when ready:

バックアップは次のボリュームに引き継がれます。

-F {cur | end | file-number}

ボリュームの現在位置（デフォルト）ではなく、ボリューム・セット内の指定位置で、バックアップ・イメージの書込みまたは読取りを行います。このオプションを使用するのは、テープ・デバイスに対して書込みまたは読取りを行う場合のみです。テープ位置は、ボリューム・セット内の指定ファイルに設定されます。このファイルがロードされていないボリューム上にある場合は、必要なボリュームをロードするように要求されます。

位置をcurと指定すると、ボリュームの現在位置でバックアップ・イメージの書込みまたは読取りが行われます。

endを指定すると、ボリューム・セットの既存の最終バックアップ・イメージの直後に新しいバックアップ・イメージが書き込まれます。

file-numberを指定すると、指定したファイル位置にバックアップ・イメージが書き込まれます。ボリューム・セット上の各バックアップ・イメージには、1から始まる番号が順に付けられます。

注意:

指定したボリューム位置にバックアップ・イメージを作成する場合、ボリュームに他のバックアップ・イメージがすでに含まれていても、バックアップ・イメージが最終バックアップ・イメージになります。たとえば、11のバックアップ・イメージが含まれるボリューム上で位置6にバックアップ・イメージを書き込むと、バックアップ・イメージ7～11は事実上消去されます。obtar -tおよびobtar -xを使用する場合は、このオプションのかわりに-qオプションを使用できます。

-G

バックアップ・イメージのコンテンツの索引をカタログに書き込み、ボリューム・ラベルを生成します。このコンテンツには、ファイルシステム・バックアップまたはRecovery Manager（RMAN）バックアップを指定できます。この情報を使用して、リストアするデータが含まれるバックアップ・イメージが検索されます。

-h

通常、バックアップ対象データにシンボリック・リンクが含まれる場合、リンク・テキストのみがバックアップされ、リンクが指し示すデータはバックアップされません。-hオプションを使用すると、リンク・テキストだけでなくデータもバックアップできます。

obtar -cを使用する際に明示的なリンク・パス名を指定すると、-hオプションの使用に関係なく、そのリンクによって指定されたデータはバックアップされます。明示的に指定されたリンクがたどられないようにするには、-Xnochaselinksを指定します。

-H host

ローカル・ホスト（デフォルト）ではなく、hostに対してデータのバックアップまたはリストアが行われます。

-J

実行時にデバッグ出力を作成します。

-k

存在していないファイルのみがリストアされます。つまり、既存のファイルはバックアップ・イメージ内のバージョンによって上書きされません。デフォルトでは、既存のファイルはすべて上書きされます。

-K mask

デバイス・ドライバのデバッグ・オプションを指定します。maskは、次の表B-3に示す値のビット単位の包含的ORです。

表B-3 maskの値

値	意味
800	オープンする前でのデバッグ・モードの有効化
400	BOTで行う書込みの1回のみの許可
200	書込みエラーの送信
100	カーネル・ドライバのデバッグ
080	タイムアウトの有効化
040	タイムアウトの無効化
020	EOMでのデバッグの有効化
010	早期EOTの発行
008	DMAアクティビティのトレース
004	その他の情報のトレース
002	エラーのトレース
001	ドライバ・コールのトレース

注意:

このオプションを使用すると大量の出力が生成される可能性があるため、通常は、Oracleサポート・サービスによって指示された場合のみ使用してください。

-l

バックアップまたはリストア時に、ファイル・システムのマウント・ポイントの横断を禁止します。

デフォルトでは、バックアップ記述ファイルにマウント・ポイント文を明示的に指定しないかぎり、マウント・ポイントを横断しません。-lを指定すると、この明示的な上書き設定が無視され、マウント・ポイントを横断しません。

-Xchkmnttabも指定する場合、-lを指定すると、リモート・マウント・ポイントを横断しないようにマウント表（/etc/mnttab）が参照されます。

Windows 2000でNTファイル・システム（NTFS）パーティションをバックアップまたはリストアする場合、名前のサロゲートの再解析ポイント（ディレクトリ・ジャンクションなど）がマウント・ポイントとして扱われます。

このオプションを-vオプションとともに使用すると、スキップするファイルの名前が標準エラーに書き込まれます。

-L {full | incr | exincr | offsite | n | date-time}

全体バックアップ（デフォルト）のかわりに指定のバックアップ・レベルを使用します。

fullは、全体バックアップを指定します。この場合、obtar -cコマンドで指定されたすべてのデータが保存されます。

incrは、増分バックアップを指定します。この場合、最終バックアップ以降に変更されたデータのみが保存されます。

exincrは、拡張増分バックアップを指定します。この場合、最終の全体バックアップ以降に変更されたデータのみが保存されます。

offsiteを使用すると、全体および増分バックアップの後続のスケジュールには影響を及ぼさないオンデマンド・バックアップが生成されます。

また、数値バックアップ・レベルnを指定することもできます。これは0～9の数値で、最終バックアップ以降に変更された下位レベルのデータのみが保存されます。バックアップ・レベル0はfullと（全体バックアップ）同じレベルで、レベル1はexincrと同じレベルです。

date-time引数を使用すると、その日時以降に変更されたデータのみが保存されます。date-time引数は後続の増分バックアップの参照ポイントとしては使用できないため、この引数を使用しても正しい増分バックアップは作成されません。date-time引数は、obtarを実行するロケールに適した書式で設定する必要があります。米国の場合、次の書式でdate-timeを指定します。

mm/dd[/yy] [hh[:mm[:ss]]]

hh、hh:mmまたはhh:mm:ssをdate-timeの一部として指定する場合、date-timeを引用符で囲む必要があります。年（/yy）を指定しない場合、直前の12か月が使用されます。hh:mmは指定してもssは指定しない場合、hh:mm:59が使用されます。

-m

バックアップ・イメージに保存されている時間（デフォルト）ではなく現在の時間を、最終変更時間（last time modified）のタイムスタンプとして使用します。

次の例では、/oldディレクトリ内のすべてのディレクトリおよびファイルに対するタイムスタンプが現在の日時に変更されています。

obtar -x -m -f tape0 /old

-M parameter:value

-Mを使用すると、ハードウェア圧縮をサポートしているテープ・デバイスのハードウェア圧縮をオンまたはオフにできます。デフォルトでは、ハードウェア圧縮はオンに設定されます。ハードウェア圧縮を設定する場合、ハードウェア圧縮はオンにするにはonを、ハードウェア圧縮はオフにするにはoffを指定します。

-M compress:{on|off}

ハードウェア圧縮をオンにすると、データの圧縮はリストア時に自動的に解除されます。ハードウェア圧縮は-Zオプションと同時に使用しないでください。

-O

リストアするファイルの初回出現後にリストア操作を終了します。通常、obtar -xでは、リストアする各ファイルの複数のコピーを探してバックアップ・イメージ全体がスキャンされます。-Oを指定すると、すべてのファイルが1回リストアされた後にリストアが停止します。

-P

スパース・ファイルは、決して書き込まれることがない領域があるファイルです。通常、スパース・ファイルの特殊処理は一切行われません。obtar -cを使用してバックアップ・イメージを作成する際に-Pオプションを指定すると、バックアップ・イメージ内のスパース・ファイルはすべて圧縮されます。後でこのバックアップ・イメージをリストアする場合、スパース・ファイルは元の形式でリストアされます。

注意:

Windows 2000では、スパース・ファイルは常にスパース形式でバックアップおよびリストアされるため、このオプションは適用されません。

-q position-string

ブロックへの直接位置指定をサポートするテープ・デバイスを使用している場合、-qオプションを使用するとボリューム上にある特定のデータを高速で探すことができます。-qに対する引数は、obtoolのls --backup --positionコマンドから取得する位置文字列です。-qを使用すると、ボリュームは指定した場所に直接位置指定されます。

たとえば、obtoolのlsコマンドを使用すると、ファイル/home/gms/output/test001の位置を特定できます。

obtool ls --backup --position /home/gms/output/test001

test001
Backup Date & Time ID  Volume ID Volume Tag File Sect  Level Position
2006/01/11.10:16:28 3  VOL000106   00000110   11    0    000045020008

位置データを取得すると、次の例に示すように-qオプションをobtar -tに指定できます。

obtar -t -f tape1 -q 000045020008

-R

rootアクセス権を使用してobtarを実行します。-Rを使用するには、特権ユーザーとしてのリストア実行（perform restores as privileged user）権または特権ユーザーとしてのバックアップ実行（perform backups as privileged user）権を備えたクラスのメンバーである必要があります。rootとしてログインしている場合は、-Rを指定する必要はありません。

-s,prefix,[replacement,]

リストア対象のすべてのパス名でprefixが出現するたびにreplacementで置き換えます。prefixには、元のパス名の最初の部分を含める必要があります。replacementを省略すると、リストアするすべてのパス名に出現するprefixがすべて削除されます。カンマ（,）のかわりにデリミタとして使用できる文字は、prefixまたはreplacement文字列のどちらにも含まれていない文字です。このオプションを使用すると、バックアップ・イメージからファイルを抽出し、ファイルのバックアップ元の場所とは異なる場所に配置できます。

-u

ファイルをリストアする際に、明示的に指定されないかぎり既存のファイルは上書きされます。ファイルのロックをサポートするシステムでは、現在使用中のファイルに対してでさえ、このような既存ファイルの置換が発生します。現在使用中のファイルを上書きしないようにするには、obtarコマンドラインに-uを指定します。

-U

管理ディレクトリにあるバックアップ日付ファイルを更新します。このオプションは、autohistory操作ポリシーの設定に優先します。

-v

ファイルに関する詳細情報を標準出力または標準エラーに書き込みます。

このオプションをobtar -cとともに使用すると、バックアップするファイルの名前およびボリューム・ラベル（作成されている場合）が標準エラーに書き込まれます。

このオプションをobtar -tとともに使用すると、ファイル名のみ（デフォルト）でなく、ファイルに関する追加情報が、標準出力に書き込まれます。この追加情報は、ls -lコマンドの出力と似ています。

このオプションをobtar -xとともに使用すると、リストアするファイルの名前が標準出力に書き込まれます。-vvを指定すると、ファイルに関する追加情報が標準エラー（obtar -c）または標準出力（obtar -x）に書き込まれます。この追加情報は、ls -lコマンドの出力と似ています。

注意:

-vオプションによってレポートされるユーザーID（UID）またはグループID（GID）は、ファイルの実際のUIDまたはGIDと一致しない場合があります。UIDおよびGIDの最大値は、POSIX標準によって定義されます（拡張tar形式）。バックアップ操作中に、tarヘッダー内に収まる最大値（2097151）を超えるUIDまたはGIDのファイルが見つかった場合、UIDまたはGIDは切り捨てられ、警告が表示されます。このような警告の存在は、バックアップの終了ステータスに反映されます。

-V

obtarのバージョンを出力し、終了します。

-w

ファイルをバックアップまたはリストアする前にアドバイザ・ファイルのロックをチェックして受け入れます。ロックが設定されている場合、警告メッセージが表示され、ファイルはスキップされます。

-Xchkmnttab

stat(2)操作を実行する前にローカルのマウント表（/etc/mnttab）を参照し、リモート・マウント・ポイントだと判明したディレクトリをスキップします。ローカル・マウント・ポイントはスキップされません。このオプションが適用されるのはLinuxおよびUNIXのみです。

-Xchkmnttabオプションにより、停止しているかまたは応答がないリモート・ホストが原因となるハングを回避できます。-Xchkmnttabオプションは、-Xcrossmpによって無効にされます。

関連項目:

backupoptions操作ポリシーに-Xchkmnttabオプションを指定する手順は、「backupoptions」を参照してください。

-Xcleara

正常にバックアップされた各ファイルのアーカイブ・ファイル属性ビットを消去します。このオプションを使用しない場合、アーカイブ・ファイル・ビットは変更されないまま残ります。このオプションが適用されるのはWindowsのみです。

-Xcrossmp

-lまたは-Xchkmnttabオプションの指定の有無を問わず、すべてのマウント・ポイントを横断します。デフォルトでは、マウント・ポイントを横断しません。

-Xcrossmpオプションは、backupoptions操作ポリシーに指定できます。

-Xdepth:levs

表示する索引レベルの最大数を指定します。

-Xfamily[:family]

ラベルを付けるボリュームがメディア・ファミリfamilyに属すことを指定します。

-Xhighlatency

再解析ポイントが指し示すデータをフェッチします。通常、再解析ポイントで待機時間が長いと、再解析ポイントはバックアップされますが、再解析ポイントが指し示すデータはバックアップされません。このオプションが適用されるのはWindowsのみです。

-Xhome:dir

バックアップを開始する前にクライアント・ホスト上のホーム・ディレクトリをdirに設定します。

-Xincrrestore

ネットワーク接続ストレージ（NAS）デバイスに対して増分ネットワーク・データ管理プロトコル（NDMP）リストアを実行します。

-Xkv:time_spec

ボリュームの保存時間を指定します。time_specは、disabled（保存時間なし）、foreverまたはn tuです。n tuの場合、tuは、secs（秒）、mins（分）、hrs（時間）、days（日）、wks（週）、mos（月）またはyrs（年）のいずれかです。このオプションが有効なのは、ボリュームの最初のファイルに書き込む場合のみです。

-Xmarkerfiles

バックアップ時に見つかった索引マーカー・ファイルを受け入れます。現在、定義されている索引マーカー・ファイルは.ob_no_backupのみです。EXmarkerfilesを指定した場合、この名前のファイルがディレクトリにあると、このディレクトリまたはそのサブディレクトリはバックアップされません。

-Xnice:val

バックアップまたはリストア・プロセスのnice(1)値をvalに設定します。この値は、リクエストされた操作を実行するためにobtarによって生成されたローカルおよびリモート・サブプロセスに伝播されます。

-Xno_mod_chk

ファイルのバックアップ時に変更チェックを省略します。通常は、ファイルがバックアップされた後で、バックアップ中にファイルが変更されたかどうかがチェックされます。ファイルが変更されていた場合は、警告メッセージが出力されます。このオプションを設定すると、パフォーマンスが向上します。

-Xnochaselinks

リンクがコマンドラインに明示的に指定されていても、リンクをたどらないようにします。

-Xnostat

ファイルの状態データ（所有権、権限、サイズ）を索引ファイルに含めません。デフォルトでは、このデータは索引ファイルに書き込まれ、後でカタログにインポートされます。

-Xow

ボリューム・ラベルの有効期限を無視します。有効期限がまだ切れていないボリュームを上書きしようとする場合は、-Xowを指定しないかぎり、操作が失敗します。

-Xupdtu

ファイルをバックアップした後にファイルのアクセス時間をリセットしません。通常、ファイルがバックアップされた後、ファイルのアクセス時間（atime）は、バックアップ開始前のアクセス時間にリセットされます。ファイルをバックアップしても元のatimeは変更されません。バックアップでファイルのatimesが変更されてもかまわない場合、このオプションを指定すると、バックアップのパフォーマンスが若干向上します。

-Xuq:n

utimeヘルパーのキューのサイズを指定します。データのバックアップ時には、ヘルパー・プロセスを使用してutime(2)コールが実行され、バックアップするファイルのアクセス時間がリセットされます。このパラメータにより、utimeヘルパーの入力キューのサイズを制御します。このオプションが適用されるのはLinuxおよびUNIXのみです。

-Xuse_ctime

増分バックアップの実行時に、バックアップに含めるファイルの基準としてmtimes（変更時間）ではなくctimes（inode変更時間）を使用します。このオプションを使用することは-Xupdtuも使用することを意味します。

-Xverifyarchive

バックアップ・セクションの完了時にテープをセクションの先頭に巻き戻し、コンテンツを読み取ります。

-Xwq:n

未完了のリモート書込みの最大数を指定します。このパラメータにより、このキュー内の書込みの数を制御します。このオプションが適用されるのはLinuxおよびUNIXのメディア・サーバー・ホストのみです。

-Xww:time_spec

ボリュームの書込みウィンドウの有効期限を指定します。time_specは、-Xkvオプションの場合と同じように指定します。入力した時間指定がボリュームの作成時間に加算され、ボリュームに対する追加書込みの有効期限が決定されます。このオプションが有効なのは、ボリュームの最初のファイルに書き込む場合のみです。

-y status-file

バックアップ・セッションに関するステータス情報をstatus-fileに書き込みます。これらの統計は、retainbackupmetricsポリシーを設定することで、メディア・サーバーのobservicedログ・ファイルに保存できます。