docs/reference/syscalls/thread_legacy_yield.md

<!-- Generated by zircon/scripts/update-docs-from-fidl, do not edit! -->
# zx_thread_legacy_yield

## Summary

Yield the CPU of the current thread back to the scheduler.

## Declaration

```c
#include <zircon/syscalls.h>

zx_status_t zx_thread_legacy_yield(uint32_t options);
```

## Description

`zx_thread_legacy_yield()` causes the calling thread to yield the CPU back to the scheduler.

 Yield may result in other threads with similar importance running ahead of the current thread,
 however, the exact behavior is unspecified.

 `options` must be zero.

## Rights

TODO(fxbug.dev/32253)

## Return value

`zx_thread_legacy_yield(uint32_t options)` will always return `ZX_OK` for zero `options`.
Any other `options` value, will result in `ZX_ERR_INVALID_ARGS`.

## See also

 - [`zx_nanosleep()`]

[`zx_nanosleep()`]: nanosleep.md