SD_BUS_MESSAGE_REWIND(3)

🌸 NAME 🌸

okay so welcome to the sd_bus_message_rewind manual page, bestie! The page title is SD_BUS_MESSAGE_REWIND(3), the manual name is literally sd_bus_message_rewind, and this function is here to return to the beginning of the message or the current container. That's the whole vibe. 💅✨

💖 SYNOPSIS 💖

#include <systemd/sd-bus.h>

int sd_bus_message_rewind(sd_bus_message *m, int complete);

🦋 DESCRIPTION 🦋

sd_bus_message_rewind() moves the "read pointer" inside the message m to either:

• the beginning of the message — when complete is true, bestie — or
• the beginning of the currently open container.

If no container is open, complete has no effect. That's it, that's the rule. No cap. 🫶

🌈 RETURN VALUE 🌈

On success, this function returns 0 or a positive integer. The value is zero if the current container — or the whole message, in case no container is open — is empty, and positive otherwise. On failure, it returns a negative errno-style error code. 💀

💀 Errors 💀

Returned errors may indicate the following problems:

• -EINVAL — the m parameter is NULL.
• -EPERM — the message m has not been sealed.

✨ NOTES ✨

Functions described here are available as a shared library, which can be compiled against and linked to with the libsystemd pkg-config(1) file. slay, linker bestie 🔥

All functions listed here are thread-agnostic and only a single thread may operate on a given object at any given time. Different threads may access the same object at different times. Multiple independent objects may be used from different threads in parallel. 🧚

The code described here uses getenv(3), which is declared to be not multi-thread-safe. This means that the code calling the functions described here must not call setenv(3) from a parallel thread. It is recommended to only do calls to setenv() from an early phase of the program when no other threads have been started. 🚨

🕰️ HISTORY 🕰️

sd_bus_message_rewind() was added in version 240. iconic behavior from way back 👑

👀 SEE ALSO 👀

systemd(1), sd-bus(3), sd_bus_message_read(3)

---

Catch you later, bestie — this page is from systemd 261.3, and the footer's date slot isn't shown in the original, so that's all we've got 💜🎀