IntervalZero RTX64 4.x 帮助文档

⌘K
  1. 主页
  2. 文档
  3. IntervalZero RTX64 4.x 帮助...
  4. RTX64 工具和实用程序...
  5. RtssRun

RtssRun

RtssRun 用于从 Windows 命令提示符运行 RTSS 应用程序。运行结果将输出在控制台中。如果 RtssRun 不是在控制台中执行,或者不是从控制台脚本执行,则将创建一个控制台来显示输出。

注意:RtssRun 不能用于启动 RTSS组件,如 NAL 或 RT-TCP/IP 栈。

注意:从 RTX64 4.5 开始,RtssRun 将不提供发生错误时延迟脚本的消息框。


使用 RtssRun

注意:参阅 RTSS/RTDLL 二进制文件与 RTX64 Runtime 的兼容性(RTSS/RTDLL Binary Compatibility with RTX64 Runtime),了解 RTSS/RTDLL 二进制文件是否与尝试运行它的 RTX64 Runtime 版本兼容的验证工作的相关描述。

使用

RtssRun [/a affinity_mask] [/c] [/e expand_size] [/i initial_size] [/r start | firstalloc] [/p ideal_processor] [/s order_id] [/w] filename.rtss [args]

参数及描述

参数描述
/a (1,2,…,63)亲和力掩码。为运行 RTSS 应用程序指定处理器亲和力掩码,格式为以逗号分隔的处理器编号列表。
使用整数或十六进制值来标识处理器。务必使用系统范围的处理器编号。

注意:亲和力掩码只能包含子系统配置时与 RTSS 关联的处理器。
/c检查 RTSS 和 RTDLL 二进制文件与目标 Runtime 的兼容性,并列出所有兼容性问题。在兼容性检查中,该标志:
● 检测 Runtime 中不存在的 API 引用
● 检测发生重大更改的 API 引用

注意:该参数必须自己调用。
/e expand_size扩展进程 MSpace 的本地内存容量(KB)。仅当在 RTX64 控制面板中选择使用本地内存(Use local memory)时适用。

注意:如果省略该参数,进程将使用全局配置的值。
/i initial_size进程启动时,外部 MSpace 初始化的本地内存容量(KB)。仅当在 RTX64 控制面板中选择使用本地内存(Use local memory)时适用。

注意:如果省略该参数,进程将使用全局配置的值。
/p n理想处理器:为 RTSS 应用程序设置理想处理器。使用整数或十六进制值来标识处理器,并确保使用其系统范围的处理器编号。

注意:如果 /a 指定了处理器亲和性掩码,则 /p 设置的理想处理器必须是亲和性掩码中指定的处理器之一。
/r start | firstalloc进程分配外部 MSpace 的时机。需要以下有效参数之一:
start:进程启动时分配 MSpace
firstalloc:第一次内存请求时分配 MSpace

注意:如果省略该参数,则当第一次请求分配 MSpace 时,将分配进程外部 MSpace。
/s order_id将指定 <order id> 对应的二进制文件添加为计划任务。<order id> 为 -1 的计划任务将位于列表末尾。

注意:通过命令 rtsskill /s 可以获取计划任务的 order id。

注意:如果二进制文件不在 RTX64 搜索路径列出的文件夹中,则必须提供该二进制文件的完整路径。

注意:如果在指定参数 /s 时省略了 /e/i/r 参数,则调度进程将使用省略参数的全局配置值。
/wRtssRun 等待 RTSS 进程完成后再退出。指定此参数时,除非发生中断,否则 RTSS 进程退出前,RtssRun 会显示进程的退出代码。
典型场景:
● RTSS进程正常终止,RtssRun 显示如下消息:Process has exited with the value <exit code>
● RTSS 进程使用了 RtssKill 或调用了 RtTerminateProcess,RtssRun 显示如下消息:Process has exited with the value <exit code>
● RtssRun 等待 RTSS 进程,同时 RTX64 控制面板尝试停止子系统时,RtssRun 将退出且不显示退出代码
● RtssRun 被终止时,RtssRun 将退出且不显示退出代码

注意:如果制定了 /s 参数,则该参数会被忽略。
filenameRTSS 应用程序的名称,相对路径或绝对路径。
[args]正在运行的 RTSS 应用程序的参数。

运行 RTSS 应用程序

使用 RtssRun 运行 RTSS 进程时,实际上是 RTX64 加载程序通过提供的参数,启动 RTSS 进程。执行该操作的用户必须是 RTX64Users 组的成员。

注意:环境变量不会自动扩展。

对于 RtssRun 加载的RTSS 和 RTDLL 文件,其路径名不支持代码点大于 255 的 Unicode 字符 。不支持的字符包括所有的日语,中文,希腊语,希伯来语,西里尔语和韩语字符,以及许多其他非拉丁语字符语言。

运行 RTSS 应用程序:

在命令提示符下键入以下内容:

RtssRun [/a affinity_mask] [/p ideal_processor] filename.rtss

注意:如果运行的 RTSS 应用程序未被 StampTool 标记,会出现错误消息:This application was not built with a valid license.(应用程序未使用有效许可证构建)。关于标记 RTSS 应用程序的说明,参阅 StampTool

注意:不能从映射驱动器运行 RTSS 进程。

注意:RTX64Users 组的成员可以通过 RtssRun 运行 RTSS 应用程序。不过由于组访问限制,这些成员无法看到子系统的运行状态。详细信息,请参阅户组和访问权限

RtssRun 使用示例

示例描述
Rtssrun /p 2 srtm.rtss /n 2 /f /h 60

Rtssrun /p 3 srtm.rtss /n 2 /f /h 60
如果有多个处理器可用,可以在每个处理器上运行 srtm.rtss 实例来测量延迟。

注意:/n 2 /f /h 60 是 srtm.rtss 的参数。详细信息,参阅使用 SRTM
Rtssrun /a (2,3) sample.rtss运行 sample.rtss,并指定进程的线程仅在处理器 2 和 3 上运行。
Rtssrun /a (1,2) /p 2 sample.rtss运行 sample.rtss,并指定进程的线程仅在处理器 1 和 2 上运行,同时将理想处理器设置为 2。
Rtssrun /s 0 srtm.rtss将 srtm.rtss 添加到计划任务,order id 为 0。