MQ_TIMEDRECEIVE(3POSIX)

🌸 mq_timedreceive — the POSIX girlies' guide to grabbing messages on a deadline ✨

okay bestie, real talk: this is a page from the POSIX Programmer's Manual 💖 (that's the POSIX Programmer's Manual, in case the header didn't already scream it at you).

🫶 PROLOG

so like, heads up before we go any further: this manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or — and this is the messy part — the interface may not be implemented on Linux at all. 😭 no cap, check first.

✨ NAME ✨

mq_timedreceive — receive a message from a message queue (ADVANCED REALTIME 👑). yes, it's giving advanced realtime, she's fancy, we love her.

🎀 SYNOPSIS 🎀

#include <mqueue.h>
#include <time.h>

ssize_t mq_timedreceive(mqd_t mqdes, char *restrict msg_ptr,
    size_t msg_len, unsigned *restrict msg_prio,
    const struct timespec *restrict abstime);

look at those restrict qualifiers, iconic 💅

💜 DESCRIPTION 💜

Refer to mq_receive(). that's it, that's the whole description — she's a little sister function and she's pointing you at her big sister. go read mq_receive(), iykyk 🦋

🌈 COPYRIGHT 🌈

ngl this next part is the legal bit and it is long, but we do not skip the boring parts in this house, so here it is, word for word:

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 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 .

okay that's the whole page, you ate it, slay 🍓✨

cute little sign-off, since we're not doing boring footers around here: this one comes from IEEE/The Open Group, dated 2017, and it lives under the manual name MQ_TIMEDRECEIVE(3POSIX). periodt 💅🧚💖