pause Subroutine

Purpose

Suspends a process until a signal is received.

Library

Standard C Library (libc.a)

Syntax

#include <unistd.h>

int pause (void)

Description

The pause subroutine suspends the calling process until it receives a signal. The signal must not be one that is ignored by the calling process. The pause subroutine does not affect the action that is taken upon the receipt of a signal.

Return Values

If the signal received causes the calling process to end, the pause subroutine does not return.

If the signal is caught by the calling process and control is returned from the signal-catching function, the calling process resumes execution from the point of suspension. The pause subroutine returns a value of -1 and sets the errno global variable to EINTR.