[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

pthread_yield Subroutine

Purpose

Forces the calling thread to relinquish use of its processor.

Library

Threads Library (libpthreads.a)

Syntax

#include <pthread.h>
void pthread_yield ()

Description

The pthread_yield subroutine forces the calling thread to relinquish use of its processor, and to wait in the run queue before it is scheduled again. If the run queue is empty when the pthread_yield subroutine is called, the calling thread is immediately rescheduled.

If the thread has global contention scope (PTHREAD_SCOPE_SYSTEM), calling this subroutine acts like calling the yield subroutine. Otherwise, another local contention scope thread is scheduled.

The pthread.h header file must be the first included file of each source file using the threads library. Otherwise, the -D_THREAD_SAFE compilation flag should be used, or the cc_r compiler used. In this case, the flag is automatically set.

Implementation Specifics

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

Related Information

The yield subroutine and the sched_yield subroutine.

Threads Scheduling in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Threads Library Options and Threads Library Quick Reference in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Contents | Glossary | Home | Search ]