---
name: "sched_yield"
section: "2freebsd"
platform: "linux"
package: "freebsd-manpages"
version: "12.2-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/sched_yield/2freebsd"
---

# sched\_yield(2freebsd)

yield processor

## NAME

**sched\_yield** – yield processor

## LIBRARY

Standard C Library (libc, -lc)

## SYNOPSIS

**#include \<sched.h\>**

*int*\

**sched\_yield**(*void*);

## DESCRIPTION

The **sched\_yield**() system call forces the running process to relinquish the processor until it again becomes the head of its process list. It takes no arguments.

## RETURN VALUES

The **sched\_yield()** function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

## ERRORS

On failure *errno* will be set to the corresponding value:

- \[ENOSYS\]

  The system is not configured to support this functionality.

## STANDARDS

The **sched\_yield**() system call conforms to IEEE Std 1003.1b-1993 (“POSIX.1b”).