waitfor_pathname()

QNX SDP8.0PLMS User's GuideAPIConfigurationDeveloper

Wait for a path within the specified poll time

Synopsis:

waitfor_pathname("pathname", poll_time, timeout)

Description:

The waitfor_pathname() function waits for the specified pathname to be accessible within the specified timeout (in milliseconds) and probes the accessibility of the path every poll_time (in milliseconds). If the pathname is not accessible within the timeout, it is assumed that waitfor_pathname() has failed. If the pathname changes state rapidly between polling intervals, the function may not detect a stable condition and may delay reporting success or failure until the timeout is reached.

The timeout range is 0 to INT_MAX(2147483647).

Example:

waitfor_pathname("/tmp/file", 100, 1000)

Multiplicity:

Zero or more instances in a task block.

Constraints:

  • A configuration file will be rejected if the specified timeout is less than poll_time.

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

Page updated: