OS/2 Semaphore API Differences

These APIs are included in your application by including the following definition in your application source file.

#define INCL_DOSSEMAPHORES

OS/2 Event Semaphore API Differences

The following describes the implementation differences between the OS2Linux library and the real OS/2 event semaphore APIs.

When multiple threads wait for an OS/2 event semaphore to post a single post operation to the semaphore will release all the waiting threads.. Under the OS/2Linux library there is a one-to-one correspondence between a post operation and the release of a single waiting thread. If three threads are waiting on an OS/2Linux event semaphore it will take three post operations to the semaphore to release all three threads.

DosCreateEventSem

APIRET APIENTRY DosCreateEventSem (PSZ pszName, PHEV phev, ULONG flAttr,
                                   BOOL32 fState);

• None.

DosOpenEventSem

APIRET APIENTRY DosOpenEventSem (PSZ pszName, PHEV phev);

• None.

DosCloseEventSem

APIRET APIENTRY DosCloseEventSem (HEV hev);

• Not all the specified return codes are used.

DosResetEventSem

APIRET APIENTRY DosResetEventSem (HEV hev, PULONG pulPostCt);

• None.

DosPostEventSem

APIRET APIENTRY DosPostEventSem (HEV hev);

• This function will accept multiple posts without returning an error.

DosWaitEventSem

APIRET APIENTRY DosWaitEventSem (HEV hev, ULONG ulTimeout);

• None.

DosQueryEventSem

APIRET APIENTRY DosQueryEventSem (HEV hev, PULONG pulPostCt);

• None.

OS/2 Mutex Semaphore API Differences

The following describes the implementation differences between the OS2Linux library and the real OS/2 mutex semaphore APIs.

DosCreateMutexSem

APIRET APIENTRY DosCreateMutexSem (PSZ pszName, PHMTX phmtx, ULONG flAttr,
                                   BOOL32 fState);

• None.

DosOpenMutexSem

APIRET APIENTRY DosOpenMutexSem (PSZ pszName, PHMTX phmtx);

• None.

DosCloseMutexSem

APIRET APIENTRY DosCloseMutexSem (HMTX hmtx);

• None.

DosRequestMutexSem

APIRET APIENTRY DosRequestMutexSem (HMTX hmtx, ULONG ulTimeout);

• None.

DosReleaseMutexSem

APIRET APIENTRY DosReleaseMutexSem (HMTX hmtx);

• None.

DosQueryMutexSem

APIRET APIENTRY DosQueryMutexSem (HMTX hmtx, PID *ppid, TID *ptid,
                                  PULONG pulCount);

• None.

OS/2 Muxwait Semaphore API Differences

The following describes the implementation differences between the OS2Linux library and the real OS/2 muxwait semaphore APIs.

DosCreateMuxWaitSem

APIRET APIENTRY DosCreateMuxWaitSem (PSZ pszName, PHMUX phmux,
                                     ULONG cSemRec, PSEMRECORD pSemRec,
                                     ULONG flAttr);

• None.

DosOpenMuxWaitSem

APIRET APIENTRY DosOpenMuxWaitSem (PSZ pszName, PHMUX phmux);

• None.

DosCloseMuxWaitSem

APIRET APIENTRY DosCloseMuxWaitSem (HMUX hmux)

• None.

DosAddMuxWaitSem

APIRET APIENTRY DosAddMuxWaitSem (HMUX hmux, PSEMRECORD pSemRec);

• None.

DosDeleteMuxWaitSem

APIRET APIENTRY DosDeleteMuxWaitSem (HMUX hmux, HSEM hSem);

• None.

DosWaitMuxWaitSem

APIRET APIENTRY DosWaitMuxWaitSem (HMUX hmux, ULONG ulTimeout,
                                   PULONG pulUser);

• None.

DosQueryMuxWaitSem

APIRET APIENTRY DosQueryMuxWaitSem (HMUX hmux, PULONG pcSemRec,
                                    PSEMRECORD pSemRec, PULONG pflAttr);

• None.