wlm_create_class サブルーチン
目的
新規ワークロード・マネージャー (WLM) クラスを作成します。
ライブラリー
ワークロード・マネージャー・ライブラリー (libwlm.a)
構文
説明
wlm_create_class サブルーチンは、 ワマルクス が指すタイプ struct wlm_args のデータ構造体に渡された値を使用して、指定された WLM 構成の新規クラスを作成します。
- 構成の名前が コンディル フィールドに渡されると、サブルーチンはターゲット構成の WLM プロパティー・ファイルを更新します。 スーパークラスの最初のサブクラスを作成すると、サブルーチンは /etc/wlm/<confdir> のサブディレクトリーをスーパークラスの名前で作成し、この新しいディレクトリーに WLM プロパティー・ファイルを作成します。 新しく作成されたプロパティー・ファイルには、新規サブクラスのエントリーに加えて、Default サブクラスと Shared サブクラスのエントリーが自動的に作成されます。
- ヌル・ストリング ('\0') が コンディル フィールドに渡されると、新しいスーパークラスまたはサブクラスはメモリー内の WLM データにのみ作成されます。 WLM プロパティー・ファイルは更新されません。 その場合、WLM が停止して再始動されるか、システムがリブートされると、新しいクラス定義は失われます。
struct wlm_argsの一部であるタイプ 構造体 class_definitionの構造体は、通常、 wlm_init_class_definitionへの呼び出しによって初期化されています。 これが行われたら、この構造体のフィールドのうち、デフォルト値を持たないフィールド (新しいクラスの名前など)、または必要な値がデフォルト値と異なるフィールドを初期化します。 すべてのクラス属性の取り得る値とそのデフォルト値については、Files Referenceの wlm.hの説明を参照してください。
呼び出し側は、スーパークラスを作成するための root 権限と、スーパークラスのサブクラスを作成するためのスーパークラスに対する管理者権限を持っている必要があります。
パラメーター
| 項目 | 説明 |
|---|---|
| ウミガメ | 作成する新規クラスの クラス定義 構造を含む struct wlm_args データ構造のアドレスを指定します。 |
wlm_args 構造体および組み込み副構造体の以下のフィールドを提供する必要があります。
| 項目 | 説明 |
|---|---|
| バージョン・フラグ | WLM_VERSION。 で初期化する必要があります。 |
| コンディル | 新規クラスが追加される WLM 構成の名前を指定します。 これは、 /etc/wlm の有効なサブディレクトリーの名前、または空ストリング (「¥ 0」で始まる) のいずれかでなければなりません。 名前が有効なサブディレクトリーである場合、新しいクラス・データは、指定された WLM 構成のクラス記述ファイルに追加されます。 名前がヌル・ストリングの場合、記述ファイルは更新されません。 新規クラスが作成され、データが即時にカーネルに渡されます。 |
| name | 作成されるスーパークラスまたはサブクラスの名前を指定します。 これがサブクラス名の場合は、 super_name.sub_nameの形式でなければなりません。 このフィールドにはデフォルトはありません。 |
ユーザーが特定の値を使用しない場合は、他のすべてのフィールドをデフォルト値のままにすることができます。
戻り値
正常終了すると、 wlm_create_class サブルーチンは値 0 を戻します。 wlm_create_class サブルーチンが失敗すると、ゼロ以外の値が戻されます。
エラー・コード
WLM API 関数によって戻される可能性のあるエラー・コードのリストについては、 wlm.h ヘッダー・ファイルの説明を参照してください。