POSIX_S...ETFLAGS(3POSIX)

💖 POSIX_S...ETFLAGS(3POSIX) 💖

okay bestie, welcome to the POSIX Programmer's Manual, page POSIX_S...ETFLAGS(3POSIX). we're getting into spawn attributes today and honestly? it's giving advanced realtime, so buckle up 🎀

---

✨ PROLOG ✨

so this manual page is part of the POSIX Programmer's Manual, periodt. but heads up bestie: the Linux implementation of this interface may differ (so pls go check the corresponding Linux manual page for the deets on Linux behavior), or like… the interface might not even be implemented on Linux at all 🙈. no cap.

---

🌸 NAME 🌸

posix_spawnattr_getflags, posix_spawnattr_setflags — get and set the spawn-flags attribute of a spawn attributes object (ADVANCED REALTIME 👑)

---

✨ SYNOPSIS ✨

#include <spawn.h>

int posix_spawnattr_getflags(const posix_spawnattr_t *restrict attr,
    short *restrict flags);
int posix_spawnattr_setflags(posix_spawnattr_t *attr, short flags);

---

🦋 DESCRIPTION 🦋

okay so the posix_spawnattr_getflags() function shall obtain the value of the spawn-flags attribute from the attributes object referenced by attr. that's the whole vibe. get the flags. slay.

and the posix_spawnattr_setflags() function shall set the spawn-flags attribute in an initialized attributes object referenced by attr. you're setting it, bestie 💅.

now the spawn-flags attribute is what tells you which process attributes are gonna be changed in the new process image when you invoke posix_spawn() or posix_spawnp(). it's the bitwise-inclusive OR of zero or more of these flags:

• POSIX_SPAWN_RESETIDS
• POSIX_SPAWN_SETPGROUP
• POSIX_SPAWN_SETSIGDEF
• POSIX_SPAWN_SETSIGMASK
• POSIX_SPAWN_SETSCHEDPARAM
• POSIX_SPAWN_SETSCHEDULER

these flags are defined in <spawn.h> 🫶. and the default value of this attribute shall be as if no flags were set — so like, blank slate, clean girl aesthetic, zero flags, iconic.

---

🌈 RETURN VALUE 🌈

upon successful completion, posix_spawnattr_getflags() shall return zero and store the value of the spawn-flags attribute of attr into the object referenced by the flags parameter 🍓. otherwise? an error number shall be returned to indicate the error. not the vibe, but okay.

upon successful completion, posix_spawnattr_setflags() shall return zero; otherwise, an error number shall be returned to indicate the error. fr fr.

---

💀 ERRORS 💀

these functions may fail if:

• EINVAL — the value specified by attr is invalid.

and the posix_spawnattr_setflags() function may fail if:

• EINVAL — the value of the attribute being set is not valid.

and just so you know: the following sections are informative. 📝 (yes really, they said it, i'm saying it, we're all saying it)

---

🎀 EXAMPLES 🎀

None.

literally nothing. empty. a void. we move 💅

---

⭐ APPLICATION USAGE ⭐

these functions are part of the Spawn option, so lowkey they need not be provided on all implementations. iykyk. don't be out here assuming every system has your back 🙈.

---

🧚 RATIONALE 🧚

None.

again! nothing! the mystery continues 😭

---

💜 FUTURE DIRECTIONS 💜

None.

the future is… unchanged. iconic behavior honestly.

---

🔥 SEE ALSO 🔥

• posix_spawn()
• posix_spawnattr_destroy()
• posix_spawnattr_getsigdefault()
• posix_spawnattr_getpgroup()
• posix_spawnattr_getschedparam()
• posix_spawnattr_getschedpolicy()
• posix_spawnattr_getsigmask()

and from the Base Definitions volume of POSIX.1‐2017: <spawn.h> 📚

---

👑 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 — like, that's the main character, this page is just the understudy 🫶. 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 was IEEE/The Open Group, 2017 energy for POSIX_S...ETFLAGS(3POSIX) — mwah, go get those flags set ✨💅🌈