.\"   Copyright (C) 1996-1999 Free Software Foundation, Inc.
.\"
.\"   Permission is granted to make and distribute verbatim copies of
.\" this manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\"   Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
.\"
.\"   Permission is granted to copy and distribute translations of this
.\" manual into another language, under the above conditions for modified
.\" versions, except that this permission notice may be stated in a
.\" translation approved by the Foundation.
.\"
.\" Copyright (C) 1996 Xavier Leroy.
.\" 
.\" Japanese Version Copyright (C) 2000 WAKABAYASHI, Takeyasu
.\"         all rights reserved.
.\" Translated on Fri Jan 14 16:50:24 JST 2000
.\"         by WAKABAYASHI, Takeyasu <twakaba@eco.toyama-u.ac.jp>
.\" Updated and modified Sun Feb  2 15:15:47 JST 2003
.\"         by Suzuki Takashi.
.\"
.\"WORD:    mutual exclusion    ¾
.\"WORD:    critical section    ƥ륻
.\"
.TH PTHREAD_MUTEX 3 LinuxThreads


.SH "̾"
pthread_mutex_init, pthread_mutex_lock, pthread_mutex_trylock, 
pthread_mutex_unlock, pthread_mutex_destroy \- mutex 

.SH 
.B #include <pthread.h>

.BI "pthread_mutex_t " fastmutex " = PTHREAD_MUTEX_INITIALIZER;"

.BI "pthread_mutex_t " recmutex " = PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP;"

.BI "pthread_mutex_t " errchkmutex " = PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP;"

.BI "int pthread_mutex_init(pthread_mutex_t *" mutex ", const pthread_mutexattr_t *" mutexattr ");"

.BI "int pthread_mutex_lock(pthread_mutex_t *" mutex "));"

.BI "int pthread_mutex_trylock(pthread_mutex_t *" mutex ");"

.BI "int pthread_mutex_unlock(pthread_mutex_t *" mutex ");"

.BI "int pthread_mutex_destroy(pthread_mutex_t *" mutex ");"

.SH ""
mutex ϡ¾ (MUTual EXclusion) λȤߤǤꡢͭǡƱ
ݸƥ륻 (critical section) 
˥μʤɤ˻Ȥ롣

mutex Ĥξ֤ꤦ롣ϡå(ɤΥåɤˤ
ͭƤʤ)ȥå(ĤΥåɤͭƤ)Ǥ롣
Ĥΰۤʤ륹åɤƱ˰Ĥ mutex ͭ뤳ȤϤʤ¾
åɤˤäƥå줿 mutex å褦Ȥ륹åɤϡͭ
¦Υåɤˤ mutex 򥢥åޤǼ¹Ԥߤ롣

.B "pthread_mutex_init"

.I "mutex"
ؤ mutex ֥Ȥ
.IR "mutexattr"
ǻꤵ줿 mutex °֥Ȥ˽äƽ롣
.I "mutexattr"

.BR "NULL" ,
ʤСǥեȤ°Τ˻Ȥ롣

LinuxThreads μϤĤ°
.IR "mutex kind"
бƤ롣°ϡ®(``fast'')
ֺƵŪʡ(``recursive'')ޤ
֥顼Ԥʤ(``error checking'')Τ줫
ꤹΤǤ롣
mutex μ(kind)ϡ mutex ͭƤ륹åɤ
ƤӥåǤ뤫ɤꤹ롣
ǥեȤμ̤ϡ®פǤ롣mutex °Τܤϡ
.BR "pthread_mutexattr_init" (3)
򸫤衣

.B "pthread_mutex_t"
ѿϡ(® mutex Ф)
.B "PTHREAD_MUTEX_INITIALIZER"
ȡ(ƵŪ mutex Ф)
.B "PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP"
ӡ(顼Ԥʤ mutex Ф)
.B "PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP"
ǡŪ˽뤳ȤǤ롣

