pthread_mutex_consistent(3c) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

pthread_mutex_consistent(3c)

pthread_...nsistent(3C)  Standard C Library Functions  pthread_...nsistent(3C)

NAME
       pthread_mutex_consistent - mark state protected by robust mutex as con‐
       sistent

SYNOPSIS
       #include <pthread.h>

       int pthread_mutex_consistent(pthread_mutex_t *mutex);

DESCRIPTION
       The  following  applies only to mutexes that have been initialized with
       the  PTHREAD_MUTEX_ROBUST   attribute.   See   pthread_mutexattr_getro‐
       bust(3C).


       If  mutex  is  a robust mutex in an inconsistent state, the pthread_mu‐
       tex_consistent() function can be used to mark the  state  protected  by
       the mutex referenced by mutex as consistent again.


       If  the  owner of a robust mutex terminates while holding the mutex, or
       if the process containing the owner of the mutex unmaps the memory con‐
       taining the mutex or performs one of the exec(2) functions,  the  mutex
       becomes  inconsistent  and the next thread that acquires the mutex lock
       is notified of the state by the return value EOWNERDEAD. In this  case,
       the  mutex  does  not  become  normally usable again until the state is
       marked consistent.


       The pthread_mutex_consistent() function is only responsible for notify‐
       ing the system that the state protected by the mutex has been recovered
       and that normal operations with the mutex can be resumed. It is the re‐
       sponsibility of the application to recover  the  state  so  it  can  be
       reused.  If the application is not able to perform the recovery, it can
       notify the system that the situation is  unrecoverable  by  a  call  to
       pthread_mutex_unlock(3C)  without a prior call to pthread_mutex_consis‐
       tent(), in which case subsequent threads that attempt to lock the mutex
       will fail to acquire the lock and be returned ENOTRECOVERABLE.


       If the thread which acquired the mutex lock with the return value EOWN‐
       ERDEAD terminates before calling either  pthread_mutex_consistent()  or
       pthread_mutex_unlock(), the next thread that acquires the mutex lock is
       notified about the state of the mutex by the return value EOWNERDEAD.

RETURN VALUES
       Upon successful completion, the pthread_mutexattr_consistent() function
       returns 0. Otherwise, an error value is returned to indicate the error.

ERRORS
       The pthread_mutex_consistent() function will fail if:

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:

       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE  _  Interface  StabilityCommitted  _  StandardSee  stan‐
       dards(7).  _ MT-LevelMT-Safe


SEE ALSO
       exec(2), pthread_mutex_lock(3C), pthread_mutex_unlock(3C),  pthread_mu‐
       texattr_getrobust(3C), attributes(7), mutex(7), standards(7)

Oracle Solaris 11.4               16 May 2014          pthread_...nsistent(3C)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3