dacs_mutex_destroy

NAME

dacs_mutex_destroy - Destroy a mutual exclusion variable.

SYNOPSIS

DACS_ERR_T dacs_mutex_destroy ( dacs_mutex_t *mutex )

Call parameter  
mutex A pointer to the handle of the mutex to destroy.

DESCRIPTION

The dacs_mutex_destroy service destroys the specified mutex and invalidates the handle. This service blocks until all users of the mutex have released it. The mutex may only be destroyed by the process that initialized it (the owner).

The destroy will succeed whether or not the mutex is held by its owner.

RETURN VALUE

The dacs_mutex_destroy 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_NOT_OWNER: this operation is only valid 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_release(3)
Parent topic: Locking Primitives