SDL_SetLinuxThreadPriority(3)

✨ SDL_SetLinuxThreadPriority ✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the man pages 💖 this one is SDL_SetLinuxThreadPriority(3) and it's literally the "hey Linux, be nice to this thread pls" button. Linux-specific, thread-specific, immaculate vibes only 🎀

---

🌸 NAME 🌸

SDL_SetLinuxThreadPriority — sets the UNIX nice value for a thread 💅

like. it changes how nice a thread is to everybody else. no cap.

---

🦋 SYNOPSIS 🦋

#include <SDL3/SDL_system.h>

bool SDL_SetLinuxThreadPriority(Sint64 threadID, int priority);

she's short, she's sweet, she takes a thread ID and a priority, periodt ✨

---

💜 DESCRIPTION 💜

okay so here's the tea ☕ — this function uses setpriority() if possible, and RealtimeKit if available. that's the whole trick. it tries the plain old syscall route first, and if RealtimeKit is hanging around, that's on the table too 🧚

---

🍓 FUNCTION PARAMETERS 🍓

• threadID — the Unix thread ID you wanna change the priority of. yes, Unix thread ID. don't come in here with something else, she will not know her 🔥
• priority — the new, Unix-specific, priority value. that's the nice value vibe you're going for 💫

---

⭐ RETURN VALUE ⭐

• returns true on success 🎉
• returns false on failure 😭 and in that case you gotta call SDL_GetError() for more information, because she will not tell you why directly. she'll just point you at the error function. iconic behaviour honestly.

---

🫶 THREAD SAFETY 🫶

it is safe to call this function from any thread 👑 go off, call it from wherever, she can handle it.

---

🌈 AVAILABILITY 🌈

this function is available since SDL 3.2.0 ✨ so if you're on something older, sorry bestie, you're out of luck 🙈

---

lowkey reminder: it's Linux-flavoured. the name says Linux for a reason 🐧💖

---

and that's the whole page, no crumbs left 💅 brought to you by the Simple Directmedia Layer girlies, version SDL 3.4.18, and this very SDL_SetLinuxThreadPriority(3) page 🎀 mwah, go set some priorities bestie 🦋💜