1RAISE(P)                   POSIX Programmer's Manual                  RAISE(P)
2
3
4

NAME

6       raise - send a signal to the executing process
7

SYNOPSIS

9       #include <signal.h>
10
11       int raise(int sig);
12
13

DESCRIPTION

15       The  raise()  function  shall  send  the  signal  sig  to the executing
16        thread or process.  If a signal handler is called, the  raise()  func‐
17       tion shall not return until after the signal handler does.
18
19       If  the  implementation  supports the Threads option, the effect of the
20       raise() function shall be equivalent to calling:
21
22
23              pthread_kill(pthread_self(), sig);
24
25       Otherwise, the effect of the raise() function shall  be  equivalent  to
26       calling:
27
28
29              kill(getpid(), sig);
30

RETURN VALUE

32       Upon  successful completion, 0 shall be returned. Otherwise, a non-zero
33       value shall be returned    and errno  shall  be  set  to  indicate  the
34       error.
35

ERRORS

37       The raise() function shall fail if:
38
39       EINVAL The value of the sig argument is an invalid signal number.
40
41
42       The following sections are informative.
43

EXAMPLES

45       None.
46

APPLICATION USAGE

48       None.
49

RATIONALE

51       The term "thread" is an extension to the ISO C standard.
52

FUTURE DIRECTIONS

54       None.
55

SEE ALSO

57       kill()    ,    sigaction()   ,   the   Base   Definitions   volume   of
58       IEEE Std 1003.1-2001, <signal.h>, <sys/types.h>
59

61       Portions of this text are reprinted and reproduced in  electronic  form
62       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
63       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
64       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
65       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
66       event of any discrepancy between this version and the original IEEE and
67       The Open Group Standard, the original IEEE and The Open Group  Standard
68       is  the  referee document. The original Standard can be obtained online
69       at http://www.opengroup.org/unix/online.html .
70
71
72
73IEEE/The Open Group                  2003                             RAISE(P)
Impressum