1pause(2)                         System Calls                         pause(2)
2
3
4

NAME

6       pause - suspend process until signal
7

SYNOPSIS

9       #include <unistd.h>
10
11       int pause(void);
12
13

DESCRIPTION

15       The  pause()  function suspends the calling process until it receives a
16       signal. The signal must be one that is not currently set to be  ignored
17       by the calling process.
18
19
20       If  the  signal causes termination of the calling process, pause() does
21       not return.
22
23
24       If the signal is caught by the calling process and control is  returned
25       from the signal-catching function (see signal(3C)), the calling process
26       resumes execution from the point of suspension.
27

RETURN VALUES

29       Since pause() suspends thread   execution  indefinitely  unless  inter‐
30       rupted by a signal, there is no successful completion return value.  If
31       interrupted, it returns −1 and sets errno to indicate the error.
32

ERRORS

34       The pause() function will fail if:
35
36       EINTR    A signal is caught by  the  calling  process  and  control  is
37                returned from the signal-catching function.
38
39

ATTRIBUTES

41       See attributes(5) for descriptions of the following attributes:
42
43
44
45
46       ┌─────────────────────────────┬─────────────────────────────┐
47       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
48       ├─────────────────────────────┼─────────────────────────────┤
49       │Interface Stability          │Standard                     │
50       ├─────────────────────────────┼─────────────────────────────┤
51       │MT-Level                     │Async-Signal-Safe            │
52       └─────────────────────────────┴─────────────────────────────┘
53

SEE ALSO

55       alarm(2), kill(2), signal(3C), wait(3C), attributes(5), standards(5)
56
57
58
59SunOS 5.11                        28 Dec 1996                         pause(2)
Impressum