POSIX_T...TLOGSIZE(3POSIX)

💅 POSIX_T...TLOGSIZE — bestie edition ✨

ok so this is a page from the POSIX Programmer's Manual, section 3POSIX, and the stars of the show are posix_trace_attr_setlogsize and posix_trace_attr_setmaxdatasize. 🎀

🌸 PROLOG 🌸

okay real talk first, bestie, because this matters: this manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ — so go consult the corresponding Linux manual page for the deets on Linux behavior. Or, plot twist, the interface may not be implemented on Linux at all. 🙈 So like. vibe check your platform first, fr fr.

✨ NAME ✨

posix_trace_attr_setlogsize, posix_trace_attr_setmaxdatasize — retrieve and set trace stream size attributes (TRACING) 👑

yes the NAME section says "retrieve and set" even though these two are the setters. not my business. the manpage said it, I'm repeating it, periodt. 💅

🦋 SYNOPSIS 🦋

#include <sys/types.h>
#include <trace.h>

int posix_trace_attr_setlogsize(trace_attr_t *attr,
    size_t logsize);
int posix_trace_attr_setmaxdatasize(trace_attr_t *attr,
    size_t maxdatasize);

look at those signatures. two ints, two trace_attr_t *s, two size_ts. symmetrical. iconic. 🌈

💖 DESCRIPTION 💖

okay so here's the thing — this page is literally just a pointer. Refer to posix_trace_attr_getlogsize(). that's it. that's the whole description. go read that one, bestie, it's got the actual lore. 🫶

🎀 COPYRIGHT 🎀

ngl this part is the serious part so pay attention:

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 .

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, bestie!! 💜 this one dropped in 2017 courtesy of IEEE/The Open Group, filed under POSIX_T...TLOGSIZE(3POSIX) — short king of a manpage, but every byte accounted for. slay. 💅✨🌸