Acquires units from a semaphore.
A string or
A non-negative fixnum.
semaphore-acquire acquires count units from the semaphore sem.
It attempts to atomically decrement the semaphore's unit count by count. If this gives a non negative result, then it changes the semaphore's unit count accordingly and returns true. The default value of count is 1.
However, if decrementing the semaphore's unit count would result in a negative number then
semaphore-acquire waits until the semaphore's unit count is larger than count and tries again. If wait-reason is true, then it is used as the thread's wait-reason when waiting for the semaphore.
If timeout is
semaphore-acquire can wait forever. Otherwise, if the semaphore count cannot be decremented within timeout seconds, then
semaphore-acquire returns false and the semaphore is unaffected. Pass timeout 0 if you do not want to wait at all.
You can get the current unit count of a semaphore by calling semaphore-count.
LispWorks User Guide and Reference Manual - 20 Sep 2017