[ новости /+++ | форум | теги | ]

NAME

pthread_mutex_consistent_np - make a robust mutex consistent after owner death
 

SYNOPSIS

cc -mt [ flag... ] file... -lpthread [ library... ]
#include <pthread.h> 

int pthread_mutex_consistent_np(pthread_mutex_t *mutex);

DESCRIPTION

The following applies only to mutexes that have been initialized with the PTHREAD_MUTEX_ROBUST_NP attribute. See pthread_mutexattr_getrobust_np(3C).

The mutex object referenced by mutex is made consistent by calling pthread_mutex_consistent_np().

A consistent mutex becomes inconsistent and is unlocked if its owner dies while holding it, or if the process containing the owner of the mutex unmaps the memory containing the mutex or performs one of the exec(2) functions. A subsequent owner of the mutex will acquire the mutex with pthread_mutex_lock(3C), which will return EOWNERDEAD to indicate that the acquired mutex is inconsistent.

The pthread_mutex_consistent_np() function should be called while holding the mutex acquired by a previous call to pthread_mutex_lock() that returned EOWNERDEAD.

Since the critical section protected by the mutex could have been left in an inconsistent state by the dead owner, the caller should make the mutex consistent only if it is able to make the critical section protected by the mutex consistent.

Calls to pthread_mutex_lock(), pthread_mutex_unlock(), and pthread_mutex_trylock() for a consistent mutex will behave in the normal manner.  

RETURN VALUES

Upon successful completion, the pthread_mutexattr_consistent_np() function returns 0. Otherwise, an error number is returned to indicate the error.  

ERRORS

The pthread_mutex_consistent_np() function will fail if:

EINVAL

The current thread does not own the mutex or the mutex is not a PTHREAD_MUTEX_ROBUST_NP mutex having an inconsistent state (EOWNERDEAD).

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE MT-Level MT-Safe

SEE ALSO

pthread_mutex_lock(3C), pthread_mutexattr_getrobust_np(3C), attributes(5), mutex(5), standards(5)

Index

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUES

ERRORS

ATTRIBUTES

SEE ALSO

Партнёры:

Хостинг: