Content-type: text/html Man page of pause

pause

Section: C Library Functions (3)
Index Return to Main Contents
 

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 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: 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


 

Index

NAME
LIBRARY
SYNOPSIS
STANDARDS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:30 GMT, October 02, 2010