Search Path Settings

wRTOS does not support a current working directory for real-time processes. Search paths allow wRTOS to look in specific directories when running an RTSS application or loading an RTDLL. Loading an RTDLL searches the directory containing the application’s RTSS module prior to searching the directories in the search path.

You can configure the search path on the Search Path page in wRTOS Settings. Once the search path is set, you only need to specify a filename when loading applications and RTDLLs, assuming one of the directories in the search path contains the file you want to load.

Note: You must be a member of the wRTOSAdministrators user group to modify the search path. For more information on user groups, see User Groups and Access Permissions.

In this section:

Click to expandAccessing Search Path Settings

To open the Search Path page in wRTOS Settings:

  1. Open wRTOS Settings.
  2. Do one of the following:
  • From the Home page, click Subsystem. On the Subsystem page, click Search Path.

  • From any other wRTOS Settings page, click Contents / Subsystem / Search Path in the sidebar menu.

 

Adding a Directory to the Search Path

To add a directory:

Do one of the following:

  • Click Browse (...) and navigate to the directory you want to add to the search path and click OK.
  • Enter or paste the path name in the editable field, and then click Enter.

Note: Each directory in the search path must be an absolute path.

Note: Each directory in the search path must not contain more than 248 characters. This character limit includes the characters in the name of a file you try to load via the search path. A directory and file name combination that exceeds this limit will result in an error.

Note: You may experience a delay when you load an application or RTDLL if your search path contains several directories. The length of the delay will depend on the number of directories in the search path.

Note: The search path cannot contain more than 128 directories.

Removing a Directory from the Search Path

To remove a directory:

  1. Locate the directory in the search path list.
  2. Click Delete.

Changing Search Path Order

The order of directories in the search path is important. When the search path is used, the directories within the search path are searched in order, beginning with the first directory, and ending with the last. You can move a directory in the search path up or down to change its search priority.

To change the search path order:

  1. Select the directory in the search path list.
  2. Do one of the following:

RELATED Topics: