Removing a Condition Variable 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

pthread_condattr_init Syntax

pthread_condattr_init Return Values

Removing a Condition Variable Attribute

pthread_condattr_destroy Syntax

pthread_condattr_destroy Return Values

Setting the Scope of a Condition Variable

pthread_condattr_setpshared Syntax

pthread_condattr_setpshared Return Values

Getting the Scope of a Condition Variable

pthread_condattr_getpshared Syntax

pthread_condattr_getpshared Return Values

Setting the Clock Selection Condition Variable

pthread_condattr_setclock Syntax

pthread_condattr_setclock Returns

Getting the Clock Selection Condition Variable

pthread_condattr_getclock Syntax

pthread_condattr_getclock Returns

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:

Use pthread_condattr_destroy(3C) to remove storage and render the attribute object invalid.

`pthread_condattr_destroy` Syntax

int pthread_condattr_destroy(pthread_condattr_t *cattr);

#include <pthread.h>
pthread_condattr_t cattr;
int ret;

/* destroy an attribute */
ret
 = pthread_condattr_destroy(&cattr);

`pthread_condattr_destroy` Return Values

pthread_condattr_destroy() returns zero after completing successfully. Any other return value indicates that an error occurred. If the following condition occurs, the function fails and returns the corresponding value.

EINVAL

Description: The value specified by cattr is invalid.