| 1 | .\" Copyright (c) 1980 Regents of the University of California. |
| 2 | .\" All rights reserved. The Berkeley software License Agreement |
| 3 | .\" specifies the terms and conditions for redistribution. |
| 4 | .\" |
| 5 | .\" @(#)pause.3 6.1 (Berkeley) %G% |
| 6 | .\" |
| 7 | .TH PAUSE 3C "" |
| 8 | .UC 4 |
| 9 | .SH NAME |
| 10 | pause \- stop until signal |
| 11 | .SH SYNOPSIS |
| 12 | .B pause() |
| 13 | .SH DESCRIPTION |
| 14 | .I Pause |
| 15 | never returns normally. |
| 16 | It is used to give up control while waiting for |
| 17 | a signal from |
| 18 | .IR kill (2) |
| 19 | or an interval timer, see |
| 20 | .IR setitimer (2). |
| 21 | Upon termination of a signal handler started during a |
| 22 | .I pause, |
| 23 | the |
| 24 | .I pause |
| 25 | call will return. |
| 26 | .SH "RETURN VALUE |
| 27 | Always returns \-1. |
| 28 | .SH ERRORS |
| 29 | .I Pause |
| 30 | always returns: |
| 31 | .TP 15 |
| 32 | [EINTR] |
| 33 | The call was interrupted. |
| 34 | .SH "SEE ALSO |
| 35 | kill(2), select(2), sigpause(2) |