Wez Furlong
5c98511c06
add new kumo.file_type module
...
This is useful for example when processing attachments as part of a
content scanning policy.
2025-10-07 12:12:46 +01:00
Wez Furlong
b157e2f617
add smtp_server_data event for per-txn message validation
...
Great for doing content scanning and recipient list modification!
2025-10-07 07:53:13 +01:00
Wez Furlong
1bf9d138ce
extended lua mime parsing API
...
refs: https://github.com/KumoCorp/kumomta/issues/117
Could also make it possible to do eg:
https://github.com/KumoCorp/kumomta/issues/142
without any explicit direct support in the product.
2025-09-09 09:15:58 +01:00
Wez Furlong
7e6ca34e2d
new: kumo.fs lua module
...
The read_dir and glob functions have been logically moved into that new
namespace, leaving deprecated versions of them in the `kumo` module.
A new `kumo.fs.open` function that works similarly to `io.open` is
provided. This function cooperates with the kumo async io scheduler
and won't block it if the filesystem is under pressure.
It returns file handles that are simlar to the builtin lua file handle
objects, but do not support formatting or parsing of writes or reads
respectively: the calling code is responsible for that. The rationale
for this difference is that is that lua's semantics for those functions
are frankly a bit weird and are hard to replicate precisely.
2025-07-23 16:51:06 +01:00
Wez Furlong
7d617bb270
add kumo.mpsc.define
...
This function allows defining a non-durable, non-persistent, in-memory
queue that is intended to be used as glue when building up more advanced
processing flows within kumomta.
The intent is that the queue is processed from within a task spawned via
`spawn_task`.
2025-07-23 12:44:10 +01:00
Wez Furlong
b2cdc079e1
docs: fmt
2025-05-15 09:12:17 -07:00
Mike Hillyer
41d8cd92a1
Add Postmastery integration.
2025-05-09 13:01:36 -04:00
Wez Furlong
3732bc0fef
docs: code formatting
2025-05-01 10:09:01 -07:00
Mike Hillyer
62a48d4787
Added the architecture page, further tweaks.
2025-05-01 12:31:05 -04:00
Mike Hillyer
08224b223d
DNS and loghook pages
2025-05-01 12:31:05 -04:00
Mike Hillyer
dd4a2acf60
Updates to the performance chapter of the userguide.
2025-05-01 12:31:05 -04:00
Mike Hillyer
66a377bae6
Initial re-arranging of existing performance related content from the Operation chapter to the Performance chapter.
2025-05-01 12:31:05 -04:00
Mike Hillyer
ab40de0920
Initial commit just to test my changes.
2025-05-01 12:31:05 -04:00
Wez Furlong
10e60ea10d
docs: fmt generate-toc.py
2025-02-27 06:01:11 -07:00
MHillyer
c730c78d7c
Add reference to Daniel's repo.
2025-02-26 15:51:25 -05:00
Wez Furlong
f3fd2d9691
docs: fixup tags page
...
The tags plugin was rewritten and broke the old way of pulling
in the tags; update that page, and include it in the toc.
2025-02-20 16:00:16 -07:00
Wez Furlong
9e823dc352
add kumo.time lua module, with new timer object
...
The timer object can track latencies in lua code and is helpful for
ad-hoc, explicit "profiling" in your policy script: the latencies are
exported via a prometheus histogram.
2025-01-09 15:36:30 -07:00
Wez Furlong
971612a7d2
docs: add section about memory management
2024-11-12 13:30:10 -07:00
Wez Furlong
d383b033cf
docs: add a refman section for template syntax
2024-11-08 10:37:08 -07:00
Wez Furlong
d3e399cfda
docs: describe the configuration monitoring and epoch system
2024-11-08 07:14:03 -07:00
Dirkjan Ochtman
55dcf3e6f9
kumod: add basic SPF Lua API
2024-11-07 07:52:37 -07:00
Wez Furlong
1166fd158d
add a security considerations section to the docs
2024-10-25 09:07:47 -07:00
Mike Hillyer
3c446748aa
Forgot to add Scaling page to the TOC.
2024-10-03 10:52:25 -04:00
Mike Hillyer
a0c4f17bef
Inital Publish of Updated Traffic Shaping Section.
2024-09-07 18:25:40 -04:00
Wez Furlong
0c2a41290c
docs: format generate-toc.py
2024-08-24 08:17:38 -07:00
Mike Hillyer
dab23cde0c
Fix change of deployment page.
2024-08-23 15:52:50 -04:00
Mike Hillyer
42ab54d1b3
Initial Clustering Chapter
2024-08-22 18:14:18 -04:00
Wez Furlong
bf060ca171
docs: fixup links to implicit Gen child pages
2024-08-18 19:50:16 -07:00
Wez Furlong
4af9c7035f
docs: move make_queue_config fields to their own pages
...
This makes them easier to search for, and find.
2024-08-18 19:14:34 -07:00
Wez Furlong
4369bd8355
docs: document rollup module
...
closes: https://github.com/KumoCorp/kumomta/issues/213
2024-07-10 10:35:00 -07:00
Wez Furlong
c659fe6d4f
new: add kumo.uuid lua module
2024-07-09 13:25:32 -07:00
Wez Furlong
5b0d936ef7
docs: improve markdown output for the kcli help
2024-06-27 15:40:39 -07:00
Wez Furlong
fa2c6225e8
docs: add kcli reference docs
...
These are automatically extracted from `kcli --help`.
2024-06-27 15:18:07 -07:00
Wez Furlong
e683fed556
docs: move Log Record to its own reference page
...
This makes it a bit easier to find and link to.
2024-06-27 08:28:45 -07:00
Wez Furlong
f8c3429738
serde: move json/toml to new kumo.serde module. Added YAML.
...
This helps to avoid bloating kumo-server-common, and makes it
easier to group related functions together in the docs.
The original names are still usable; we'll remove them in a
future release.
2024-06-26 11:08:15 -07:00
Wez Furlong
10bb7f2717
Add some string and regex functions
...
closes: https://github.com/KumoCorp/kumomta/issues/220
2024-06-21 17:20:04 -07:00
Wez Furlong
7fc8dd97e6
docs: discuss creating an always-suspended queue
...
closes: https://github.com/KumoCorp/kumomta/issues/210
2024-06-20 08:35:17 -07:00
Mike Hillyer
f957d812c1
Add the response rewrite page to the TOC.
2024-06-19 16:35:53 -04:00
Wez Furlong
015fad5e4f
Revert "Add page on rewriting remote server responses to the User Guide."
...
This reverts commit 82a258a92e0e0eef6c7e483ab25f71146cdfeea3; that new
page is incomplete and has invalid syntax.
Let's take it out for now to unblock the doc build.
2024-06-19 08:37:11 -07:00
Mike Hillyer
82a258a92e
Add page on rewriting remote server responses to the User Guide.
2024-06-19 10:13:40 -04:00
Wez Furlong
3207c45f3d
expose inject_v1 API via lua
...
closes: https://github.com/KumoCorp/kumomta/issues/102
2024-03-29 09:06:54 -07:00
Wez Furlong
5063a4671b
docs: format generate-toc.py
2024-03-17 07:24:34 -07:00
Tom Mairs
c48f7f6183
Add sbin utilities
2024-03-15 12:42:59 -06:00
Wez Furlong
949f0a6625
code formatting
2024-02-24 09:18:23 -07:00
Mike Hillyer
1a1042c12f
Fix the error.
2024-02-13 14:22:11 -05:00
Mike Hillyer
c62ee2f8e2
First pass Kafka Docs
2024-02-13 13:47:08 -05:00
Wez Furlong
4bc099821b
docs: fix broken faq links
2024-02-08 08:12:29 -07:00
Wez Furlong
14bfa1be78
docs: format generate-toc.py
2024-02-06 13:49:12 -07:00
Mike Hillyer
1f9e8e51d2
Added a couple of FAQ entries on migrations.
2024-01-24 16:58:33 -05:00
Mike Hillyer
e22f256ee3
Couple more FAQ entries.
2024-01-24 16:48:48 -05:00
Wez Furlong
Mike Hillyer
Dirkjan Ochtman
Tom Mairs
Mike Hillyer