---
name: "futex_top_waiter"
section: "9"
platform: "linux"
package: "linux-manual-4.9"
version: "4.9.228-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/futex_top_waiter"
---

# futex\_top\_waiter(9)

Return the highest priority waiter on a futex

## NAME

futex\_top\_waiter - Return the highest priority waiter on a futex

## SYNOPSIS

**struct futex\_q \* futex\_top\_waiter(struct futex\_hash\_bucket \*** *hb***, union futex\_key \*** *key***);**

## ARGUMENTS

*hb*

the hash bucket the futex\_q's reside in

*key*

the futex key (to distinguish it from other futex futex\_q's)

## DESCRIPTION

Must be called with the hb lock held.

## AUTHOR

**Rusty Russell** \<rusty@rustcorp.com.au\>

Author.

## COPYRIGHT
