Getting a Read-Write Lock 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

Destroying a Mutex Attribute Object

Setting the Scope of a Mutex

Getting the Scope of a Mutex

Setting the Mutex Type Attribute

Getting the Mutex Type Attribute

Setting the Mutex Attribute's Protocol

Getting the Mutex Attribute's Protocol

Setting the Mutex Attribute's Priority Ceiling

Getting the Mutex Attribute's Priority Ceiling

Setting the Mutex's Priority Ceiling

Getting the Mutex's Priority Ceiling

Setting the Mutex's Robust Attribute

Getting the Mutex's Robust Attribute

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

pthread_rwlockattr_init Syntax

pthread_rwlockattr_init Return Values

Destroying a Read-Write Lock Attribute

pthread_rwlockattr_destroy Syntax

pthread_rwlockattr_destroy Return Values

Setting a Read-Write Lock Attribute

pthread_rwlockattr_setpshared Syntax

pthread_rwlockattr_setpshared Return Values

Getting a Read-Write Lock Attribute

pthread_rwlockattr_getpshared Syntax

pthread_rwlockattr_getpshared Return Values

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_rwlockattr_getpshared(3C) gets the process-shared read-write lock attribute.

`pthread_rwlockattr_getpshared` Syntax

#include <pthread.h> 
int pthread_rwlockattr_getpshared(const pthread_rwlockattr_t *restrict attr, 
          int *restrict pshared);

pthread_rwlockattr_getpshared() obtains the value of the process-shared attribute from the initialized attributes object referenced by attr.

`pthread_rwlockattr_getpshared` Return Values

If successful, pthread_rwlockattr_getpshared() returns zero. Otherwise, an error number is returned to indicate the error.

EINVAL

Description: The value specified by attr or pshared is invalid.