Unit 'Exec' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#aros]

Vacate

Release a bidMessage from Procure()

Declaration

Source position: exec.pas line 1302

procedure Vacate(

  SigSem: PSignalSemaphore;

  BidMsg: PSemaphoreMessage

);

Arguments

SigSem

  

The SignalSemaphore that you wish to Vacate()

BidMsg

  

The SemaphoreMessage that you wish to abort. The message's ssm_Semaphore field will be cleared. The message will be replied if it is still on the waiting list. If it is not on the waiting list, it is assumed that the semaphore is owned and it will be released.

Description

This function can be used to release a semaphore obtained via Procure(). However, the main purpose for this call is to be able to remove a bid for a semaphore that has not yet responded. This is required when a Procure() was issued and the program no longer needs to get the semaphore and wishes to cancel the Procure() request. The canceled request will be replied with the ssm_Semaphore field set to nil. If you own the semaphore, the message was already replied and only the ssm_Semaphore field will be cleared.

See also

ObtainSemaphoreList

  

Get a List of semaphores

InitSemaphore

  

Initialize a signal semaphore

ReleaseSemaphore

  

Make signal semaphore available to others

AttemptSemaphore

  

Try to obtain a Semaphore without blocking

ObtainSemaphore

  

Gain exclusive access to a semaphore

ObtainSemaphoreShared

  

Gain access to a semaphore in shared mode

Procure

  

Asynchron locking of a semaphore


Documentation generated on: 2021-07-30