ost::DSO(3)

🌸 ost::DSO 💅 — the dynamic loader glow-up

okay bestie, sit down, hydrate, because we're talking about ost::DSO, aka the DSO dynamic loader class which is literally the thing you use to load object files. yes, that DSO. it lives in the Library Functions Manual section 3 (iykyk) 💖

---

✨ NAME ✨

ost::DSO — the DSO dynamic loader class, and she's used to load object files. periodt.

---

🦋 SYNOPSIS 🦋

#include <file.h>

👑 Public Member Functions

• DSO (const char *filename) — Construct and load a DSO object file. (the classic)
• DSO (const char *filename, bool resolve) — the sequel constructor 🫶
• const char * getError (void) — Retrieve error indicator associated with DSO failure.
• virtual ~DSO () — Detach a DSO object from running memory. she's leaving, bye 💀
• void * operator[] (const char *sym) — Lookup a symbol in the loaded file.
• bool isValid (void) — See if DSO object is valid.

🎀 Static Public Member Functions

• static void dynunload (void)
• static DSO * getObject (const char *name) — Find a specific DSO object by filename.
• static void setDebug (void) — Install debug handler...

---

💜 DETAILED DESCRIPTION 💜

The DSO dynamic loader class is used to load object files. that's the whole vibe.

On elf based systems this is typically done with dlopen. And on systems that aren't dl capable? a dummy stub class gets generated instead. so she's adaptable, we love a flexible queen 🌈

Author

• David Sugar — dyfet@ostel.com

Dynamic class file loader. that's her résumé, that's the whole bio ✨

---

🧚 CONSTRUCTOR & DESTRUCTOR DOCUMENTATION 🧚

🌸 ost::DSO::DSO (const char * filename) [inline]

Construct and load a DSO object file.

Parameters

• filename — pathname of object file to load.

🌸 ost::DSO::DSO (const char * filename, bool resolve) [inline]

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

🌸 virtual ost::DSO::~DSO () [virtual]

Detach a DSO object from running memory.

this is the goodbye moment bestie, the DSO is being detached from running memory. give her a moment 😭

---

⭐ MEMBER FUNCTION DOCUMENTATION ⭐

🍓 static void ost::DSO::dynunload (void) [static]

(no description, she's just out here doing her job 💅)

🍓 const char* ost::DSO::getError (void) [inline]

Retrieve error indicator associated with DSO failure. This is often used in catch handlers. so when everything's going wrong and you're catching the fallout, this is your girl 🫶

🍓 static DSO* ost::DSO::getObject (const char * name) [static]

Find a specific DSO object by filename.

Parameters

• name — of DSO object file (partial).

note the partial — you don't need the whole filename, just enough to find her 🔥

🍓 bool ost::DSO::isValid (void)

See if DSO object is valid.

Returns

• true if valid.

a vibe check, essentially. true = valid, iconic. 🌟

🍓 void* ost::DSO::operator[] (const char * sym)

Lookup a symbol in the loaded file.

🍓 static void ost::DSO::setDebug (void) [static]

Install debug handler...

the ... is literally in the original, she trails off, she's enigmatic, we respect it 💀

---

👑 AUTHOR 👑

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

---

and that's the whole page, bestie 🎀 fr fr no cap — this was generated automatically by Doxygen for GNU CommonC++ from the source code, dated Sun Dec 27 2020, and that's your GNU CommonC++ sign-off. slay, go load some object files responsibly 💖✨🌈