Skip to content

Commit 676de24

Browse files
committed
Document new listener options max_stanza_elements, pre_auth_max_stanza_elements and pre_auth_max_stanza_size
1 parent 0ced97a commit 676de24

2 files changed

Lines changed: 35 additions & 0 deletions

File tree

content/admin/configuration/listen-options.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -205,6 +205,16 @@ Specify the maximum payload size in bytes.
205205
It can be either an integer or the word `infinity`.
206206
The default value is `infinity`.
207207

208+
## max_stanza_elements
209+
210+
*Size*
211+
212+
This option specifies a maximum number of XML elements that individual
213+
stanza can have. The default value is `infinity`.
214+
215+
See also [pre_auth_max_stanza_elements](pre_auth_max_stanza_elements) for
216+
value used by streams before authentication.
217+
208218
## max_stanza_size
209219

210220
*Size*
@@ -217,6 +227,9 @@ This option specifies an approximate maximum size in bytes of XML
217227
always much higher than c2s limit. Change this value with extreme
218228
care as it can cause unwanted disconnect if set too low.
219229

230+
See also [pre_auth_max_stanza_size](pre_auth_max_stanza_size) for
231+
value used by streams before authentication.
232+
220233
## module
221234

222235
*ModuleName*
@@ -254,6 +267,22 @@ to create and listen on a unix domain socket `/path/to/socket`.
254267

255268
File permissions can be set using the [unix_socket](#unix_socket) option.
256269

270+
## pre_auth_max_stanza_elements
271+
Sets limit of maximum number of XML elements that individual
272+
stanza can have, this value is only used for streams that haven't
273+
authenticated yet. Default value is set to 32.
274+
275+
See also [max_stanza_elements](max_stanza_elements) for
276+
value used by streams after authentication completes.
277+
278+
## pre_auth_max_stanza_size
279+
Sets limit of maximum size of bytes that XML representation of
280+
stanza can have, this value is only used for streams that haven't
281+
authenticated yet. Default value is set to 8192.
282+
283+
See also [max_stanza_size](max_stanza_size) for
284+
value used by streams after authentication completes.
285+
257286
## protocol_options
258287

259288
*ProtocolOpts*

content/admin/configuration/listen.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,10 @@ General listen options supported:
5050
[ciphers](listen-options.md#ciphers),
5151
[dhfile](listen-options.md#dhfile),
5252
[max_fsm_queue](listen-options.md#max_fsm_queue),
53+
[max_stanza_elements](listen-options.md#max_stanza_elements),
5354
[max_stanza_size](listen-options.md#max_stanza_size),
55+
[pre_auth_max_stanza_elements](listen-options.md#pre_auth_max_stanza_elements),
56+
[pre_auth_max_stanza_size](listen-options.md#pre_auth_max_stanza_size),
5457
[protocol_options](listen-options.md#protocol_options),
5558
[send_timeout](listen-options.md#send_timeout),
5659
[shaper](listen-options.md#shaper),
@@ -74,7 +77,10 @@ General listen options supported:
7477
[ciphers](listen-options.md#ciphers),
7578
[dhfile](listen-options.md#dhfile),
7679
[max_fsm_queue](listen-options.md#max_fsm_queue),
80+
[max_stanza_elements](listen-options.md#max_stanza_elements),
7781
[max_stanza_size](listen-options.md#max_stanza_size),
82+
[pre_auth_max_stanza_elements](listen-options.md#pre_auth_max_stanza_elements),
83+
[pre_auth_max_stanza_size](listen-options.md#pre_auth_max_stanza_size),
7884
[protocol_options](listen-options.md#protocol_options),
7985
[send_timeout](listen-options.md#send_timeout),
8086
[shaper](listen-options.md#shaper),

0 commit comments

Comments
 (0)