Getting the Mutex Type Attribute

Multithreaded Programming Guide

Document Information

Using This Documentation

Chapter 1 Covering Multithreading Basics

Chapter 2 Basic Threads Programming

Chapter 3 Thread Attributes

Chapter 4 Programming with Synchronization Objects

Mutual Exclusion Lock Attributes

Initializing a Mutex Attribute Object

pthread_mutexattr_init Syntax

pthread_mutexattr_init Return Values

Destroying a Mutex Attribute Object

pthread_mutexattr_destroy Syntax

pthread_mutexattr_destroy Return Values

Setting the Scope of a Mutex

pthread_mutexattr_setpshared Syntax

pthread_mutexattr_setpshared Return Values

Getting the Scope of a Mutex

pthread_mutexattr_getpshared Syntax

pthread_mutexattr_getpshared Return Values

Setting the Mutex Type Attribute

pthread_mutexattr_settype Syntax

pthread_mutexattr_settype Return Values

Getting the Mutex Type Attribute

pthread_mutexattr_gettype Syntax

pthread_mutexattr_gettype Return Values

Setting the Mutex Attribute's Protocol

pthread_mutexattr_setprotocol Syntax

pthread_mutexattr_setprotocol Return Values

Getting the Mutex Attribute's Protocol

pthread_mutexattr_getprotocol Syntax

pthread_mutexattr_getprotocol Return Values

Setting the Mutex Attribute's Priority Ceiling

pthread_mutexattr_setprioceiling Syntax

pthread_mutexattr_setprioceiling Return Values

Getting the Mutex Attribute's Priority Ceiling

pthread_mutexattr_getprioceiling Syntax

pthread_mutexattr_getprioceiling Return Values

Setting the Mutex's Priority Ceiling

pthread_mutex_setprioceiling Syntax

pthread_mutex_setprioceiling Return Values

Getting the Mutex's Priority Ceiling

pthread_mutex_getprioceiling Syntax

pthread_mutex_getprioceiling Return Values

Setting the Mutex's Robust Attribute

pthread_mutexattr_setrobust_np Syntax

pthread_mutexattr_setrobust_np Return Values

Getting the Mutex's Robust Attribute

pthread_mutexattr_getrobust_np Syntax

pthread_mutexattr_getrobust_np Return Values

Using Mutual Exclusion Locks

Initializing a Mutex

Making a Mutex Consistent

Locking a Mutex

Unlocking a Mutex

Locking a Mutex Without Blocking

Locking a Mutex Before a Specified Absolute Time

Locking a Mutex Within a Specified Time Interval

Destroying a Mutex

Code Examples of Mutex Locking

Using Spin Locks

Initializing a Spin Lock

Acquiring a Spin Lock

Acquiring a Non-Blocking Spin Lock

Unlocking a Spin Lock

Destroying a Spin Lock

Condition Variable Attributes

Initializing a Condition Variable Attribute

Removing a Condition Variable Attribute

Setting the Scope of a Condition Variable

Getting the Scope of a Condition Variable

Setting the Clock Selection Condition Variable

Getting the Clock Selection Condition Variable

Using Condition Variables

Synchronization With Semaphores

Read-Write Lock Attributes

Initializing a Read-Write Lock Attribute

Destroying a Read-Write Lock Attribute

Setting a Read-Write Lock Attribute

Getting a Read-Write Lock Attribute

Using Read-Write Locks

Initializing a Read-Write Lock

Acquiring the Read Lock on Read-Write Lock

Acquiring a Read Lock on a Read-Write Lock Before a Specified Absolute Time

Acquiring a Non-Blocking Read Lock on a Read-Write Lock

Acquiring the Write Lock on a Read-Write Lock

Acquiring a Non-blocking Write Lock on a Read-Write Lock

Acquiring a Write Lock on a Read-Write Lock Before a Specified Absolute Time

Unlocking a Read-Write Lock

Destroying a Read-Write Lock

Using Barrier Synchronization

Synchronization Across Process Boundaries

Producer and Consumer Problem Example

Comparing Primitives

Chapter 5 Programming With the Oracle Solaris Software

Chapter 6 Programming With Oracle Solaris Threads

Chapter 7 Safe and Unsafe Interfaces

Chapter 8 Compiling and Debugging

Chapter 9 Programming Guidelines

Appendix A Extended Example: A Thread Pool Implementation

Index

Language:

pthread_mutexattr_gettype(3C) gets the mutex type attribute set by pthread_mutexattr_settype().

`pthread_mutexattr_gettype` Syntax

#include <pthread.h>

int pthread_mutexattr_gettype(pthread_mutexattr_t  *restrict attr , 
int  *restrict type);

The default value of the type attribute is PTHREAD_MUTEX_DEFAULT.

The type argument specifies the type of mutex. Valid mutex types include

PTHREAD_MUTEX_NORMAL
PTHREAD_MUTEX_ERRORCHECK
PTHREAD_MUTEX_RECURSIVE
PTHREAD_MUTEX_DEFAULT

For a description of each type, see pthread_mutexattr_settype Syntax.

`pthread_mutexattr_gettype` Return Values

On successful completion, pthread_mutexattr_gettype() returns 0. Any other return value indicates that an error occurred.

EINVAL

Description: The value specified by type is invalid.