dacs_mutex_release

NAME

dacs_mutex_release - Release a mutual exclusion variable.

SYNOPSIS

DACS_ERR_T dacs_mutex_release ( dacs_mutex_t *mutex )

Call parameter  
*mutex A pointer to the handle of the mutex to release.

DESCRIPTION

The dacs_mutex_release service releases a previously accepted mutex object and invalidates the handle. When all accepters have released the mutex, it may be destroyed by its owner. This service does not block.

The release will succeed whether or not the mutex is held by the caller.

RETURN VALUE

The dacs_mutex_release service returns an error indicator defined as:
  • DACS_SUCCESS: normal return.
  • DACS_ERR_INVALID_ADDR: the pointer is invalid.
  • DACS_ERR_INVALID_HANDLE: the specified mutex handle is invalid.
  • DACS_ERR_OWNER: this operation is not allowed for the owner of the resource.

SEE ALSO

dacs_mutex_init(3), dacs_mutex_share(3), dacs_mutex_accept(3), dacs_mutex_lock(3), dacs_mutex_try_lock(3), dacs_mutex_unlock(3), dacs_mutex_destroy(3)
Parent topic: Locking Primitives