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 参数,则调度进程将使用省略参数的全局配置值。 |
/w | RtssRun 等待 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 参数,则该参数会被忽略。 |
filename | RTSS 应用程序的名称,相对路径或绝对路径。 |
[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。 |