man2/pause.2

   1 .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
   2 .\"
   3 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   4 .\"
   5 .\" Modified by Michael Haardt (michael@moria.de)
   6 .\" Modified Sat Jul 24 14:48:00 1993 by Rik Faith (faith@cs.unc.edu)
   7 .\" Modified 1995 by Mike Battersby (mib@deakin.edu.au)
   8 .\" Modified 2000 by aeb, following Michael Kerrisk
   9 .\"
  10 .TH pause 2 (date) "Linux man-pages (unreleased)"
  11 .SH NAME
  12 pause \- wait for signal
  13 .SH LIBRARY
  14 Standard C library
  15 .RI ( libc ", " \-lc )
  16 .SH SYNOPSIS
  17 .nf
  18 .B #include <unistd.h>
  19 .PP
  20 .B int pause(void);
  21 .fi
  22 .SH DESCRIPTION
  23 .BR pause ()
  24 causes the calling process (or thread) to sleep
  25 until a signal is delivered that either terminates the process or causes
  26 the invocation of a signal-catching function.
  27 .SH RETURN VALUE
  28 .BR pause ()
  29 returns only when a signal was caught and the
  30 signal-catching function returned.
  31 In this case,
  32 .BR pause ()
  33 returns \-1, and
  34 .I errno
  35 is set to
  36 .\" .BR ERESTARTNOHAND .
  37 .BR EINTR .
  38 .SH ERRORS
  39 .TP
  40 .B EINTR
  41 a signal was caught and the signal-catching function returned.
  42 .SH STANDARDS
  43 POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.
  44 .SH SEE ALSO
  45 .BR kill (2),
  46 .BR select (2),
  47 .BR signal (2),
  48 .BR sigsuspend (2)