spc.h ファイル

目的

システム・リソース・コントローラー (SRC) サブルーチンによって提供される外部インターフェースを定義します。

説明

/usr/include/spc.h ファイルは、SRC サブルーチンを呼び出すときに使用されるデータ構造とシンボリック定数を定義します。 ソケットまたはメッセージ・キューを介して SRC によって制御されるすべてのサブシステムに、このヘッダー・ファイルを組み込む必要があります。

spc.h ファイルの scrreq データ構造は、 srcmstr デーモンによってサブシステムに送信される要求の形式を定義します。 このフォーマットは、 SRCMSTR デーモンに要求を送信する SRC サブルーチンによっても使用されます。

SRCREQ データ構造には、以下のフィールドが含まれます。

SRCREQ データ構造内の SRCHDR データ構造には、要求に応答するために必要な戻りアドレスが含まれています。 SRCRQ サブルーチンを使用して、この情報を要求から抽出することができます。 SRCHDR データ構造は、サブシステムによって戻される応答構造の一部でもあります。

SRCHDR データ構造には、以下のフィールドが含まれます。

サブ要求 データ構造には、サブシステムによって処理される要求が含まれます。 この同じ構造は、サブシステムに要求を送信するために SRCSRQT サブルーチンを呼び出すときに使用されます。 SRCSRQT サブルーチンは、必要な SRCHDR 構造体をフォーマットします。 要求は SRCMSTR デーモンによって処理され、サブシステムに渡されます。

サブ要求 データ構造には、以下のフィールドが含まれます。

spc.h ファイルの srcrep および statrep 構造体は、サブシステムによって戻される応答のフォーマットを定義します。 詳しくは、 SRCSRP サブルーチンを参照してください。

SRCREP データ構造は、開始、停止、リフレッシュ、およびトレース要求に対する応答に使用する必要があります。 以下のフィールドが含まれています。

ステータス担当者 データ構造は、状況要求に対する応答に使用されます。 以下のフィールドが含まれています。

spc.h ファイルは、 srcmstr デーモンとの通信に役立つ以下の定数も定義します。

また、SRC オブジェクト (サブシステムおよびサブサーバーを含む) を管理するための SRC サブルーチンもあります。 spc.h ファイルは、オブジェクト属性を定義するときに役立つ特定のシンボリック定数を定義します。 以下の SRC オブジェクト記述子は、 /usr/include/sys/srcobj.h ファイルに定義されています。

RESPAWN=1

ONCE=2

SRCIPC=1

SRCSIGNAL=2

SRCSOCKET=3

SRCYES=1

SRCNO=0

SRCYES=1

SRCNO=0

TIMELIMIT=20(秒)

spc.h ファイルには、 /usr/include/srcerrno.h ファイルも含まれています。このファイルには、SRC ライブラリー・サブルーチンによって戻されるエラーのシンボリック定数が入っています。 ソース・エラー・メッセージ サブルーチンを使用して、対応するエラー・メッセージを検索することができます。

SRC 要求構造の例

以下のプログラムの抜粋は、SRC 要求 (SRCREQ) 構造体の例です。

struct srcreq
{
  long mtype;     /*Contains the message type in the IPC buffer*/
                  /*This field is included if IPC is used and a
                    message queue is expected*/

 struct srchdr srchdr;    /*src header table entry - defined below*/
 struct subreq subreq;    /*the request passed to the subsystem*/
};

struct srchdr     /*srchdr structure is used by SRC routines*/
                  /*subsystems are not responsible for setting \
                    this*/
{
 struct sockaddr_un retaddr;
 short dversion;   /*the version of the data format*/
 short cont;       /*used to indicate message is continued*/
};

struct subreq
{
 short object;          /*object to act on*/
 short action;          /*action START, STOP, STATUS,TRACE,REFRESH*/
 short parm1;           /* */
 short parm2;           /*              */
 char objname[SRCNAMES];        /*object name*/
};