Moduleunix-2.8.7.0Haskell2010

System.Posix.Semaphore

POSIX named semaphore support.

2 types
8 values

Packageunix-2.8.7.0
Exports10
LanguageHaskell2010
LicenceBSD-3-Clause
SourceSemaphore.hsc

datadata OpenSemFlags

Constructors

OpenSemFlags
- semCreate :: Bool
  If true, create the semaphore if it does not yet exist.
- semExclusive :: Bool
  If true, throw an exception if the semaphore already exists.

newtypenewtype Semaphore

valuesemOpen :: String -> OpenSemFlags -> FileMode -> Int -> IO Semaphore

Open a named semaphore with the given name, flags, mode, and initial value.

valuesemUnlink :: String -> IO ()

Delete the semaphore with the given name.

valuesemWait :: Semaphore -> IO ()

Lock the semaphore, blocking until it becomes available. Since this is done through a system call, this will block the *entire runtime*, not just the current thread. If this is not the behaviour you want, use semThreadWait instead.

valuesemWaitInterruptible :: Semaphore -> IO Bool

Lock the semaphore, blocking until it becomes available.

Unlike semWait, this wait operation can be interrupted with an asynchronous exception (e.g. a call to throwTo from another thread).

valuesemTryWait :: Semaphore -> IO Bool

Attempt to lock the semaphore without blocking. Immediately return False if it is not available.

valuesemThreadWait :: Semaphore -> IO ()

Poll the semaphore until it is available, then lock it. Unlike semWait, this will block only the current thread rather than the entire process.

valuesemPost :: Semaphore -> IO ()

Unlock the semaphore.

valuesemGetValue :: Semaphore -> IO Int

Return the semaphore's current value.