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

SEE ALSO

sched_setscheduler(2) for a description of Linux scheduling.

Programming for the real world − POSIX.4 by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0

COLOPHON

This page is part of release 2.79 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/.