Changeset 34002

Show
Ignore:
Timestamp:
10.03.2020 12:09:23 (3 weeks ago)
Author:
davidb
Message:

Comment-based changes resulting from: (i) merging in differences from the latest tomcat (v8.5.51), and (ii) better labelling so the places that GSDL changes from the default tomcat file are marked more clearly

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • main/trunk/greenstone3/resources/tomcat/web8.xml.svn

    r32696 r34002  
    1616  limitations under the License. 
    1717--> 
     18<!-- GSDL Notes 
     19  To turn a new default 'tomcatN.x.yy/conf/web.xml' into a webN.xml.svn 
     20 
     21  Uncomment the CGI servlet element, and updated so (init) params: 
     22    'debug' is 0, 
     23    'passShellEnvironment' is 0 
     24    'executable' is @perlpath@perl 
     25 
     26  Then uncomment the corresponding servlet-mapping element for CGI 
     27--> 
     28   
     29 
    1830<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 
    1931  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
     
    4860  <!--   fileEncoding        Encoding to be used to read static resources   --> 
    4961  <!--                       [platform default]                             --> 
     62  <!--                                                                      --> 
     63  <!--   useBomIfPresent     If a static file contains a byte order mark    --> 
     64  <!--                       (BOM), should this be used to determine the    --> 
     65  <!--                       file encoding in preference to fileEncoding.   --> 
     66  <!--                       [true]                                         --> 
    5067  <!--                                                                      --> 
    5168  <!--   input               Input buffer size (in bytes) when reading      --> 
     
    100117  <!--                       response sent to clients when directory        --> 
    101118  <!--                       listings is enabled? [true]                    --> 
     119  <!--                                                                      --> 
     120  <!--   allowPartialPut     Should the server treat an HTTP PUT request    --> 
     121  <!--                       with a Range header as a partial PUT? Note     --> 
     122  <!--                       that RFC 7233 clarified that Range headers are --> 
     123  <!--                       only valid for GET requests. [true]            --> 
    102124 
    103125    <servlet> 
     
    336358  <!--                        Recommended value: WEB-INF/cgi                --> 
    337359  <!--                                                                      --> 
     360  <!--  cmdLineArgumentsDecoded                                             --> 
     361  <!--                        Only used when enableCmdLineArguments is      --> 
     362  <!--                        true. The pattern that individual decoded     --> 
     363  <!--                        command line arguments must match else the    --> 
     364  <!--                        request will be rejected. This is to          --> 
     365  <!--                        work-around various issues when Java passes   --> 
     366  <!--                        the arguments to the OS. See the CGI How-To   --> 
     367  <!--                        for more details. The default varies by       --> 
     368  <!--                        platform.                                     --> 
     369  <!--                        Windows: [[a-zA-Z0-9\Q-_.\\/:\E]+]            --> 
     370  <!--                        Others:  [.*]                                 --> 
     371  <!--                        Note that internally the CGI Servlet treats   --> 
     372  <!--                        [.*] as a special case to improve performance --> 
     373  <!--                                                                      --> 
     374  <!--   cmdLineArgumentsEncoded                                            --> 
     375  <!--                        Only used when enableCmdLineArguments is      --> 
     376  <!--                        true. The pattern that individual encoded     --> 
     377  <!--                        command line arguments must match else the    --> 
     378  <!--                        request will be rejected. The default matches --> 
     379  <!--                        the allowed values defined by RFC3875.        --> 
     380  <!--                        [[a-zA-Z0-9\Q%;/?:@&,$-_.!~*'()\E]+]          --> 
     381  <!--                                                                      --> 
    338382  <!--   enableCmdLineArguments                                             --> 
    339383  <!--                        Are command line parameters generated from    --> 
    340384  <!--                        the query string as per section 4.4 of 3875   --> 
    341   <!--                        RFC? [true]                                   --> 
     385  <!--                        RFC? [false]                                  --> 
    342386  <!--                                                                      --> 
    343387  <!--   executable           Name of the executable used to run the        --> 
     
    374418 
    375419 
    376   <!-- Greenstone makes use of CGI through some Perl scripts --> 
     420    <!-- GSDL: Greenstone makes use of CGI through some Perl scripts, so we need this element in-play  -->   
    377421    <servlet> 
    378422        <servlet-name>cgi</servlet-name> 
     
    382426          <param-value>WEB-INF/cgi</param-value> 
    383427        </init-param> 
     428 
    384429        <init-param> 
    385430          <param-name>debug</param-name> 
    386431          <param-value>0</param-value> 
    387432        </init-param> 
    388  
    389     <init-param> 
    390       <param-name>passShellEnvironment</param-name> 
    391       <param-value>true</param-value> 
    392     </init-param> 
    393     <init-param> 
    394       <param-name>executable</param-name> 
    395       <param-value>@perlpath@perl</param-value>  
    396     </init-param> 
    397  
     433        <init-param> 
     434          <param-name>passShellEnvironment</param-name> 
     435          <param-value>true</param-value> 
     436        </init-param> 
     437        <init-param> 
     438          <param-name>executable</param-name> 
     439          <param-value>@perlpath@perl</param-value> 
     440        </init-param> 
     441     
    398442        <load-on-startup>5</load-on-startup> 
    399443    </servlet> 
     
    432476    <!-- The mapping for the CGI Gateway servlet --> 
    433477 
    434  
     478    <!-- GSDL: Greenstone makes use of CGI through some Perl scripts, so we need this element in-play  --> 
    435479    <servlet-mapping> 
    436480        <servlet-name>cgi</servlet-name>