1.\" $FreeBSD: head/share/man/man3/pthread_testcancel.3 251639 2013-06-11 21:40:20Z jilles $
2.Dd June 11, 2013
3.Dt PTHREAD_TESTCANCEL 3
4.Os
5.Sh NAME
6.Nm pthread_setcancelstate ,
7.Nm pthread_setcanceltype ,
8.Nm pthread_testcancel
9.Nd set cancelability state
10.Sh LIBRARY
--- 84 unchanged lines hidden (view full) ---
95If cancelability is disabled, the setting of the
96cancelability type has no immediate effect as all cancellation requests
97are held pending; however, once cancelability is enabled again the new
98type will be in effect.
99.El
100.Ss Cancellation Points
101Cancellation points will occur when a thread is executing the following
102functions:
103.Fn accept ,
104.Fn accept4 ,
105.Fn aio_suspend ,
106.Fn connect ,
107.Fn close ,
108.Fn creat ,
109.Fn fsync ,
110.Fn mq_receive ,
111.Fn mq_send ,
112.Fn mq_timedreceive ,
113.Fn mq_timedsend ,
114.Fn msync ,
115.Fn nanosleep ,
116.Fn open ,
117.Fn openat ,
118.Fn pause ,
119.Fn poll ,
120.Fn pselect ,
121.Fn pthread_cond_timedwait ,
122.Fn pthread_cond_wait ,
123.Fn pthread_join ,
124.Fn pthread_testcancel ,
125.Fn read ,
126.Fn readv ,
127.Fn recv ,
128.Fn recvfrom ,
129.Fn recvmsg ,
130.Fn select ,
131.Fn sem_timedwait ,
132.Fn sem_wait ,
133.Fn send ,
134.Fn sendmsg ,
135.Fn sendto ,
136.Fn sigsuspend ,
137.Fn sigtimedwait ,
138.Fn sigwaitinfo ,
139.Fn sigwait ,
140.Fn sleep ,
141.Fn system ,
142.Fn tcdrain ,
143.Fn usleep ,
144.Fn wait ,
145.Fn wait3 ,
146.Fn wait4 ,
147.Fn waitpid ,
148.Fn write ,
149.Fn writev .
150The
151.Fn fcntl
152function is a cancellation point if
153.Fa cmd
154is
155.Dv F_SETLKW .
156.Sh RETURN VALUES
157If successful, the
158.Fn pthread_setcancelstate
159and
160.Fn pthread_setcanceltype
161functions will return zero.
162Otherwise, an error number shall be returned to
163indicate the error.
--- 63 unchanged lines hidden (view full) ---
227.El
228.Sh SEE ALSO
229.Xr pthread_cancel 3
230.Sh STANDARDS
231The
232.Fn pthread_testcancel
233function conforms to
234.St -p1003.1-96 .
235The standard allows implementations to make many more functions
236cancellation points.
237.Sh AUTHORS
238This manual page was written by
239.An David Leonard Aq d@openbsd.org
240for the
241.Ox
242implementation of
243.Xr pthread_cancel 3 .
2.Dd June 11, 2013
3.Dt PTHREAD_TESTCANCEL 3
4.Os
5.Sh NAME
6.Nm pthread_setcancelstate ,
7.Nm pthread_setcanceltype ,
8.Nm pthread_testcancel
9.Nd set cancelability state
10.Sh LIBRARY
--- 84 unchanged lines hidden (view full) ---
95If cancelability is disabled, the setting of the
96cancelability type has no immediate effect as all cancellation requests
97are held pending; however, once cancelability is enabled again the new
98type will be in effect.
99.El
100.Ss Cancellation Points
101Cancellation points will occur when a thread is executing the following
102functions:
103.Fn accept ,
104.Fn accept4 ,
105.Fn aio_suspend ,
106.Fn connect ,
107.Fn close ,
108.Fn creat ,
109.Fn fsync ,
110.Fn mq_receive ,
111.Fn mq_send ,
112.Fn mq_timedreceive ,
113.Fn mq_timedsend ,
114.Fn msync ,
115.Fn nanosleep ,
116.Fn open ,
117.Fn openat ,
118.Fn pause ,
119.Fn poll ,
120.Fn pselect ,
121.Fn pthread_cond_timedwait ,
122.Fn pthread_cond_wait ,
123.Fn pthread_join ,
124.Fn pthread_testcancel ,
125.Fn read ,
126.Fn readv ,
127.Fn recv ,
128.Fn recvfrom ,
129.Fn recvmsg ,
130.Fn select ,
131.Fn sem_timedwait ,
132.Fn sem_wait ,
133.Fn send ,
134.Fn sendmsg ,
135.Fn sendto ,
136.Fn sigsuspend ,
137.Fn sigtimedwait ,
138.Fn sigwaitinfo ,
139.Fn sigwait ,
140.Fn sleep ,
141.Fn system ,
142.Fn tcdrain ,
143.Fn usleep ,
144.Fn wait ,
145.Fn wait3 ,
146.Fn wait4 ,
147.Fn waitpid ,
148.Fn write ,
149.Fn writev .
150The
151.Fn fcntl
152function is a cancellation point if
153.Fa cmd
154is
155.Dv F_SETLKW .
156.Sh RETURN VALUES
157If successful, the
158.Fn pthread_setcancelstate
159and
160.Fn pthread_setcanceltype
161functions will return zero.
162Otherwise, an error number shall be returned to
163indicate the error.
--- 63 unchanged lines hidden (view full) ---
227.El
228.Sh SEE ALSO
229.Xr pthread_cancel 3
230.Sh STANDARDS
231The
232.Fn pthread_testcancel
233function conforms to
234.St -p1003.1-96 .
235The standard allows implementations to make many more functions
236cancellation points.
237.Sh AUTHORS
238This manual page was written by
239.An David Leonard Aq d@openbsd.org
240for the
241.Ox
242implementation of
243.Xr pthread_cancel 3 .