Index for Section 3

Alphabetical listing for P

Bottom of page

pause(3)
NAME
  pause - Suspends a process until it receives a signal

SYNOPSIS
  #include <unistd.h>

  int pause(
	  void );

LIBRARY
  Standard C Library (libc)

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  pause():  POSIX.1, XPG4, XPG4-UNIX

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

DESCRIPTION
  The pause() function suspends the calling process until it receives a
  signal whose action is either to execute a signal-catching function or
  terminate the process.  The signal must be one that is acknowledged by the
  calling process. The pause() function does not affect the action taken when
  a signal is received.

  The pause() function suspends the calling process by suspending the calling
  thread. Other threads in the process, if any, are not suspended.

RETURN VALUES
  When the received signal causes the calling process to terminate, the
  pause() function does not return.

  When the signal is caught by the calling process and control is returned
  from the signal-catching function, the calling thread resumes execution
  from the point of suspension. At that point, the pause() function returns a
  value of -1 and sets errno to indicate the error.

ERRORS
  The pause() function sets errno to the specified values for the following
  conditions:

  [EINTR]
      The signal has been caught by the calling process and control has been
      returned from the signal-catching function.

SEE ALSO
  Functions: kill(2), sigaction(2), sigvec(2), wait(2)

  Routines: alarm(3)

  Standards: standards(5)

Index for Section 3

Alphabetical listing for P

Top of page