man/man2/pause.2

   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.3c    6.1 (Berkeley) 5/9/85
   6 .\"
   7 .TH PAUSE 2 "May 9, 1985"
   8 .UC 4
   9 .SH NAME
  10 pause \- stop until signal
  11 .SH SYNOPSIS
  12 .nf
  13 .ft B
  14 #include <unistd.h>
  15
  16 int pause(void)
  17 .ft R
  18 .fi
  19 .SH DESCRIPTION
  20 .B Pause
  21 never returns normally.
  22 It is used to give up control while waiting for
  23 a signal from
  24 .BR kill (2)
  25 or the alarm timer, see
  26 .BR alarm (2).
  27 Upon termination of a signal handler started during a
  28 .B pause,
  29 the
  30 .B pause
  31 call will return.
  32 .SH "RETURN VALUE
  33 Always returns \-1.
  34 .SH ERRORS
  35 .B Pause
  36 always returns:
  37 .TP 15
  38 [EINTR]
  39 The call was interrupted.
  40 .SH "SEE ALSO
  41 .BR alarm (2),
  42 .BR kill (2),
  43 .BR sigsuspend (2).