aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2021-07-08 16:15:46 -0400
committerDavid Robillard <d@drobilla.net>2022-01-13 23:03:31 -0500
commit5c90b6aff410bb4a9737680baffd79d10b5281fd (patch)
treee6f4c94fbc1c230fb238e3c91d8dc85adc0a1dec /doc
parent00af9fa4e0344b1ff642a7ccd63626f77521ea8a (diff)
downloadserd-5c90b6aff410bb4a9737680baffd79d10b5281fd.tar.gz
serd-5c90b6aff410bb4a9737680baffd79d10b5281fd.tar.bz2
serd-5c90b6aff410bb4a9737680baffd79d10b5281fd.zip
Use a fixed-size reader stack
Diffstat (limited to 'doc')
-rw-r--r--doc/serdi.19
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/serdi.1 b/doc/serdi.1
index 0684a6e0..55fe6492 100644
--- a/doc/serdi.1
+++ b/doc/serdi.1
@@ -9,6 +9,7 @@
.Op Fl abefhlqv
.Op Fl c Ar prefix
.Op Fl i Ar syntax
+.Op Fl k Ar bytes
.Op Fl o Ar syntax
.Op Fl p Ar prefix
.Op Fl r Ar root
@@ -68,6 +69,14 @@ Case is ignored, valid values are:
.Dq TriG ,
.Dq Turtle .
.Pp
+.It Fl k Ar bytes
+Parser stack size.
+For performance and security reasons, parsing is performed with a fixed-size stack.
+By default, the stack is 4096 bytes, which should be sufficient for most data.
+If some data has very deep nesting or very large literal values,
+it may exceed the default amount of space,
+and this option can be used to increase it and allow the document to be parsed successfully.
+.Pp
.It Fl l
Lax (non-strict) parsing.
If this is enabled, recoverable syntax errors will print a warning, but parsing will proceed starting at the next statement if possible.