mirror of
https://github.com/mailscope/kumomta.git
synced 2026-08-23 12:48:17 +00:00
30 lines
927 B
Markdown
30 lines
927 B
Markdown
---
|
|
tags:
|
|
- message
|
|
---
|
|
|
|
# kumo.inject_message
|
|
|
|
```lua
|
|
kumo.inject_message(MSG)
|
|
```
|
|
|
|
{{since('2025.10.06-5ec871ab')}}
|
|
|
|
Injects the `MSG` into the queue subsystem and begins delivering the message.
|
|
|
|
When this function returns successfully, you should consider the message that
|
|
you provided as an argument to now be owned by the core of kumomta and assume
|
|
that it may have already been delivered and removed from the spool.
|
|
|
|
This function can fail due to issues resolving queue configuration or spooling.
|
|
In error situations, an error will be raised that you can trap using the lua
|
|
`pcall` function if appropriate.
|
|
|
|
!!! danger
|
|
Unless it is explicitly indicated in the documentation to be safe, you **MUST
|
|
NOT** call this function on any message other than one that you have created
|
|
via [kumo.make_message](make_message.md), otherwise you risk both duplicate
|
|
delivery and loss of accountability for the message.
|
|
|