spc.h 文件

用途

定义由系统资源控制器 (SRC) 子例程提供的外部接口。

描述

/usr/include/spc.h 文件定义在调用 SRC 子例程时使用的数据结构和符号常量。 由 SRC 通过套接字或消息队列控制的所有子系统都应包含此头文件。

spc.h 文件中的 scrreq 数据结构定义 srcmstr 守护程序发送到子系统的请求的格式。 将请求发送到 srcmstr 守护程序的 SRC 子例程也使用此格式。

斯克里克 数据结构中包含以下字段:

斯克里克 数据结构中的 斯尔奇德尔 数据结构包含对请求进行应答所需的返回地址。 斯尔茨尔克 子例程可以用来从请求中抽取此信息。 斯尔奇德尔 数据结构也是由子系统返回的应答结构的一部分。

斯尔奇德尔 数据结构中包含以下字段:

苏贝克 数据结构包含将由子系统处理的请求。 当调用 斯尔恰特 子例程将请求发送至子系统时，使用此相同结构。 斯尔恰特 子例程格式化必需的 斯尔奇德尔 结构。 srcmstr 守护程序处理该请求并将其传递到子系统。

苏贝克 数据结构中包含以下字段:

spc.h 文件中的 srcrep 和 statrep 结构定义子系统返回的应答的格式。 有关更多信息，请参阅 斯尔奇皮 子例程。

对于启动，停止，刷新和跟踪请求的回复，必须使用 斯克里普 数据结构。 它包含以下字段:

斯塔特雷普 数据结构用于对状态请求进行回复。 它包含以下字段:

spc.h 文件还定义了下列在与 srcmstr 守护程序通信时有用的常量:

还存在用于管理 SRC 对象 (包括子系统和子服务器) 的 SRC 子例程。 spc.h 文件定义在定义对象属性时有用的某些符号常量。 在 /usr/include/sys/srcobj.h 文件中定义了以下 SRC 对象描述符:

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_err_msg 子例程来检索相应的错误消息。

SRC 请求结构示例

下面的程序摘录是 SRC 请求 (斯克里克) 结构的示例。

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*/
};