This is an automated email from the ASF dual-hosted git repository.
jbertram pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/artemis.git
The following commit(s) were added to refs/heads/main by this push:
new e22a9d8d21 ARTEMIS-5750 clarify doc for disk-full-policy
e22a9d8d21 is described below
commit e22a9d8d21b3cd15ab350b0af14f2a97db7827f7
Author: Justin Bertram <[email protected]>
AuthorDate: Thu Jan 8 21:01:46 2026 -0600
ARTEMIS-5750 clarify doc for disk-full-policy
---
docs/user-manual/paging.adoc | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/docs/user-manual/paging.adoc b/docs/user-manual/paging.adoc
index d76240b74e..99ec2b4374 100644
--- a/docs/user-manual/paging.adoc
+++ b/docs/user-manual/paging.adoc
@@ -213,9 +213,13 @@ This may cause performance issues if this is an
undesirable state.
== Monitoring Disk
-The broker can be configured to perform scans on the disk to determine if disk
is beyond a configured limit.
+The broker can be configured to perform scans on the disk to determine if it
is beyond a configured limit.
Since the disk is a critical piece of infrastructure for data integrity the
broker will automatically shut itself down if it runs out of disk space.
-Configuring a limit allows the broker to enforce flow control on clients
sending messages to the broker so that the disk never fills up completely.
+
+Configuring a limit allows the broker to enforce flow control on clients
sending messages to the broker so that the disk never fills up.
+The `disk-full-policy` controls what the broker will do when the configured
limit is exceeded.
+Similar to `address-full-policy`, valid values are `DROP`, `FAIL`, and `BLOCK`.
+The default is `BLOCK`.
WARNING: If the protocol used to send the messages doesn't support flow
control (e.g. STOMP) then an exception will be thrown and the connection for
the client will be dropped so that it can no longer send messages and consume
disk space.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
