Acquiring a Non-Blocking Spin Lock

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

pthread_spin_init Syntax

pthread_spin_init Return Values

Acquiring a Spin Lock

pthread_spin_lock Syntax

pthread_spin_lock Return Values

Acquiring a Non-Blocking Spin Lock

pthread_spin_trylock Syntax

pthread_spin_trylock Return Values

Unlocking a Spin Lock

pthread_spin_unlock Syntax

pthread_spin_unlock Return Values

Destroying a Spin Lock

pthread_spin_destroy Syntax

pthread_spin_destroy Return Values

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:

Use the pthread_spin_trylock(3C) function to lock a spin lock and fail immediately if the lock is held by another thread.

`pthread_spin_trylock()` Syntax

int  pthread_spin_trylock(pthread_spinlock_t *lock);

#include <pthread.h>

pthread_spinlock_t lock;
int ret;

ret = pthread_spin_trylock(&lock); /* try to lock the spin lock */

`pthread_spin_trylock()` Return Values

Upon successful completion, the pthread_spin_trylock() function returns 0. Otherwise, one of the following error codes is returned.

EBUSY

Description: A thread currently owns the spin lock.

EINVAL

Description: The value specified by lock does not refer to an initialized spin lock object.

Acquiring a Non-Blocking Spin Lock

pthread_spin_trylock() Syntax

pthread_spin_trylock() Return Values

`pthread_spin_trylock()` Syntax

`pthread_spin_trylock()` Return Values