PTHREAD_MUTEX_INIT(3P)

🦋 PTHREAD_MUTEX_INIT(3P) 🦋

okay bestie, welcome to the POSIX Programmer's Manual — yes the whole entire manual, and this page is PTHREAD_MUTEX_INIT(3P), section 3P, we're in our POSIX era 💅

✨ PROLOG ✨

so like, real talk first 🫶 this manual page is part of the POSIX Programmer's Manual. the Linux implementation of this interface may differ (so pls go consult the corresponding Linux manual page for the deets on how Linux actually does it), or — and this is the part that hurts — the interface may not be implemented on Linux at all 😭

🌸 NAME 🌸

pthread_mutex_init — destroy and initialize a mutex

like yes it's giving "destroy" AND "initialize" in the same name, it's a whole duality, she contains multitudes 👑

🎀 SYNOPSIS 🎀

#include <pthread.h>

int pthread_mutex_init(pthread_mutex_t *restrict mutex,
    const pthread_mutexattr_t *restrict attr);
pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;

look at those restrict qualifiers, they're literally so iconic ✨ and yes that last line is a whole static initializer, PTHREAD_MUTEX_INITIALIZER, sitting there being all lowercase-but-shouting. no cap. 🔥

💖 DESCRIPTION 💖

okay so, plot twist — this page is not gonna explain itself. it just says:

Refer to pthread_mutex_destroy().

periodt. go read that one, she has the actual tea ☕ the mutex lore lives over there, iykyk.

👑 COPYRIGHT 👑

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

and also, fr fr:

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

and that's the whole page, babe 💜 IEEE/The Open Group, 2017 — mwah, PTHREAD_MUTEX_INIT(3P), signing off 🎀✨