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

Reply via email to