pthread_mutexattr_setkind_np

Specifies the mutex type attribute that is used when a mutex is created.

Syntax

pthread_mutexattr_setkind_np( attr, kind );

Argument Data Type Access

attr opaque pthread_ read mutexattr_t kind integer read

C Binding

int
pthread_mutexattr_setkind_np (
pthread_mutexattr_t *attr,
int kind);

Arguments

attr: Mutex attributes object modified.
kind: New value for the mutex type attribute. The kind argument specifies the type of mutex that is created. Valid values are MUTEX_FAST_NP (default), MUTEX_RECURSIVE_NP, and MUTEX_ NONRECURSIVE_NP.

Description

This routine sets the mutex type attribute that is used when a mutex is created. See Section 2.2.4.1 for information on the types of mutexes.

Return Values

If an error condition occurs, this routine returns -1 and sets errno to the corresponding error value. Possible return values are as follows:

Return Error Description

0 Successful completion. -1 [EINVAL] The value specified by attr or kind is invalid. -1 [ESRCH] The value specified by attr does not refer to an existing mutex attributes object.