taskstart

Cause the target operating system to start a program under the control of the debugger. If successful, the new task will be stopped at its program entry point.

Syntax

[vp =] taskstart(filename, targetpath, arguments)

Where:

vp	specifies the debug object of type ord4 to which the function return value is assigned. If vp is not specified, the return value is displayed on the next line of the screen. The return value is the viewpoint of the task to debug.
filename	specifies a filename.  See Filenames for details.
targetpath	is a string that specifies the path and filename of the program on the target operating system to start.
arguments	is a string that specifies the command line arguments for the program. An empty string ”” specifies no arguments. This parameter should be enclosed by double quotes, especially if there are spaces or multiple arguments. If there are arguments that are strings, then their quotes will have to be escaped (e.g., ”1 2 \”three” 4”).

Discussion

The taskstart command uses the symbols from the program file on the host (filename) and launches the corresponding program (targetpath) on the target operating system under debugger control with the supplied command line parameters (arguments). The program files on both the host and target operating system must exist for this command to succeed. The third parameter (argument) should be an empty string if no arguments are needed.

Use the taskend command to stop debugging the task.

Examples

The following examples show various forms of starting a program on the target operating system.

Command input:

taskstart("hello", "/home/hello", "")
taskstart("c:\\prog\\hello", "/home/hello", "25 /x /b")
taskstart("hello", "/home/hello", "13 \"test string\" /g")

Related Topics:

taskattach

taskend

taskgetpid