sysconfig サブルーチン
目的
システム/カーネル構成を制御するためのサービスを提供します。
ライブラリー
標準 C ライブラリー (libc.a)
構文
説明
sysconfig サブルーチンは、オペレーティング・システムをカスタマイズするために使用されます。 このサブルーチンは、カーネル・エクステンションをロード、アンロード、および構成する手段を提供します。 これらのカーネル・エクステンションは、追加の カーネル・サービス、 システム・コール、デバイス・ドライバー、 または 「オペレーティング・システムおよびデバイスの管理」の 「ファイル・システム」 を参照してください。 sysconfig サブルーチンは、システム・ランタイム操作パラメーターを読み取って設定する機能も提供します。
sysconfig サブルーチンを使用するには、適切な特権が必要です。
sysconfig サブルーチンが提供する特定の操作は、 Cmd パラメーターの値によって定義されます。 以下の操作が定義されています。
| 項目 | 説明 |
|---|---|
| SYS_KLOAD (SYS_KLOAD sysconfig 操作) | カーネル・エクステンション・オブジェクト・ファイルをカーネル・メモリーにロードします。 |
| SYS_SINGLELOAD (SYS_SINGLELOAD sysconfig 操作) | カーネル・エクステンション・オブジェクト・ファイルがまだロードされていない場合にのみロードします。 |
| SYS_QUERYLOAD (SYS_QUERYLOAD sysconfig 操作) | 指定されたカーネル・オブジェクト・ファイルがロードされるかどうかを決定します。 |
| SYS_KULOAD (SYS_KULOAD sysconfig 操作) | 以前にロードされたカーネル・オブジェクト・ファイルをアンロードします。 |
| SYS_QDVSW (SYS_QDVSW sysconfig 操作) | 装置スイッチ・テーブル内の装置スイッチ項目の状況を検査します。 |
| SYS_CFGDD (SYS_CFGDD sysconfig 操作) | 指定された デバイス・ドライバー構成ルーチン (モジュール・エントリー・ポイント) を呼び出します。 |
| SYS_CFGKMOD (SYS_CFGKMOD sysconfig 操作) | 構成のために、指定されたモジュールをそのモジュール・エントリー・ポイントで呼び出します。 |
| SYS_GETPARMS (SYS_GETPARMS sysconfig 操作) | var 構造体で検出されたランタイム・システム・パラメーターの現行値を含む構造体を戻します。 |
| SYS_SETPARMS (SYS_SETPARMS sysconfig 操作) | 呼び出し側提供の構造体からランタイム・システム・パラメーターを設定します。 |
| SYS_GETLPARINFO (SYS_GETLPAR_INFO sysconfig 操作) | システム LPAR 情報をユーザー割り振りバッファーにコピーします。 |
さらに、 SYS_64BIT フラグは、 コマンド パラメーター ( コマンド パラメーターが システム・ロード または システム・シングル・ロードの場合) を使用してビット単位で OR 演算することができます。 カーネル・エクステンションの場合、これはカーネル・エクステンションが 64 ビット・システム・コールをエクスポートしないが、32 ビット・システム・コールはすべて 64 ビット・アプリケーションでも機能することを示します。 デバイス・ドライバーの場合、これは、64 ビット・アプリケーションでデバイス・ドライバーを使用できることを示します。
ローダー・シンボル・バインディング・サポート では、カーネル・オブジェクト・ファイルのロード時に提供されるシンボル・バインディング・サポートについて説明しています。
パラメーター
| 項目 | 説明 |
|---|---|
| Cmd | sysconfig サブルーチンが実行する関数を指定します。 |
| パラメーター | ユーザー提供の構造を指定します。 |
| ParmLen | Parmp パラメーターによって示されるユーザー提供の構造の長さを指定します。 |
戻り値
これらの sysconfig 操作は、サブルーチンの正常終了時に値 0 を戻します。 そうでない場合は-1が返され、エラーを示すerrnoグローバル変数が設定される。
呼び出し側からのストラクチャーを必要とする sysconfig 操作は、そのストラクチャーが呼び出しプロセスによってアドレス可能なメモリー内に完全にはない場合は、失敗します。 戻り値として-1が渡され、errnoグローバル変数がEFAULTに設定される。