Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

pthread_yield(3)

pthread_delay_np(3)  —  Subroutines

NAME

pthread_delay_np − Causes a thread to wait for a specified period of time before continuing execution. 

SYNOPSIS

#include <pthread.h>
int pthread_delay_np(

struct timespec ∗interval );

PARAMETERS

intervalNumber of seconds and nanoseconds to delay execution.  The value specified for each must be greater than or equal to zero. 

DESCRIPTION

This routine causes a thread to delay execution for a specific period of time.  This period ends at the current time plus the specified interval.  The thread will not return before the end of the period is reached. 

Specifying an interval of 0 seconds and 0 nanoseconds is allowed and can result in the thread giving up the processor or delivering a pending cancel. 

The struct timespec structure contains two fields, as follows:

       •tv.sec is an integer number of seconds, and

       •tv.nsec is an integer number of nanoseconds. 

RETURN VALUES

If an error condition occurs, this routine returns −1 and sets errno to the corresponding error value. Possible return values are as follows:

Return Error Description
 0 Successful completion.
−1 [EINVAL] The value specified by interval is invalid.

RELATED INFORMATION

pthread_yield(3)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026