sched_yield(2)

sched_yield2

Yield processor

Usage

#include <sched.h>

int

sched_yield(void);

Library

Standard C Library (libc, -lc)

Overview

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.

Releases

77 releases since FreeBSD 3.0-RELEASE; the text changed 42 times.

  1. 3.0–3.2
  2. 3.3–3.4
  3. 3.5–3.5.1
  4. 4.0
  5. 4.1–4.2
  6. 4.3
  7. 4.4
  8. 4.5–4.11
  9. 5.0
  10. 5.1–5.2.1
  11. 5.3–6.3
  12. 6.4
  13. 7.0
  14. 7.1
  15. 7.2
  16. 7.3
  17. 7.4
  18. 8.0
  19. 8.1
  20. 8.2
  21. 8.3
  22. 8.4
  23. 9.0
  24. 9.1
  25. 9.2
  26. 9.3
  27. 10.0
  28. 10.1
  29. 10.2
  30. 10.3
  31. 10.4
  32. 11.0
  33. 11.1
  34. 11.2
  35. 11.3
  36. 11.4
  37. 12.0
  38. 12.1
  39. 12.2
  40. 12.3
  41. 12.4
  42. 13.0–13.2
  43. 13.3–16.0

Standards

The sched_yield() system call conforms to IEEE Std 1003.1b-1993 (“POSIX.1b”).

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.