objagg_create(9)

✨ objagg_create(9) ✨

okay bestie, welcome to the Kernel API Manual — this one's from objagg_create(9) and it's literally the moment a brand-new objagg instance gets born 🎀

---

🌸 NAME 🌸

objagg_create — creates a new objagg instance 💖

---

✨ SYNOPSIS ✨

struct objagg * objagg_create (const struct objagg_ops *ops , struct
objagg_hints *objagg_hints , void *priv );

---

🦋 ARGUMENTS 🦋

• ops — your user-specific callbacks, like the whole personality of the thing 💅
• objagg_hints — the hints, and no cap: this one can be NULL 🙈
• priv — a pointer to private data that gets passed along to the ops 🫶

---

👑 NOTE 👑

Real talk first: all locking must be provided by the caller. The library is not doing that for you, periodt. 🔥

So here's the vibe — the whole purpose of this library is to give you an infrastructure to aggregate user-specified objects. It literally does not care what type your object is, bestie. You fill up ops and those take care of the specific user object manipulation. main character energy: yours. ✨

As a very stupid example (their words, not mine 😭), consider integer numbers. For example number 8 as a root object. That can aggregate number 9 with delta 1, number 10 with delta 2, etc. That example is implemented as a part of a testing module in the test_objagg.c file — iconic of them honestly 🧚

Each objagg instance contains multiple trees 🌳. Each tree node is represented by "an object". In the current implementation there can be only roots and leafs nodes. Leaf nodes are called deltas. But in general, this can be easily extended for intermediate nodes. In that extension, a delta would be associated with all non-root nodes. Lowkey love a library that plans ahead 💜

And the return situation: it returns a pointer to a newly created objagg instance in case of success 🎉 — otherwise it returns a pointer error using the ERR_PTR macro 💀 so like, check that pointer, okay?

---

🌈 SEE ALSO 🌈

• Kernel file ./lib/objagg.c
• objagg_obj_root_priv(9)
• objagg_obj_delta_priv(9)
• objagg_obj_raw(9)
• objagg_obj_get(9)
• objagg_obj_put(9)
• objagg_destroy(9)
• objagg_stats_get(9)
• objagg_stats_put(9)
• objagg_hints_get(9)
• objagg_hints_put(9)
• objagg_hints_stats_get(9)

---

and that's the whole page, bestie 🍓 this cutie lives in ./lib and the manual's dated October 2026 — go forth and aggregate, iykyk 💅✨