Bug 61910 - Description for allowLinking is innacurate
Summary: Description for allowLinking is innacurate
Status: RESOLVED FIXED
Alias: None
Product: Tomcat 8
Classification: Unclassified
Component: Documentation (show other bugs)
Version: 8.5.x-trunk
Hardware: PC Mac OS X 10.1
: P2 normal (vote)
Target Milestone: ----
Assignee: Tomcat Developers Mailing List
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-12-15 15:19 UTC by monte
Modified: 2018-01-04 17:44 UTC (History)
0 users



Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description monte 2017-12-15 15:19:49 UTC
The description for allowLinking is inaccurate on this page:

https://tomcat.apache.org/tomcat-8.0-doc/config/resources.html#Attributes

"If the value of this flag is true, symlinks will be allowed inside the web application, pointing to resources outside the web application base path. If not specified, the default value of the flag is false."

This makes an assumption that symlinks to resources *inside* the web application base path should work, regardless of this flag. However, they do not. NO symlinks work unless the allowLinking flag is set, whether they fall inside our outside the application base path.
Comment 1 Mark Thomas 2018-01-04 17:44:31 UTC
Thanks for the report.

Fixed in:
- trunk for 9.0.3 onwards
- 8.5.x for 8.5.25 onwards
- 8.0.x for 8.0.49 onwards
- 7.0.x for 7.0.84 onwards

Note that allowLinking is an attribute on the Context element in 7.0.x.