タグ付け用のOracle ACFSコマンドライン・ツール

このトピックでは、Oracle ACFSタグ付けコマンドの概要を示します。

表16-25に、Oracle ACFSタグ付けコマンドと簡単な説明を示します。

Solarisでは、acfsutil tagコマンドはシンボリック・リンク・ファイルでタグ名を設定できますが、バックアップおよびリストア・ユーティリティは、シンボリック・リンク・ファイルで明示的に設定されるタグ名を保存しません。また、シンボリック・リンク・ファイルは、移動、コピー、tarの使用またはpaxの使用が行われると、明示的に設定されたタグ名が失われます。

表16-25 Oracle ACFSタグ付け用のコマンドの概要

コマンド	説明
acfsutil tag info	Oracle ACFSファイルシステムのディレクトリまたはファイルのタグを表示します。
acfsutil tag set	Oracle ACFSファイルシステムのディレクトリまたはファイルにタグを追加します。
acfsutil tag unset	Oracle ACFSファイルシステムのディレクトリまたはファイルからタグまたはすべてのタグ名を削除します。

acfsutil tag info

目的

Oracle ACFSファイルシステムのタグ付けされたディレクトリまたはファイルのタグ名を表示します。

構文および説明

acfsutil tag info -h
acfsutil tag info [-r] [-c -t tagname] path [path ...]
acfsutil tag info [-c -t tagname]

acfsutil tag info -hは、ヘルプ・テキストを表示して終了します。

表16-26に、acfsutil tag infoコマンドで使用可能なオプションを示します。

表16-26 acfsutil tag infoコマンドのオプション

オプション	説明
`-t` `tagname`	表示するタグ名の文字列を指定します。文字列に空白文字が含まれる場合は引用符で囲みます。
`path`	1つまたは複数のファイルまたはディレクトリへのパス名を指定します。
`-r`	指定したパスでの再帰的アクションを指定します。
`-c`	タグ名での大/小文字区別なしの部分一致を指定します。

acfsutil tag infoコマンドは、指定したディレクトリ・パス名に-rオプションが含まれている場合に、すべての子ファイルおよびサブディレクトリに再帰的に操作を適用できます。

パス名を指定しないと、acfsutil tag infoコマンドはすべてのOracle ACFSマウント・ポイントでタグ付けされたファイルを検索します。

Oracle ACFSファイルシステムのタグ付けされたファイルのパスのみが表示されます。-t tagnameオプションを指定すると、指定したtagnameと完全に一致するタグ名を含むファイルのパスのみが表示されます。-cオプションを指定すると、tagnameは、正常に一致する大/小文字区別なしのタグ名のサブストリングを指定できます。たとえば、acfsutil tag info -c -t AGコマンドは、tag1、ag、AGなどのタグ名を含むファイルのパス名を表示します。

どのユーザーもこのコマンドを使用して、読取りアクセス権のあるディレクトリのタグ情報を表示できます。

セキュリティ・レルムで保護されたファイルまたはディレクトリで、acfsutil tag infoを実行すると失敗します。ユーザーがセキュリティ・レルムで保護されたディレクトリでacfsutil tag infoを-rオプションとともに実行し、そのユーザーにディレクトリの参照権限がない場合、出力は表示されません。この問題を解決するには、ユーザーをセキュリティ・レルムに追加し、ユーザーにREADDIR権限を付与する必要があります。Oracle ACFSセキュリティ・レルムへのオブジェクトの追加の詳細は、「acfsutil sec realm add」を参照してください。

例

次に、acfsutil tag infoコマンドの使用例を示します。

例16-23 acfsutil tag infoコマンドの使用方法

$ /sbin/acfsutil tag info -r /acfsmounts/acfs1/myrepfiles/

acfsutil tag set

目的

Oracle ACFSファイルシステムの指定したファイルまたはディレクトリに特定のタグを追加します。

構文および説明

acfsutil tag set -h
acfsutil tag set [-v] [-r] tagname path [path ...]

acfsutil tag set -hは、ヘルプ・テキストを表示して終了します。

表16-27に、acfsutil tag setコマンドで使用可能なオプションを示します。

表16-27 acfsutil tag setコマンドのオプション

