SCHED_YIELD

Section: Linux Programmer's Manual (2)
Updated: 1996-04-10
Index Return to Main Contents

NAME

sched_yield - yield the processor

SYNOPSIS

#include <sched.h>

int sched_yield(void);

DESCRIPTION

A process can relinquish the processor voluntarily without blocking by calling sched_yield(). The process will then be moved to the end of the queue for its static priority and a new process gets to run.

Note: If the calling process is the only process in the highest priority list at that time, this process will continue to run after a call to sched_yield().

POSIX systems on which sched_yield() is available define _POSIX_PRIORITY_SCHEDULING in <unistd.h>.

RETURN VALUE

On success, sched_yield() returns 0. On error, -1 is returned, and errno is set appropriately.

ERRORS

In the Linux implementation, sched_yield() always succeeds.

CONFORMING TO

POSIX.1-2001.

COLOPHON

This page is part of release 3.05 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.