Movatterモバイル変換

sched_yield(2) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ERRORS \|STANDARDS \|HISTORY \|CAVEATS \|SEE ALSO \|COLOPHON

sched_yield(2)             System Calls Manualsched_yield(2)

NAME top

       sched_yield - yield the processor

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <sched.h>int sched_yield(void);

DESCRIPTION top

sched_yield() causes the calling thread to relinquish the CPU.       The thread is moved to the end of the queue for its static       priority and a new thread gets to run.

RETURN VALUE top

       On success,sched_yield() returns 0.  On error, -1 is returned,       anderrno is set to indicate the error.

ERRORS top

       In the Linux implementation,sched_yield() always succeeds.

STANDARDS top

       POSIX.1-2008.

HISTORY top

       POSIX.1-2001 (but optional).  POSIX.1-2008.       Before POSIX.1-2008, systems on whichsched_yield() is available       defined_POSIX_PRIORITY_SCHEDULINGin<unistd.h>.

CAVEATS top

sched_yield() is intended for use with real-time scheduling       policies (i.e.,SCHED_FIFOorSCHED_RR).  Use ofsched_yield()       with nondeterministic scheduling policies such asSCHED_OTHERis       unspecified and very likely means your application design is       broken.       If the calling thread is the only thread in the highest priority       list at that time, it will continue to run after a call tosched_yield().       Avoid callingsched_yield() unnecessarily or inappropriately       (e.g., when resources needed by other schedulable threads are       still held by the caller), since doing so will result in       unnecessary context switches, which will degrade system       performance.

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17sched_yield(2)

Pages that refer to this page:getrlimit(2), sched_setattr(2), sched_setscheduler(2), syscalls(2), pthread_yield(3), sched(7)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface.

For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere.

Hosting byjambit GmbH.