sys_parm サブルーチン

目的

カーネル・ランタイム・チューナブル・パラメーターを検査または設定するためのサービスを提供します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

説明

sys_parm サブルーチンは、ランタイム・オペレーティング・システム・パラメーターを照会またはカスタマイズ (あるいはその両方) するために使用されます。

sys_parm サブルーチンは、次のことを行います。

• 32 ビット・プラットフォームと 64 ビット・プラットフォームの両方で機能します。
• 使用するには適切な特権が必要です。

以下の操作がサポートされます。

返されるか設定される可能性のあるランタイム・パラメーターは、 var.h で定義されている var 構造体にあります。

パラメーター

vario 構造体は、各フィールドがサイズ不変である var 構造体のさまざまなフィールドを抽象化したものです。 データのサイズは、カーネルの実行環境が 32 ビットまたは 64 ビットであるか、呼び出し側アプリケーションが 32 ビットまたは 64 ビットであるかに依存しません。

例

1. v.v_iostrun の値を調べます (ディスク使用量統計を収集します)。

   #include <sys/var.h>
   #include <stdio.h>
   struct vario myvar;
   rc=sys_parm(SYSP_GET,SYSP_V_IOSTRUN,&myvar);
   if(rc==0)
           printf("v.v_iostrun is set to %d\n",myvar.v.v_iostrun.value);

2. v.v_iostrun の値を変更する (ディスク使用状況統計を収集する)。

   #include <sys/var.h>
   #include <stdio.h>
   struct vario myvar;
   myvar.v.v_iostrun.value=0; /* initialize to false */
   rc=sys_parm(SYSP_SET,SYSP_V_IOSTRUN,&myvar);
   if(rc==0)
           printf("disk usage statistics are not being collected\n");

その他のパラメーターは、parmflag パラメーターを変更することによって検査または設定することができます。

戻り値

これらの操作は、サブルーチンの正常終了時に値 0 を戻します。 そうでなければ-1が返され、エラーを示すerrnoグローバル変数が設定される。

エラー・コード

ファイル