GELF_GETDYN(3)

📦
version 0.197 · 2 versions
, in alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, fedora 43, fedora 44, nixpkgs unstable, ubuntu stonking

💖 GELF_GETDYN(3) 💖

okay bestie, so this is a libelf page — like, from the Libelf Programmer's Manual — and it's literally about pulling one single entry out of a dynamic table, but doing it in a way that doesn't care about ELF class. no cap. 🦋

✨ NAME ✨

gelf_getdyn — get class-independent information from the dynamic table at the given index 👑

🌸 SYNOPSIS 🌸

#include <gelf.h>

GElf_Dyn *gelf_getdyn (Elf_Data *data, int ndx, GElf_Dyn *dst);

💅 DESCRIPTION 💅

So the whole vibe here is: you grab a dynamic table entry out of data at index ndx, and it gets stored in a class-independent representation that dst points at. class-independent meaning you don't have to care whether it's 32-bit or 64-bit ELF, the function handles that for you. it's giving effortless. ✨

🚨 okay important: data must be an Elf_Data* that's associated with a section of type SHT_DYNAMIC. that's the rule, no exceptions.

🎀 PARAMETERS 🎀

  • data — pointer to an Elf_Data of a section with type SHT_DYNAMIC. also, data->d_type should be ELF_T_DYN. 👀
  • ndx — zero-based index of the dynamic table entry you're asking for, within data. yes, zero-based, so the first one is 0, not 1, don't come for me. 🔢
  • dst — pointer to a caller-provided GElf_Dyn structure where the requested dynamic table entry gets stored. must not be NULL. like, genuinely must not. 💀

⭐ RETURN VALUE ⭐

On success, this function updates dst with the requested dynamic table entry and returns dst. slay. 🫶

On failure, it returns NULL and sets elf_errno. 😭

🫧 but wait — special case: if data is NULL, then NULL is returned without setting elf_errno. so don't go checking elf_errno for that one, it'll be lying to you bestie.

👑 SEE ALSO 👑

🌈 ATTRIBUTES 🌈

  • Interface: gelf_getdyn()
  • Attribute: Thread safety
  • Value: MT-Safe

so yeah, it's MT-Safe, meaning multi-threaded safe, meaning you can bring your whole group chat to this function. 🧚

💀 REPORTING BUGS 💀

Found something cursed? report bugs to <elfutils-devel@sourceware.org> or go yell into the void at https://sourceware.org/bugzilla/. they're nice, promise. 🍓

okay that's the whole page!! 💜 this was GELF_GETDYN(3) from Libelf, dated 2025-12-30, and honestly? iconic. now go read the entry, bestie, it's waiting for you ✨🎀🦋

📦 where this page comes from