PMEM2_CONFIG_SET_SHARING(3)

💖 pmem2_config_set_sharing(3) 💖

okay bestie, sit DOWN, because we're doing a lil deep dive into the PMDK Programmer's Manual together and this one is a genuine bop. it's a libpmem2 function, it's three-ish lines long, and it controls whether your writes are everyone's business or nobody's business. obsessed. let's go 🦋

---

✨ NAME ✨

pmem2_config_set_sharing() — literally just "set sharing in the pmem2_config structure". that's the whole job. she's a one-task queen 💅

---

✨ SYNOPSIS ✨

#include <libpmem2.h>

struct pmem2_config;
enum pmem2_sharing_type {
    PMEM2_SHARED,
    PMEM2_PRIVATE,
};
int pmem2_config_set_sharing(struct pmem2_config *config, enum pmem2_sharing_type sharing);

so you're pulling in <libpmem2.h>, you've got an opaque lil struct pmem2_config (no peeking inside, she's mysterious 🙈), you've got an enum pmem2_sharing_type with exactly two moods — PMEM2_SHARED and PMEM2_PRIVATE — and then the function itself takes a struct pmem2_config *config plus an enum pmem2_sharing_type sharing and gives you back an int. iconic signature, no notes ⭐

---

🌸 DESCRIPTION 🌸

the pmem2_config_set_sharing() function configures the behavior and visibility of writes to the mapping's pages. yes. that's the whole vibe check. it's deciding whether your writes are loud and public or quiet and personal. the possible values are listed below, and bestie, there are exactly two:

• PMEM2_SHARED — writes are made directly to the underlying memory, making them visible to other mappings of the same memory region. this is the default, so if you never call this function at all, this is what you're getting. main character energy by default, fr fr 🔥
• PMEM2_PRIVATE — writes do not affect the underlying memory and are not visible to other mappings of the same memory region. she's private, she's keeping it to herself, nobody else sees a thing 🎀

---

✨ RETURN VALUE ✨

pmem2_config_set_sharing() returns 0 on success or a negative error code on failure. so: 0 = slay, negative = not slay 😭

---

💀 ERRORRS 💀

yes the heading is spelled like that, we're keeping it, it's part of the lore 🫶

the pmem2_config_set_sharing() can fail with the following errors:

• PMEM2_E_INVALID_SHARING_VALUE — sharing value is invalid. you handed her a sharing value that isn't a thing, bestie. she cannot work with that. 💀

---

🌈 SEE ALSO 🌈

• libpmem2(7)
• pmem2_config_new(3)
• pmem2_map_new(3)
• sysconf(3)
• and https://pmem.io

---

and that's the whole page, periodt 💜 this was the PMDK Programmer's Manual, dated 2025-07-24 — so go forth, set your sharing, and remember: shared is the default, private is for when you're feeling mysterious. mwah, bye bestie 🧚✨