ost::Runlist(3)

💖 NAME 💖

ost::Runlist — bestie, it's a runlist 💅 and what it does is restrict concurrent exection to a limited set of concurrent sessions, much like a semaphore. Yes "exection" is in the original, no I'm not fixing it, it's iconic 🙈

This page lives in the Library Functions Manual, section 3, iykyk 🦋

---

✨ SYNOPSIS ✨

#include <misc.h>

Inherits ost::Mutex. Yep, it's got that inheritance going on, main character lineage fr 👑

🎀 Public Member Functions 🎀

• Runlist (unsigned count=1) — create a new runlist with a specified limit ✨
• bool add (Runable *run) — add a runable object to this runlist 🫶
• void del (Runable *run) — remove a runable object from the wait list or notify when it is done running so that the used count can be decremented 💅
• void set (unsigned limit) — set the limit 🔥

🌸 Protected Member Functions 🌸

• void check (void)

💜 Protected Attributes 💜

• unsigned limit
• unsigned used

⭐ Additional Inherited Members ⭐

(yeah that's it, that's the whole section, no cap)

---

🌈 Detailed Description 🌈

A runlist is used to restrict concurrent exection to a limited set of concurrent sessions, much like a semaphore. 🧚

However — and this is the plot twist, bestie — the runlist differs in that it notifies objects when they become ready to run, rather than requiring them to wait and 'block' for the semaphore count to become low enough to continue. It's giving "hey girlie you're up 💖" instead of "get in line and wait." Not me being obsessed with this design honestly 😭

Author

David Sugar dyfet@ostel.com

list of runable objects.

(that last line is literally just chilling there in the original, so it stays 🫶)

---

🎀 Constructor & Destructor Documentation 🎀

ost::Runlist::Runlist (unsigned count = 1)

Create a new runlist with a specified limit. Baby's first runlist, slay ✨

Parameters

• count — limit before wait queuing.

---

💅 Member Function Documentation 💅

bool ost::Runlist::add (Runable * run)

Add a runable object to this runlist. If the number of entries running is below the limit, then add returns true otherwise the entry is added to the list. Lowkey a vibe check for your runables 👑

Returns

• true if immediately ready to run

Parameters

• run — pointer to runable object.

void ost::Runlist::check (void) [protected]

(no description given, it's mysterious like that 🙈)

void ost::Runlist::del (Runable * run)

Remove a runable object from the wait list or notify when it is done running so that the used count can be decremented. It's the goodbye-and-make-room energy fr fr 🦋

Parameters

• run — pointer to runable object.

void ost::Runlist::set (unsigned limit)

Set the limit. Periodt 💅

Parameters

• limit — to use.

---

🌸 Member Data Documentation 🌸

unsigned ost::Runlist::limit [protected]

unsigned ost::Runlist::used [protected]

---

⭐ Author ⭐

Generated automatically by Doxygen for GNU CommonC++ from the source code. 🤖✨

---

okay that's the whole page bestie, go forth and runlist responsibly 🫶

This one came from GNU CommonC++, dated Sun Dec 27 2020, and it's page ost::Runlist(3) — mwah, no notes 💖🎀