.B "pthread_mutex_lock"
ϡͿ줿 mutex å롣mutex ߥåƤʤС
ϥå졢ƤӽФåɤˤäƽͭ롣ξ
.B "pthread_mutex_lock"
ľ֤롣mutex ¾Υåɤˤäƴ˥åƤΤʤС
.B "pthread_mutex_lock"
 mutex åޤǸƤӽФåɤμ¹Ԥߤ롣

mutex ƤӽФ¦Υåɤˤ˥åƤˤϡ
.B "pthread_mutex_lock"
ο񤤤ϡmutex μ̤˰¸롣mutex μ̤®פǤС
ƤӽФåɤ mutex åޤǼ¹Ԥߤ롣
äƻ¾ƤӽФåɤΥǥåɥå
mutex μ̤֥顼åפǤС
.B "pthread_mutex_lock"
ϥ顼
.BR "EDEADLK"
ȤȤľ롣mutex μֺ̤ƵŪפʤС
.B "pthread_mutex_lock"
ľ롣κݡƤӽФåɤ mutex 
åϿ롣 mutex å֤ˤϡ
Ʊ
.B "pthread_mutex_unlock"
¹ԤͤФʤʤ

.B "pthread_mutex_trylock"

.BR "pthread_mutex_lock"
Ʊͤ˿񤦤mutex ¾Υåɤˤä
(뤤ϡ® mutex ξ硢ƤӽФåɤˤä)
åƤ硢ƤӽФåɤ֥åʤ
ˡ
.B "pthread_mutex_trylock"
ϥ顼
.BR "EBUSY"
ľ롣

.B "pthread_mutex_unlock"
ϡͿ줿 mutex 򥢥å롣
.BR "pthread_mutex_unlock"
γϻǡ mutex ϸƤӽФåɤˤå
ͭƤΤȲꤵ롣
 mutex ®׼̤ΤΤʤС
.B "pthread_mutex_unlock"
Ͼˤ򥢥å֤᤹줬ֺƵŪʡ׼̤ʤС
 mutex Υå׿( mutex Ф
.B "pthread_mutex_lock"
ƤӽФåɤǼ¹Ԥ줿)
ĸ餷η׿ˤʤäˡ mutex 
ºݤ˥å롣

֥顼򸡺mutex ФƤϡ
.B "pthread_mutex_unlock"
ϼ¹Ի˼ºݤˡmutex ϻǥåƤ뤫
ޤϸ
.BR "pthread_mutex_unlock"
ƤǤΤƱåɤˤäƥå줿ɤ򸡺롣
ξ郎ʤˤϡ顼ɤ֤졢mutex 
ѤΤޤޤˤ롣®mutex ȡֺƵŪʡmutex ϤΤ褦
åԤʤʤäơå줿 mutex ͭ԰ʳ
åɤˤäƥå뤳ȤǽˤƤ롣ϡܿ
ʤ񤤤Ǥꡢ˰¸褦ʤȤϤ٤Ǥʤ

.B "pthread_mutex_destroy"
ϡmutex ֥Ȥ˲줬ݻƤǽΤ
񸻤롣mutex ϴؿγϻǥåƤʤ
ʤʤLinuxThreads μǤϡʤ񸻤 mutex ֥Ȥ
տ路ƤʤΤ
.B "pthread_mutex_destroy"
ϼºݤΤȤmutex åƤ뤫ɤ򸡺
ʳΤȤϲ⤷ʤ

.SH "ä"

ʤ mutex ؿäݥȤǤϤʤ
.BR "pthread_mutex_lock"
Ǥ⡢줬Ǥդλ֥åɤμ¹ԤߤȤ
¤ˤؤ餺äݥȤǤϤʤˤꡢä
ݥȤˤ mutex ξ֤ͽ¬ǽȤʤꡢäϥɥ餬
åɤμ¹߰˥åɬפΤ mutex ޤˤ
ΤߤΤ˥å뤳ȤǽˤƤ롣η̡ٱ
äѤ륹åɤϡ褷;פʻ mutex ͭ뤳ȤϤʤ

.SH "ƱʥФ"

mutex ؿƱʥФưǤϤʤ
̣Ȥϡϥʥϥɥ餫Ƥ֤٤ǤϤʤ
ȤȤǤ롣ä
.B "pthread_mutex_lock"
ޤ
.B "pthread_mutex_unlock"
Υʥϥɥ餫θƤӽФϡƤӽФåɤǥå
å붲줬롣

.SH "֤"

.B "pthread_mutex_init"
ϡ 0 ֤¾ mutex ؿϡ 0 ֤
顼Ǥ󥼥Υ顼ɤ֤

.SH "顼"

.B "pthread_mutex_lock"
ϥ顼κݡΥ顼ɤ֤:
.RS
.TP
.B "EINVAL"
mutex Ŭڤ˽Ƥʤ

.TP
.B "EDEADLK"
mutex ϴ˸ƤӽФåɤˤåƤ롣
(֥顼Ԥʤ mutexes Τ)
.RE

.B "pthread_mutex_trylock"
ϥ顼κݡΥ顼ɤ֤:
.RS
.TP
.B "EBUSY"
ߥåƤΤ mutex Ǥʤ

.TP
.B "EINVAL"
mutex Ŭڤ˽Ƥʤ
.RE

.B O"pthread_mutex_unlock"
ϥ顼κݡΥ顼ɤ֤:
.RS
.TP
.B "EINVAL"
mutex Ŭڤ˽Ƥʤ

.TP
.B "EPERM"
ƤӽФåɤ mutex ͭƤʤ(֥顼򸡺 mutex Τ)
.RE

.B "pthread_mutex_destroy"
ϥ顼κݡΥ顼ɤ֤:
.RS
.TP
.B "EBUSY"
mutex ϸߥåƤ롣
.RE

.SH ""
Xavier Leroy <Xavier.Leroy@inria.fr>

.SH "Ϣ"
.BR "pthread_mutexattr_init" (3),
.BR "pthread_mutexattr_setkind_np" (3),
.BR "pthread_cancel" (3).

.SH ""

ͭѿ
.I "x"
 mutex ˤ꼡Τ褦ݸ:

.RS
.ft 3
.nf
.sp
int x;
pthread_mutex_t mut = PTHREAD_MUTEX_INITIALIZER;
.ft
.LP
.RE
.fi

Ƥ
.I "x"
ؤΥȤѹ
.B "pthread_mutex_lock"

.B "pthread_mutex_unlock"
ˤäơΤ褦˰ϤޤƤʤФʤʤ:

.RS
.ft 3
.nf
.sp
pthread_mutex_lock(&mut);
/* x  */
pthread_mutex_unlock(&mut);
.ft
.LP
.RE
.fi

[] glibc-linuxthreads κǿΥɥȤ Texinfo 󶡤Ƥ롣
εҤ glibc-linuxthreads-2.2 ʹߤǤʤ
ʲ glibc-linuxthreads-2.3.1  Texinfo ե뤫ΰѤǤ롣
 (kind)  (type) ѹƤ롣

LinuxThreads Ϥ 1 Ĥ mutex °бƤ롣
 mutex  (mutex type) ǡ
® (fast) סֺƵŪ (recursive) ס
ֻĤ (timed) ס֥顼Ԥʤ (error checking) פ
줫Ǥ롣
mutex ϡ
륹åɤʬȤǤǤݻƤ mutex åǤ뤫ɤ
ꤹ롣
ǥեȤ mutex ϡֻĤ (timed) פǤ롣

.B pthread_mutex_t
ѿϡ
.B "PTHREAD_MUTEX_INITIALIZER"
( Ĥ (timed) mutex  ) 
.B "PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP"
( ƵŪ (recursive) mutex  ) 
.B "PTHREAD_ADAPTIVE_MUTEX_INITIALIZER_NP"
( ® (fast) mutex  ) 
.B "PTHREAD_ERRORCHECK_MUTEX_INITIALIZER_NP"
( 顼Ԥʤ (error checking) mutex  ) Ѥ
Ū˽뤳ȤǤ롣