pause(3)						     Library Functions Manual							  pause(3)

NAME

       pause - Suspends a process until it receives a signal

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <unistd.h>

       int pause( void );

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 sus-
       pended.

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 exe-
       cution 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: The signal has been caught by the calling process and
       control has been returned from the signal-catching function.

RELATED INFORMATION

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

       Routines: alarm(3)

       Standards: standards(5) delim off

																	  pause(3)