オプション	説明
`tagname`	タグ名の文字列を指定します。文字列に空白文字が含まれる場合は引用符で囲みます。タグ文字列は、a-b、A-Z、0-9、空白文字、ハイフンおよびアンダースコアを含むASCII文字で構成されます。タグ名の長さは最大32文字です。 `all`は予約タグ名で、ファイルまたはディレクトリでは設定できません。
`path`	1つまたは複数のファイルまたはディレクトリへのパス文字列を指定します。
`-r`	指定したパスでの再帰的アクションを指定します。
`-v`	操作の進行状況を表示します。

このコマンドは、指定したディレクトリ・パス名のすべての子ファイルおよびサブディレクトリに再帰的に操作を適用できます。

ファイルまたはディレクトリにタグ名を追加する場合、そのファイルまたはディレクトリの既存のタグは変更されません。ディレクトリにタグが割り当てられた後で作成された新しいファイルは、親ディレクトリからタグを暗黙的に継承します。ディレクトリ内の既存のファイルは新しいタグを継承しません。これらのファイルには明示的にタグを割り当てる必要があります。ファイルの名前変更または同じファイルシステム内でのファイルのサブディレクトリへの移動を行うと、そのファイルでは新しい親ディレクトリからタグ名が継承されません。ファイルシステム間のファイルの移動でコピー操作を使用して、新しく作成されたファイルは親ディレクトリのタグ名を継承しません。

Oracle ACFSファイルシステムまたは各ファイルおよびディレクトリのタグ名の固定した最大数はありません。ただし、タグ名の数は、各ファイルおよびディレクトリの64KBまでの特別なメタデータ・ストレージに格納できるタグ名に制限されます。このメタデータには、拡張属性を管理するための情報も含まれています。タグ名を長くすると、ファイルまたはディレクトリで設定できるタグ名の合計が減少します。たとえば、すべてのタグ名が4バイトの長さである場合、拡張属性の情報が他に存在しないと想定すると、約1730のタグ名を保持できます。

ターゲット・ファイルまたはディレクトリを変更する権限のあるユーザーはこのコマンドを実行できます。

ユーザーがセキュリティ・レルムで保護されたディレクトリでacfsutil tag setを-rオプションとともに実行し、そのディレクトリの参照権限がない場合、タグは適用されません。この問題を解決するには、ユーザーをセキュリティ・レルムに追加し、ユーザーにREADDIR権限を付与する必要があります。Oracle ACFSセキュリティ・レルムへのオブジェクトの追加の詳細は、「acfsutil sec realm add」を参照してください。

例

次に、acfsutil tag setコマンドの使用例を示します。

例16-24 acfsutil tag setコマンドの使用方法

$ /sbin/acfsutil tag set repl_grp1 -r /acfsmounts/acfs1/myrepfiles/*.dat

acfsutil tag unset

目的

指定したファイルまたはディレクトリから特定のタグ名またはすべてのタグ名を削除します。

構文および説明

acfsutil tag unset -h
acfsutil tag unset [-v] [-r] {all | tagname} path [path ...]

acfsutil tag unset -hは、ヘルプ・テキストを表示して終了します。

表16-28に、acfsutil tag unsetコマンドで使用可能なオプションを示します。

表16-28 acfsutil tag unsetコマンドのオプション

オプション	説明
`all`	パス文字列のすべてのタグの削除を指定します。
`tagname`	タグ名の文字列を指定します。文字列に空白文字が含まれる場合は引用符で囲みます。
`path`	1つまたは複数のファイルまたはディレクトリへのパス文字列を指定します。
`-r`	指定したパスでの再帰的アクションを指定します。
`-v`	操作の進行状況を表示します。

このコマンドは、指定したディレクトリ・パス名のすべての子ファイルおよびサブディレクトリに再帰的に操作を適用できます。

ファイルまたはディレクトリからタグ名を削除する場合、そのファイルまたはディレクトリの既存のタグは変更されません。

ターゲット・ファイルまたはディレクトリを変更する権限のあるユーザーはこのコマンドを実行できます。

ユーザーがセキュリティ・レルムで保護されたディレクトリでacfsutil tag unsetを-rオプションとともに実行し、そのディレクトリの参照権限がない場合、タグは削除されません。この問題を解決するには、ユーザーをセキュリティ・レルムに追加し、ユーザーにREADDIR権限を付与する必要があります。Oracle ACFSセキュリティ・レルムへのオブジェクトの追加の詳細は、「acfsutil sec realm add」を参照してください。

例

次に、acfsutil tag unsetコマンドの使用例を示します。

例16-25 acfsutil tag unsetコマンドの使用方法

$ /sbin/acfsutil tag unset repl_grp1 -r
     /acfsmounts/acfs1/myrepfiles/*.log