summaryrefslogtreecommitdiff
path: root/reference/C/MAN/longjmp.htm
blob: ba1bbb8afc3dc94306f93f653dab8b15db52e89c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<TITLE>longjmp</TITLE>
<body bgcolor="#ffffcc">
<hr>
<pre>



<h3>LONGJMP(3)              Library functions              LONGJMP(3)
</h3>

<h3>NAME
</h3>       longjmp - non-local jump to a saved stack context

<h3>SYNOPSIS
</h3>       #include &lt;setjmp.h&gt;

       void longjmp(jmp_buf env, int val);

<h3>DESCRIPTION
</h3>       longjmp() and setjmp(3) are useful for dealing with errors
       and interrupts encountered in a low-level subroutine of  a
       program.   longjmp() restores the environment saved by the
       last call of setjmp() with the corresponding env argument.
       After  longjmp() is completed, program execution continues
       as if the corresponding call of setjmp() had just returned
       the  value  val.  longjmp() cannot cause 0 to be returned.
       If longjmp is invoked with a second argument of 0, 1  will
       be returned instead.

<h3>RETURN VALUE
</h3>       This function never returns.

<h3>CONFORMING TO
</h3>       POSIX

<h3>NOTES
</h3>       POSIX  does  not  specify  if  the  signal context will be
       restored or not.  If  you  want  to  save  restore  signal
       masks,  use siglongjmp(3) longjmp() makes programs hard to
       understand  and  maintain.   If  possible  an  alternative
       should be used.

</pre>
<hr>
<h3>SEE ALSO
</h3><p>
<a href=setjmp.htm>setjmp</a>, 
<a href=sigsetjmp.htm>sigsetjmp</a>, 
<a href=siglongjmp.htm>siglongjmp</a>, 
<pre>























                        November 25, 1994                       1



</pre>
<P>
<hr>
<p>
<center>
<table border=2 width=80%>
<tr align=center>
<td width=25%>
<a href=../cref.html>Top</a>
</td><td width=25%>
<a href=../master_index.html>Master Index</a>
</td><td width=25%>
<a href=../SYNTAX/keywords.html>Keywords</a>
</td><td width=25%>
<a href=../FUNCTIONS/funcref.htm>Functions</a>
</td>
</tr>
</table>
</center>
<p>
<hr>

This manual page was brought to you by <i>mjl_man V-2.0</i>