DEPOSIT(4)

💖 NAME 💖

Deposit — save a document to its backing store. Yep, this is the Deposit(special file) manual page, bestie — special-file behavior and all. 🎀

✨ SYNOPSIS ✨

[file] Deposit(in mediaType contents
        [in messageID commission]);

🦋 DESCRIPTION 🦋

Okay so the Deposit request saves a document to its backing store. It is not the same as the Save request — the big difference is that the requester, not the handler, has the data to be saved. Periodt.

The contents argument is the contents of the document. If this argument is unset — in other words, has a value of (char *)0 — then the contents of the document are in the file named in the message’s file attribute. The data type (mediaType) of the contents argument should be string, unless nulls are valid in the given media type, in which case the data type must be bytes. iykyk 💅

The commission argument contains the message ID of the Edit request that caused the creation of this buffer. 🌸

🌈 APPLICATION USAGE 🌈

• The ttmedia_load(3) function can be used to register for, and help process, this message. 🫶
• This message can be sent with the ttmedia_Deposit(3) function. ✨
• The Deposit request is useful for cases where the user may perform an intermediate save of modifications to a document that is the subject of an Edit or Display request in progress. In the latter case, the Deposit may fail on a TT_DESKTOP_EACCES error if the handler does not allow updates to the document being displayed. 😭
• Handlers receiving this request should reply before deleting any file named in the message’s file attribute, but this is optional and applications should not rely on this. Iconic behavior, but still optional — do not build your whole life on it. 💀

🔥 ERRORS 🔥

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

• TT_DESKTOP_EACCES — The document is read-only.
• TT_DESKTOP_ENOENT — The file that was alleged to contain the document does not exist.
• TT_DESKTOP_ENODATA — The in-mode contents argument had no value and the file attribute of the message was not set.
• TT_MEDIA_ERR_FORMAT — The document is not a valid instance of the media type.

👑 SEE ALSO 👑

Go check out ttmedia_load(3), ttmedia_Deposit(3); and the Intro, Display, Edit, Status requests. the way that reference list ate, honestly 🌟

---

That’s the whole Deposit(special file) page, bestie. The footer is literally just Deposit(special file) again — no extra source/version/date line to copy — so here’s your cute sign-off instead: stay slay, save your docs responsibly, and bye 💅🎀✨