GET_MODIFIED(4)

🌸 NAME 🌸

okay so bestie, welcome to Get_Modified(special file) 💅 — this is the manual page whose whole job is asking whether an entity has been modified. That's it, that's the vibe. ✨

✨ SYNOPSIS ✨

[file] Get_Modified(in type ID,
        out boolean modified);

💖 DESCRIPTION 💖

The Get_Modified request is literally asking: has any tool modified a volatile, non-shared (for example, in-memory) representation of the persistent state of an entity (such as a file), with the intention of eventually making that representation persistent? 👀

So, a tool should register a dynamic pattern for this request when it has modified an entity of possible shared interest. Noted. 🫶

The ID argument is the identity of the persistent entity being asked about. When its type is File, then ID is unset (in other words, has a value of (char *)0), and it refers to the file or directory named in the message's file attribute. 💖

The modified argument (yes, the source says "argument argument" — iconic 😭) is a Boolean value indicating whether a volatile, non-shared (for example, in-memory) representation of the entity has been modified with the intention of eventually making that representation persistent. Periodt. 🌈

😭 ERRORS 😭

The ToolTalk service may return one of the following errors in processing the Get_Modified request:

• TT_ERR_NO_MATCH — Since no handler could be found, the entity in question can be assumed not to be modified.

🫶 APPLICATION USAGE 🫶

The ttdt_file_join(3) function (source comma included, she's extra 💅) can be used to register for, and transparently process, the Get_Modified request.

The Get_Modified request can be sent with ttdt_file_request(3); ttdt_Get_Modified(3), can send the Get_Modified request and block on the reply. 🦋

👀 SEE ALSO 👀

• ttdt_file_join(3)
• ttdt_file_request(3)
• ttdt_file_request(3) — yes, listed again, she said what she said 💀
• ttdt_Get_Modified(3)
• the Set_Modified request ✨

mwah 💋 — footer-corner kisses from Get_Modified(special file); no extra source/version/date was printed there, so no invented lore, and that's on periodt 🫶