exec_waitfor_exit()

QNX SDP8.0PLMS User's GuideAPIConfigurationDeveloper

Spawn a process and wait for it to exit

Synopsis:

exec_waitfor_exit( timeout )

Description:

The exec_waitfor_exit() function spawns the process and waits for it to exit before processing the next function or task of the component. The wait time is defined by the timeout parameter in milliseconds. The timeout range can be 0 to INT_MAX(2147483647).

Multiplicity:

Zero or one instance in a task block.

Constraints:

  • Only one exec_waitfor_exit() is allowed in a task.

  • If exec_waitfor_exit() is used, then exec() and exec_expect_exit() are not allowed in the same task.

  • If a task has an exec_waitfor_exit() function, then that task must define the command property.

  • The parser will reject a configuration file if a task has an exec_waitfor_exit() without a command definition.

  • The user will use exec_waitfor_exit() to spawn short-lived processes.

  • If the process spawned by exec_waitfor_exit() does not exit within the specified timeout period, exec_waitfor_exit() fails.

  • If exec_waitfor_exit() is used in start_sequence tasks, the start can be aborted by a stop action during the wait time.

Page updated: