pthreads.7: Added description of async-cancel-safe functions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-11-14 06:55:39 +01:00
parent 0ff2cc8848
commit 07451ab1b9
1 changed files with 16 additions and 1 deletions

View File

@ -21,7 +21,7 @@
.\" Formatted or processed versions of this manual, if unaccompanied by .\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work. .\" the source, must acknowledge the copyright and authors of this work.
.\" .\"
.TH PTHREADS 7 2008-11-18 "Linux" "Linux Programmer's Manual" .TH PTHREADS 7 2010-11-14 "Linux" "Linux Programmer's Manual"
.SH NAME .SH NAME
pthreads \- POSIX threads pthreads \- POSIX threads
.SH DESCRIPTION .SH DESCRIPTION
@ -231,6 +231,21 @@ wcstombs()
wctomb() wctomb()
.fi .fi
.in .in
.SS Async-cancel-safe functions
An async-cancel-safe function is one that can be safely called
in an application where asynchronous cancelability is enabled (see
.BR pthread_setcancelstate (3)).
Only the following functions are required to be async-cancel-safe by
POSIX.1-2001 and POSIX.1-2008:
.in +4n
.nf
pthread_cancel()
pthread_setcancelstate()
pthread_setcanceltype()
.fi
.in
.SS Cancellation Points .SS Cancellation Points
POSIX.1 specifies that certain functions must, POSIX.1 specifies that certain functions must,
and certain other functions may, be cancellation points. and certain other functions may, be cancellation points.