NAME

sched_yield — yield the processor

SYNOPSIS

#include <sched.h>

int sched_yield(void);


DESCRIPTION

The sched_yield() function shall force the running thread to relinquish the processor until it again becomes the head of its thread list. It takes no arguments.

RETURN VALUE

The sched_yield() function shall return 0 if it completes successfully; otherwise, it shall return a value of -1 and set errno to indicate the error.

ERRORS

No errors are defined.

EXAMPLES

None.

APPLICATION USAGE

The conceptual model for scheduling semantics in POSIX.1-2024 defines a set of thread lists. This set of thread lists is always present regardless of the scheduling options supported by the system. On a system where the Process Scheduling option is not supported, portable applications should not make any assumptions regarding whether threads from other processes will be on the same thread list.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

XBD <sched.h>

CHANGE HISTORY

First released in Issue 5. Included for alignment with the POSIX Realtime Extension and the POSIX Threads Extension.

Issue 6

The sched_yield() function is now marked as part of the Process Scheduling and Threads options.

Issue 7

SD5-XSH-ERN-120 is applied, adding APPLICATION USAGE.

The sched_yield() function is moved to the Base.