<book_title> を検索 ...

Veritas™ File System プログラマーズリファレンスガイド - Linux

Last Published: 2018-01-16

Product(s): InfoScale & Storage Foundation (7.3.1)

シン再生のアプリケーションプログラミングインターフェース

シン再生を次の API で使用できます。

uint vxfs_ts_reclaim(char *mountpoint, uint64_t offset,
uint64_t length, int32_t volindex, uint64_t unit_size,
uint64_t *bytes_reclaimed, uint32_t flag)

これは非再入可能な API です。fsadm コマンドのインスタンスまたはファイルシステムの再編成が実行されているときは、API を呼び出せません。

mountpoint	Veritas Volume Manager（VxVM）ボリュームにマウントされた VxFS ファイルシステムのパス名。
offset	再生を開始する、ボリューム内でのバイト単位のオフセット。
length	空きストレージを再生する、offset からのバイト単位の長さ。
volindex	ボリュームセット内のボリュームのインデックス。volindex が値 -1 を持つときは、ファイルシステム内のすべてのボリュームが、offset および length を無視します。非マルチボリュームファイルシステムでは、volindex は 0 にしてください。
unit_size	ファイルシステムが再生要求を VxVM に発行する、倍数のサイズ。各シンプロビジョニングアレイはユニットサイズの要因によって再生をサポートします。
bytes_reclaimed	ファイルシステムが再生しようとするバイト数を返します。その値は実際に再生されたバイト数を示していません。
flag	flag に有効な値は、次のとおりです。 `VXFS_RCLMINTENT_SSDTRIM` - 下位 SSD ボリュームで TRIM コマンドを開始します。ボリュームセットの場合、このコマンドは SSD ボリュームに対してのみ有効です。 `VXFS_RCLMINTENT_THINRCLM` - シン再生ボリュームでシン再生を開始します。ボリュームセットの場合、このコマンドはシン再生ボリュームに対してのみ有効です。 `VXFS_TS_RECLAIM_AGGRESSIVE` - 空き領域の再生を最大化するため、追加のデータと追加のメタデータによる再編成を実行します。この処理によって、下位のシンストレージからの追加領域の割り当てがトリガされる場合がありますが、この領域の割り当ては処理の終了とともに解除されます。この処理によって、既存の大規模な領域が断片化する可能性があります。積極的な再生は、VxVM によってボリュームが `thinrclm` としてレポートされた場合にのみ実行されます。マルチボリュームファイルシステムでは、VxVM によって `thinrclm` としてレポートされたボリュームのみが考慮されます。 volindex 引数の値が -1 の場合、ファイルシステム全体が対象になります。offset 引数と length 引数は無視されます。volindex 引数に値を指定したときに offset 引数と length 引数の両方の値が 0 である場合は、ボリューム全体が対象になります。offset 引数と length 引数に値を指定した場合は、vxfs_ts_reclaim() によって積極的な再生が実行されることはなく、volindex 引数の値の指定にかかわらず、デフォルトの再生が実行されます。 `VXFS_TS_RECLAIM_ANALYSE \| VXFS_TS_RECLAIM_ANALYZE` - ファイルシステムの分析を実行し、通常の再生と積極的な再生のどちらを使う必要があるかを推奨します。推奨に関係なく、どちらかの再生ポリシーを使うことができます。分析再生は、Veritas Volume Manager（VxVM）によってボリュームが `thinrclm` としてレポートされた場合にのみ実行されます。 MVS ファイルシステムの場合、vxfs_ts_reclaim() API は、VxVM が `thinrclm` としてレポートしたボリュームのみを考慮します。 `VXFS_TS_RECLAIM_AUTO` - ファイルシステムの分析を実行し、分析に基づいて、この時点でどちらの再生ポリシーが適しているかを判断し、ユーザーの代わりにポリシーを実行します。自動再生は、VxVM によってボリュームが `thinrclm` としてレポートされた場合にのみ実行されます。 MVS ファイルシステムの場合、vxfs_ts_reclaim() API は、VxVM が `thinrclm` としてレポートしたボリュームのみを考慮します。

VxFS は調整のため内部で offset および length を揃えることがあります。

メモ:

シン再生は遅いプロセスで、ファイルシステムのサイズによっては完了までに数時間を要することがあります。シン再生によって 100% の空き領域の再生が保証されるわけではありません。