RtssKill Utility Usage

RtssKill can be used to forcibly terminate an RTSS process or network (NAL and TCP/IP Stack) process.

Usage

RtssKill [/s orderid]

RtssKill pid [/force]

Parameters

RtssKill (no parameters)

Display a list of IDs for all running RTSS processes.

/s <orderid>

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

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

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

NOTE: If Ideal Processor is not specified when a scheduled process is created, RtssKill /s will display a value of DEFAULT for that parameter. The same is true for Affinity Mask.

pid

PID of the process to terminate.

pid /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.

Related topics: