---
name: "pthread_yield"
section: "3"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["linux", "freebsd"]
url: "https://new.carta.tech/pthread_yield"
---

# pthread\_yield(3)

yield control of the current thread

## NAME

**pthread\_yield** – yield control of the current thread

## LIBRARY

POSIX Threads Library (libpthread, -lpthread)

## SYNOPSIS

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

*void*\

**pthread\_yield**(*void*);

## DESCRIPTION

The **pthread\_yield**() forces the running thread to relinquish the processor until it again becomes the head of its thread list.

## SEE ALSO

[sched\_yield(2)](/sched_yield/2.md)

## STANDARDS

The **pthread\_yield**() is a non-portable (but quite common) extension to IEEE Std 1003.1-2001 (“POSIX.1”).