INtime SDK Help
RTLOAD.SYS format
The RTLOAD.SYS file is used by INtime Distributed RTOS to load applications just after system boot. The format of this file is a series of lines, each of which causes an application to be loaded, or is a special action, or a comment.
Comment lines start with a ; (semicolon) character. These lines are ignored by the loader.
Comments may also be found on other lines; an unquoted semicolon start a comment and the rest of the line is ignored by the loader.
Special action lines start with a carat (^) character followed by a single letter and an option argument. They include the following:
| Option | Description |
|---|---|
| ^d, ^D | Debug. Enter SDM after processing the line. If SDM is not enabled than no action occurs. Primarily used for debugging the loader process. |
| ^wNN, ^WNN | Wait for NN seconds before processing the next line. |
| ^lN, ^LN | Set the loader syslog level to N (valid values 0 (LOG_EMERG) - 7 (LOG_DEBUG)). Useful for setting the syslog level after some applications have already been loaded, reducing the overall quantity of output. |
| ^V | Enable verbose output. Prints messages about the applications being loaded. |
| ^v | Disable verbose output. |
Alert lines start with a '#' (pound or hash) character. An alert line consists of a message which is printed when processed, then the user is prompted to press ENTER before continuing to process the file.
Other lines have the following format:
full-local-path-of-RTA ["optional command line"] [optional loader arguments]
Each application file is read from the local file system and loaded with the loader arguments, if present. Any command line parameters are passed to the application.
If it is required to load an application with loader arguments, but with no command line parameters, a blank string should be specified.
Possible loader arguments are as follows:
| Option | Argument | Description |
|---|---|---|
| -d, -D | Debug. Insert a breakpoint at the first instruction of the application. The action when the breakpoint is hit is usually to keep the initial thread suspended until a debugger can be joined to the application. For example, run faulthandle.exe on your SDK and select the node where the application has just been loaded. | |
| -m, -M | none, or + | Force the application loaded in XM mode. |
| -m-, -M- | Force the application to be loaded in non-XM mode. | |
| -o, -O | number | Set the number of entries in the process catalog |
| -n, -N | memsize | Set the process pool_min value. |
| -x, -X | memsize | Set the process pool_max value. |
| -v, V | memsize | Set the application VSEG size |
| -w, -W | number (optional) | Set the PROC_WAIT_FOR_INIT flag and set the delay to the number of seconds specified. Default 5 seconds if flag given but no value. |
"number" format is a string to be converted by strtoul with radix 0
"memsize" format is a string to be converted by strtoul, with optional suffix:
; Sample rtload.sys file. This is a one-line comment
;
; The following line shows an application which has been disabled by the websadm utility
;--disabled--/network7/sntp.rta
; Load an application, force to XM mode
/bin/inshell.rta "-initfile /config/etc/inshell.rsc" -m-
; Enable syslog output from hereon
^L 7
; Alert sample
# About to load test aapplication
; Load test application (no command line)
; set VSEG size to 32 Mbytes, pool_min to 2 Mbytes
/bin/testapp.rta -v 32m -n 2m