PTHREAD_RWLOCK_TIMEDWRLOCK(3)

🌸 PTHREAD_RWLOCK_TIMEDWRLOCK(3) 🌸

✨ NAME ✨

pthread_rwlock_timedwrlock — acquire a read-write lock for writing or give up after a specified period

🫶 LIBRARY 🫶

POSIX Threads Library (libpthread, -lpthread) — and yes bestie, this is a Library Functions Manual page. Manifesting that link line for you ✨

🎀 SYNOPSIS 🎀

#include <pthread.h>

int
pthread_rwlock_timedwrlock(pthread_rwlock_t *restrict rwlock,
    const struct timespec *restrict abs_timeout);

💖 DESCRIPTION 💖

Okay so this function acquires a write lock on the read-write lock rwlock. Main character energy only 🔥

But if the lock cannot be acquired without waiting for another thread to unlock the lock, this wait shall be terminated when abs_timeout expires. So you wait, but only until your deadline says “bestie, no” ⏰

If the thread should be interrupted by a signal, the pthread_rwlock_timedwrlock() function will be automatically restarted after the thread returns from the signal handler. Resilient queen behavior 💅

🚨 Deadlock warning: the calling thread may deadlock if at the time the call is made it holds rwlock. Like, do not do that to yourself, fr fr 😭

💀 Undefined alert: the results are undefined if this function is called with an uninitialized read-write lock. No cap, initialize it first.

🛠️ IMPLEMENTATION NOTES 🛠️

To prevent writer starvation, writers are favored over readers. Writers stay booked and busy, periodt 👑

🌈 RETURN VALUES 🌈

If successful, the pthread_rwlock_timedwrlock() function will return zero. Otherwise, an error number will be returned to indicate the error.

This function shall not return an error code of EINTR. Not a thing here, bestie 🚫

💀 ERRORS 💀

The pthread_rwlock_timedwrlock() function shall fail if:

• [ETIMEDOUT] — the lock could not be acquired before the specified timeout expired. Time’s up, icon 🕰️

The pthread_rwlock_timedwrlock() function may fail if:

• [EDEADLK] — the calling thread already holds rwlock. Self-deadlock vibes, absolutely not 🙈
• [EINVAL] — the value specified by rwlock does not refer to an initialized read-write lock object, or the abs_timeout nanosecond value is less than zero or greater than or equal to 1 billion. Check your numbers, babe 🔢

👀 SEE ALSO 👀

• pthread_rwlock_init(3)
• pthread_rwlock_timedrdlock(3)
• pthread_rwlock_unlock(3)

Go read the whole friend group, iykyk 🫶

⭐ STANDARDS ⭐

The pthread_rwlock_timedwrlock() function is expected to conform to ISO/IEC 9945-1:1996 (“POSIX.1”). Certified standards girlie behavior 💖

🦋 HISTORY 🦋

The pthread_rwlock_timedwrlock() function first appeared in FreeBSD 5.2. A historical slay ✨

---

Debian · August 17, 2018 · PTHREAD_RWLOCK_TIMEDWRLOCK(3) — that’s the footer, bestie, and we’re done. Mwah 💋🎀