perfstat_logicalvolume サブルーチン

オンライン編集

目的

論理ボリューム関連のメトリックを取得します

ライブラリー

Perfstat ライブラリlibperfstat.a)

構文

#include <libperfstat.h>
int perfstat_logicalvolume (name, userbuff, sizeof_struct, desired_number)
perfstat_id_t * name;
perfstat_logicalvolume_t * userbuff;
int sizeof_userbuff;
int desired_number;

説明

perfstat_logicalvolumeサブルーチンは、1 つ以上の論理ボリュームの統計情報を取得します。 また、利用可能な論理ボリュームの数を取得するためにも使用できる。

1つ以上の論理ボリューム・メトリクスのセットを取得するには、nameパラメータに統計を収集する最初の論理ボリュームの名前を設定し、difired_numberパラメータを設定します。 最初の論理ボリュームから開始するには、引用符 ("") を指定します。 または FIRST_LOGICALVOLUME を名前として使用します。 userbuffパラメータは常に、このサブルーチンがコピーするperfstat_logicalvolume_t構造体の数を含むのに十分な大きさのメモリ領域を指していなければならない。 リターン時に、nameパラメータは次の論理ボリューム名に設定されるか、すべての構造体がコピーされた後に'“”に設定される。

論理ボリューム・メトリッ クの利用可能なセットの数を取得するには、name パラメータとuserbuffパラメータを NULL 値に設定し、distired_numberパラメータを 0 値に設定します。 戻り値は、使用可能な論理ボリュームの数です。

メモ:論理ボリュームの統計情報収集を有効にするには、perfstat_configを呼び出す必要があります。 perfstat_logicalvolumeサブルーチンはワークロードパーティション内ではサポートされません。

パラメーター

項目 説明
name 引用符 ("") が含まれます。、FIRST_LOGICALVOLUME、または統計を取得する対象の論理ボリュームを示す名前
ユーザー・バッファー perfstat_logicalvolume_t構造体で満たされるメモリを指す
構造体のサイズ (sizeof_struct) perfstat_logicalvolume_t構造体のサイズを指定する
宛先番号 (desired_number) 収集するさまざまな論理ボリューム統計の数を指定します。

戻り値

正常に終了すると、満たされた構造体の数が返される。

失敗した場合は-1が返される。

エラー・コード

以下のいずれかが真の場合、perfstat_logicalvolumeサブルーチンは失敗します：

項目 説明
EINVAL パラメーターの 1 つが無効です
EFAULT メモリーが不足しています

ファイル

libperfstat.hファイルは、標準マクロ、データ型、サブルーチンを定義している。