xref: /freebsd-src/share/man/man3/pthread_suspend_all_np.3 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
1318d8cfdSAlexey Zelkin.\" Copyright (c) 2003 Alexey Zelkin <phantom@FreeBSD.org>
2318d8cfdSAlexey Zelkin.\" All rights reserved.
3318d8cfdSAlexey Zelkin.\"
4318d8cfdSAlexey Zelkin.\" Redistribution and use in source and binary forms, with or without
5318d8cfdSAlexey Zelkin.\" modification, are permitted provided that the following conditions
6318d8cfdSAlexey Zelkin.\" are met:
7318d8cfdSAlexey Zelkin.\" 1. Redistributions of source code must retain the above copyright
8318d8cfdSAlexey Zelkin.\"    notice, this list of conditions and the following disclaimer.
9318d8cfdSAlexey Zelkin.\" 2. Redistributions in binary form must reproduce the above copyright
10318d8cfdSAlexey Zelkin.\"    notice, this list of conditions and the following disclaimer in the
11318d8cfdSAlexey Zelkin.\"    documentation and/or other materials provided with the distribution.
12318d8cfdSAlexey Zelkin.\"
13318d8cfdSAlexey Zelkin.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14318d8cfdSAlexey Zelkin.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15318d8cfdSAlexey Zelkin.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16318d8cfdSAlexey Zelkin.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17318d8cfdSAlexey Zelkin.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18318d8cfdSAlexey Zelkin.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19318d8cfdSAlexey Zelkin.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20318d8cfdSAlexey Zelkin.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21318d8cfdSAlexey Zelkin.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22318d8cfdSAlexey Zelkin.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23318d8cfdSAlexey Zelkin.\" SUCH DAMAGE.
24318d8cfdSAlexey Zelkin.\"
25*df7d7638SFelix Johnson.Dd October 12, 2021
26318d8cfdSAlexey Zelkin.Dt PTHREAD_SUSPEND_ALL_NP 3
27318d8cfdSAlexey Zelkin.Os
28318d8cfdSAlexey Zelkin.Sh NAME
29318d8cfdSAlexey Zelkin.Nm pthread_suspend_all_np
30318d8cfdSAlexey Zelkin.Nd suspend all active threads
31318d8cfdSAlexey Zelkin.Sh LIBRARY
32ec7452f1SRuslan Ermilov.Lb libpthread
33318d8cfdSAlexey Zelkin.Sh SYNOPSIS
34318d8cfdSAlexey Zelkin.In pthread_np.h
35318d8cfdSAlexey Zelkin.Ft void
36ace5be68SRuslan Ermilov.Fn pthread_suspend_all_np void
37318d8cfdSAlexey Zelkin.Sh DESCRIPTION
38318d8cfdSAlexey ZelkinThe
39318d8cfdSAlexey Zelkin.Fn pthread_suspend_all_np
40ace5be68SRuslan Ermilovfunction causes all active threads to be suspended.
41ace5be68SRuslan ErmilovThe only exception is the current thread,
42ace5be68SRuslan Ermilovthe thread that called the
43318d8cfdSAlexey Zelkin.Fn pthread_suspend_all_np
44318d8cfdSAlexey Zelkinfunction.
459c671dbdSKonstantin Belousov.Pp
469c671dbdSKonstantin BelousovIt is not safe for the caller of the
479c671dbdSKonstantin Belousov.Fn pthread_suspend_all_np
489c671dbdSKonstantin Belousovfunction to use any non-async signal safe functions, besides
499c671dbdSKonstantin Belousov.Xr pthread_resume_all_np 3 ,
509c671dbdSKonstantin Belousovuntil threads are resumed, unless measures are taken to ensure
519c671dbdSKonstantin Belousovthat all threads are suspended at safe points.
52318d8cfdSAlexey Zelkin.Sh SEE ALSO
53*df7d7638SFelix Johnson.Xr pthread_np 3 ,
54318d8cfdSAlexey Zelkin.Xr pthread_resume_all_np 3 ,
55318d8cfdSAlexey Zelkin.Xr pthread_resume_np 3 ,
56318d8cfdSAlexey Zelkin.Xr pthread_suspend_np 3
57318d8cfdSAlexey Zelkin.Sh AUTHORS
58ace5be68SRuslan ErmilovThis manual page was written by
59a63d6c94SBaptiste Daroussin.An Alexey Zelkin Aq Mt phantom@FreeBSD.org .
60