xref: /csrg-svn/lib/libc/gen/pause.3 (revision 48352)
1*48352Scael.\" Copyright (c) 1980, 1991 Regents of the University of California.
2*48352Scael.\" All rights reserved.
320171Smckusick.\"
4*48352Scael.\" %sccs.include.redist.man%
520171Smckusick.\"
6*48352Scael.\"     @(#)pause.3	6.3 (Berkeley) 04/19/91
7*48352Scael.\"
8*48352Scael.Dd
9*48352Scael.Dt PAUSE 3
10*48352Scael.Os BSD 4
11*48352Scael.Sh NAME
12*48352Scael.Nm pause
13*48352Scael.Nd stop until signal
14*48352Scael.Sh SYNOPSIS
15*48352Scael.Fd #include <unistd.h>
16*48352Scael.Ft int
17*48352Scael.Fn pause void
18*48352Scael.Sh DESCRIPTION
19*48352Scael.Bf -symbolic
2037379SbosticPause is made obsolete by sigpause(3).
21*48352Scael.Ef
22*48352Scael.Pp
23*48352ScaelThe
24*48352Scael.Fn pause
25*48352Scaelfunction
26*48352Scaelforces a process to pause until
27*48352Scaela signal is received from either the
28*48352Scael.Xr kill 2
29*48352Scaelfunction
30*48352Scaelor an interval timer.
31*48352Scael(See
32*48352Scael.Xr setitimer 2 . )
3320171SmckusickUpon termination of a signal handler started during a
34*48352Scael.Fn pause ,
3520171Smckusickthe
36*48352Scael.Fn pause
3720171Smckusickcall will return.
38*48352Scael.Sh RETURN VALUES
3920172SmckusickAlways returns \-1.
40*48352Scael.Sh ERRORS
41*48352ScaelThe
42*48352Scael.Fn pause
43*48352Scaelfunction
4420172Smckusickalways returns:
45*48352Scael.Bl -tag -width [EINTR]
46*48352Scael.It Bq Er EINTR
4720172SmckusickThe call was interrupted.
48*48352Scael.El
49*48352Scael.Sh SEE ALSO
50*48352Scael.Xr kill 2 ,
51*48352Scael.Xr select 2 ,
52*48352Scael.Xr sigpause 2
53*48352Scael.Sh HISTORY
54*48352ScaelA
55*48352Scael.Fn pause
56*48352Scaelsyscall
57*48352Scaelappeared in
58*48352Scael.At v6 .
59