[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Base Operating System and Extensions Technical Reference, Volume 1

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

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The incinterval, alarm, or settimer subroutine, kill or killpg subroutine, sigaction, sigvec, or signal subroutine, wait, waitpid, or wait3 subroutine.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]