Getting the Mutex Attribute's Protocol

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_getprotocol(3C) gets the protocol attribute of a mutex attribute object.

`pthread_mutexattr_getprotocol` Syntax

#include <pthread.h> 
int pthread_mutexattr_getprotocol(const pthread_mutexattr_t *restrict attr, 
int *restrict protocol);

attr points to a mutex attribute object created by an earlier call to pthread_mutexattr_init().

protocol contains one of the following protocol attributes: PTHREAD_PRIO_NONE, PTHREAD_PRIO_INHERIT, or PTHREAD_PRIO_PROTECT which are defined by the header <pthread.h>.

`pthread_mutexattr_getprotocol` Return Values

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

If either of the following conditions occurs, pthread_mutexattr_getprotocol() might fail and return the corresponding value.

EINVAL

Description: The value specified by attr is NULL, or the value specified by attr or protocol is invalid.

EPERM

Description: The caller does not have the privilege to perform the operation.