RtssKill Utility Usage

RtssKill can be used to forcibly terminate an RTSS process or RT-TCP/IP Stack process.

Usage

RtssKill [/s] [/showrttcpip]  id [/force]

Parameters

RtssKill (no parameters)

Display a list of IDs for all running RTSS processes.

/s <order id>

When <order id> is not specified, list all scheduled tasks.

When <order id> is specified, remove the scheduled task with the specified <order id>.

NOTE: This will not stop the process if it is currently running.

ID of the process to terminate.

/showrttcpip

Display a list of IDs for all running processes, including the RT-TCP/IP Stack.

NOTE: If the Watchdog Timer is enabled and the Subsystem has frozen all processes, including the RT-TCP/IP Stack, you must terminate the frozen processes with RtssKill. To terminate a RT-TCP/IP Stack process, you must use the /force flag.

IMPORTANT! Do not use RtssKill to terminate a running RT-TCP/IP Stack process.

id /force

Force termination of a RT-TCP/IP Stack process ID.

Return Value

0 (zero) if the process succeeds

If the process fails:

Value	Error	RtssKill Message for RTSS
1062	ERROR_SERVICE_NOT_ACTIVE	RtssKill was unable to stop the RTSS application provided. The process was not running.
1051	ERROR_DEPENDENT_SERVICES_RUNNING	RtssKill was unable to stop the RTSS application provided. The process was not running.
5	ERROR_ACCESS_DENIED	RtssKill is not being run with the prope permissions to complete the requested task.
87	ERROR_INVALID_PARAMETER	RtssKill was provided an invalid parameter. Use RtssKill /? for commandline useage information.
3	ERROR_PATH_NOT_FOUND	RtssKill was unable to find the path to the RTSS application provided.
2	ERROR_FILE_NOT_FOUND	RtssKill was unable to find the RTSS application provided.
111,122	ERROR_BUFFER_OVERFLOW ERROR_INSUFFICIENT_BUFFER	RtssKill was unable to stop the RTSS application provided. An internal buffer overflow occured.
1610	ERROR_BAD_CONFIGURATION	RtssKill was unable to stop the RTSS application provided. Subsystem configuration data was invalid.
167,231	ERROR_LOCK_FAILED ERROR_PIPE_BUSY	RtssKill was unable to stop the RTSS application provided. Subsystem resources were unavailable.
8	ERROR_NOT_ENOUGH_MEMORY	RtssKill was unable to stop the RTSS application provided. System memory resources were unavailable.
188	ERROR_INVALID_STARTING_CODESEG	RtssKill was unable to stop the RTSS application provided. The binary file may be corrupted.
50	ERROR_NOT_SUPPORTED	RtssKill was unable to stop the RTSS application provided. The functionality requested is unsupported under the current subsystem configuration.
	Default error case (all others)	RtssKill was unable to stop the RTSS application provided.