Overview

An object directory lists object names and corresponding handles.

• The name contains from 1 to 12 characters; a character is a 1-byte value from 0 to 0FFH. Some threads may know objects only by name.
• The handle is a 16-bit handle for objects.

The object directory enables threads to use symbolic names to share object access.

Creating a process object directory

The RT kernel creates an object directory for each process. The number of entries for processes is a parameter in the RT Application Loader.

Deleting a process object directory

You delete the process object directory when the process is deleted.

Using an object directory

Typically, one thread creates an object and catalogs its handle and name. Another thread uses that name to look up the handle for the object. Two or more threads can share an object cataloged in an object directory.

Note:   The object directory is case-sensitive: upper-and lower-case alphabetic characters are interpreted differently. The INtime kernel, however, sees the name as just a string of bytes; it does not interpret these bytes as ASCII characters.

System calls

This lists common operations on objects in object directories and the system calls that perform the operations. Threads can use the object directory of their process or another process.

This shows the order to make object directory system calls and lists calls that objects frequently use:

1. Make this call from the thread that created the object.
2. Make these calls from threads that need to access the object.
3. Make this call from the thread that created the object.