This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new a7307f3ffaf2 CAMEL-25412: upgrade guide notes for
jailStartingDirectory resolving symbolic links in 4.22.2 and 4.18.6 (#30172)
a7307f3ffaf2 is described below
commit a7307f3ffaf24110bea86a4bad5bee67ca2796d7
Author: Claus Ibsen <[email protected]>
AuthorDate: Mon Nov 16 13:56:11 2026 +0100
CAMEL-25412: upgrade guide notes for jailStartingDirectory resolving
symbolic links in 4.22.2 and 4.18.6 (#30172)
Co-Authored-By: Claude Opus 5.5 <[email protected]>
---
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc | 10 ++++++++++
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc | 10 ++++++++++
2 files changed, 20 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
index 4ee0ff879304..462073af8c6f 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
@@ -93,6 +93,16 @@ wildcard to select a file, use the real name of the file in
the producer, and th
consumer that lists the directory instead of a wildcard in `fileName` with
`useList=false`. See the
xref:components::sftp-component.adoc[SFTP component].
+=== camel-file - jailStartingDirectory resolves symbolic links
+
+With `jailStartingDirectory` enabled (the default), the file consumer and
producer now resolve symbolic links when
+checking that a file stays within the starting directory. The consumer skips a
file or (with `recursive=true`) a
+directory that is a link resolving outside of it, and the producer fails to
write through such a link or a dangling
+link. Links resolving inside the starting directory work as before. Set
`jailStartingDirectory=false` to keep following
+links to other directories (this also turns off the check of `../` in producer
file names). A skipped file is logged
+at WARN the first time and at DEBUG on later polls; this log-level change also
applies to the remote file consumers,
+which keep their existing lexical check.
+
=== camel-file - the consumer skips a file it would move through a symbolic
link resolving outside the starting directory
With `jailStartingDirectory` enabled (the default), the file consumer now
resolves symbolic links on the targets of
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
index c8b2e6771340..fb76e000c72c 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
@@ -1051,6 +1051,16 @@ java.io.IOException: No subject alternative names
matching IP address 127.0.0.1
Caused by: javax.net.ssl.SSLHandshakeException: No subject alternative
names matching IP address 127.0.0.1 found
----
+=== camel-file - jailStartingDirectory resolves symbolic links
+
+With `jailStartingDirectory` enabled (the default), the file consumer and
producer now resolve symbolic links when
+checking that a file stays within the starting directory. The consumer skips a
file or (with `recursive=true`) a
+directory that is a link resolving outside of it, and the producer fails to
write through such a link or a dangling
+link. Links resolving inside the starting directory work as before. Set
`jailStartingDirectory=false` to keep following
+links to other directories (this also turns off the check of `../` in producer
file names). A skipped file is logged
+at WARN the first time and at DEBUG on later polls; this log-level change also
applies to the remote file consumers,
+which keep their existing lexical check.
+
=== camel-zipfile, camel-tarfile - a maxDecompressedSize of 2 GiB or more is
now enforced
The `maxDecompressedSize` option of the Zip File and Tar File data formats
(and of `ZipSplitter`) was not