source: nutchez-0.1/tomcat/webapps/docs/config/printer/systemprops.html

Last change on this file was 66, checked in by waue, 16 years ago

NutchEz - an easy way to nutch
File size: 18.1 KB
Line 
1<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>Apache Tomcat Configuration Reference - System Properties</title></head><body vlink="#525D76" alink="#525D76" link="#525D76" text="#000000" bgcolor="#ffffff"><table cellspacing="0" width="100%" border="0"><!--PAGE HEADER--><tr><td><!--PROJECT LOGO--><a href="http://tomcat.apache.org/"><img border="0" alt="
2    The Apache Tomcat Servlet/JSP Container
3  " align="right" src="../../images/tomcat.gif"></a></td><td><font face="arial,helvetica,sanserif"><h1>Apache Tomcat 6.0</h1></font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img border="0" alt="Apache Logo" align="right" src="../../images/asf-logo.gif"></a></td></tr></table><table cellspacing="4" width="100%" border="0"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td align="left" valign="top" width="80%"><table cellspacing="4" width="100%" border="0"><tr><td valign="top" align="left"><h1>Apache Tomcat Configuration Reference</h1><h2>System Properties</h2></td><td nowrap="true" valign="top" align="right"><img border="0" hspace="0" vspace="0" height="1" width="1" src="../../images/void.gif"></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
4  <p>The follow sections list the system properties that may be set to modify
5  the default Tomcat behaviour.</p>
6</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Clustering"><strong>Clustering</strong></a></font></td></tr><tr><td><blockquote>
7  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.catalina. tribes.dns_lookups</code></td><td valign="center" align="left">
8      <p>If <code>true</code>, the clustering module will attempt to use DNS to
9      resolve any host names provided in the cluster configuration. If not
10      specified, the default value of <code>false</code> will be used.</p>
11    </td></tr></table>
12
13</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Expression Language"><strong>Expression Language</strong></a></font></td></tr><tr><td><blockquote>
14  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.el.parser.COERCE_TO_ZERO</code></td><td valign="center" align="left">
15      <p>If <code>true</code>, when coercing expressions to numbers
16      <code>""</code> and <code>null</code> will be coerced to zero as required
17      by the specification. If not specified, the default value of
18      <code>true</code> will be used.</p>
19    </td></tr></table>
20</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Jasper"><strong>Jasper</strong></a></font></td></tr><tr><td><blockquote>
21  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.jasper.compiler. Generator.VAR_EXPRESSIONFACTORY</code></td><td valign="center" align="left">
22      <p>The name of the variable to use for the expression language expression
23      factory. If not specified, the default value of
24      <code>_el_expressionfactory</code> will be used.</p>
25    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.compiler. Generator.VAR_INSTANCEMANAGER</code></td><td valign="center" align="left">
26      <p>The name of the variable to use for the instance manager factory. If
27      not specified, the default value of <code>_jsp_instancemanager</code> will
28      be used.</p>
29    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.compiler. Parser.STRICT_QUOTE_ESCAPING</code></td><td valign="center" align="left">
30      <p>If <code>false</code> the requirements for escpaing quotes in JSP
31      attributes will be relaxed so that a missing required quote will not
32      cause an error. If not specified, the specification compliant default of
33      <code>true</code> will be used.</p>
34    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.runtime. BodyContentImpl.LIMIT_BUFFER</code></td><td valign="center" align="left">
35      <p>If <code>true</code>, any tag buffer that expands beyond
36      <code>org.apache.jasper.Constants.DEFAULT_TAG_BUFFER_SIZE</code> will be
37      destroyed and a new buffer created of the default size. If not specified,
38      the default value of <code>false</code> will be used.</p>
39    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.runtime. JspFactoryImpl.USE_POOL</code></td><td valign="center" align="left">
40      <p>If <code>true</code>, a ThreadLocal <code>PageContext</code> pool will
41      be used. If not specified, the default value of <code>true</code> will be
42      used.</p>
43    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.runtime. JspFactoryImpl.POOL_SIZE</code></td><td valign="center" align="left">
44      <p>The size of the ThreadLocal <code>PageContext</code>. If not specified,
45      the default value of <code>8</code> will be used.</p>
46    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. JSP_SERVLET_BASE</code></td><td valign="center" align="left">
47      <p>The base class of the Servlets generated from the JSPs. If not
48      specified, the default value of
49      <code>org.apache.jasper.runtime.HttpJspBase</code> will be used.</p>
50    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. SERVICE_METHOD_NAME</code></td><td valign="center" align="left">
51      <p>The name of the service method called by the base class. If not
52      specified, the default value of <code>_jspService</code> will be used.</p>
53    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. SERVLET_CLASSPATH</code></td><td valign="center" align="left">
54      <p>The name of the ServletContext attribute that provides the classpath
55      for the JSP. If not specified, the default value of
56      <code>org.apache.catalina.jsp_classpath</code> will be used.</p>
57    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. JSP_FILE</code></td><td valign="center" align="left">
58      <p>The name of the request attribute for <code>&lt;jsp-file&gt;</code>
59      element of a servlet definition. If present on a request, this overrides
60      the value returned by <code>request.getServletPath()</code> to select the
61      JSP page to be executed. If not specified, the default value of
62      <code>org.apache.catalina.jsp_file</code> will be used.</p>
63    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. PRECOMPILE</code></td><td valign="center" align="left">
64      <p>The name of the query parameter that causes the JSP engine to just
65      pregenerate the servlet but not invoke it. If not specified, the default
66      value of <code>org.apache.catalina.jsp_precompile</code> will be used.</p>
67    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. JSP_PACKAGE_NAME</code></td><td valign="center" align="left">
68      <p>The default package name for compiled jsp pages. If not specified, the
69      default value of <code>org.apache.jsp</code> will be used.</p>
70    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. TAG_FILE_PACKAGE_NAME</code></td><td valign="center" align="left">
71      <p>The default package name for tag handlers generated from tag files. If
72      not specified, the default value of <code>org.apache.jsp.tag</code> will
73      be used.</p>
74    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. ALT_DD_ATTR</code></td><td valign="center" align="left">
75      <p>The servlet context attribute under which the alternate deployment
76      descriptor for this web application is stored. If not specified, the
77      default value of <code>org.apache.catalina.deploy.alt_dd</code> will
78      be used.</p>
79    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. TEMP_VARIABLE_NAME_PREFIX</code></td><td valign="center" align="left">
80      <p>Prefix to use for generated temporary variable names. If not specified,
81      the default value of <code>_jspx_temp</code> will be used.</p>
82    </td></tr><tr><td valign="center" align="left"><code>org.apache.jasper.Constants. USE_INSTANCE_MANAGER_FOR_TAGS</code></td><td valign="center" align="left">
83      <p>If <code>true</code>, the instance manager is used to obtain tag
84      handler instances. If not specified, <code>false</code> will be used.</p>
85    </td></tr></table>
86
87</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Security"><strong>Security</strong></a></font></td></tr><tr><td><blockquote>
88
89  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.catalina.connector. RECYCLE_FACADES</code></td><td valign="center" align="left">
90      <p>If this is <code>true</code> or if a security manager is in use a new
91      facade object will be created for each request. If not specified, the
92      default value of <code>false</code> will be used.</p>
93    </td></tr><tr><td valign="center" align="left"><code>org.apache.catalina.connector. CoyoteAdapter.ALLOW_BACKSLASH</code></td><td valign="center" align="left">
94      <p>If this is <code>true</code> the '\' character will be permitted as a
95      path delimiter. If not specified, the default value of <code>false</code>
96      will be used.</p>
97    </td></tr><tr><td valign="center" align="left"><code>org.apache.tomcat.util.buf. UDecoder.ALLOW_ENCODED_SLASH</code></td><td valign="center" align="left">
98      <p>If this is <code>true</code> '%2F' and '%5C' will be permitted as path
99      delimiters. If not specified, the default value of <code>false</code> will
100      be used.</p>
101    </td></tr><tr><td valign="center" align="left"><code>org.apache.coyote. USE_CUSTOM_STATUS_MSG_IN_HEADER</code></td><td valign="center" align="left"><p>If this is
102      <code>true</code> custom HTTP status messages will be used within HTTP
103      headers. Users must ensure that any such message is ISO-8859-1 encoded,
104      particularly if user provided input is included in the message, to prevent
105      a possible XSS vulnerability. If not specified the default value of
106      <code>false</code> will be used.</p>
107    </td></tr></table>
108
109</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Specification"><strong>Specification</strong></a></font></td></tr><tr><td><blockquote>
110
111  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>org.apache.catalina. STRICT_SERVLET_COMPLIANCE</code></td><td valign="center" align="left">
112      <p>If this is <code>true</code> the following actions will occur:
113      <ul>
114      <li>any wrapped request or response object passed to an application
115      dispatcher will be checked to ensure that it has wrapped the original
116      request or response. (SRV.8.2 / SRV.14.2.5.1)
117      </li>
118      <li>a call to <code>Response.getWriter()</code> if no character encoding
119      has been specified will result in subsequent calls to
120      <code>Response.getCharacterEncoding()</code> returning
121      <code>ISO-8859-1</code> and the <code>Content-Type</code> response header
122      will include a <code>charset=ISO-8859-1</code> component. (SRV.15.2.22.1)
123      </li>
124      <li>every request that is associated with a session will cause the
125      session's last accessed time to be updated regardless of whether or not
126      the request explicity accesses the session. (SRV.7.6) 
127      </li>
128      <li>
129        cookies will be parsed strictly, by default v0 cookies will not work with any invalid characters.
130        <br>If set to false, any v0 cookie with invalid character will be switched to a v1 cookie and
131        the value will be quoted.
132      </li>
133      <li>
134        <code>ServletContext.getResource/getResourceAsStream</code> must start with "/"<br>
135        if set to false, code like <code>getResource("myfolder/myresource.txt")</code> will work
136      </li>
137      </ul>
138      </p>
139    </td></tr><tr><td valign="center" align="left"><code>org.apache.catalina.session. StandardSession.ACTIVITY_CHECK</code></td><td valign="center" align="left">
140      <p>If this is <code>true</code> or if
141      <code>org.apache.catalina.STRICT_SERVLET_COMPLIANCE</code> is
142      <code>true</code> Tomcat will track the number of active requests for each
143      session. When determining if a session is valid, any session with at least
144      one active request will always be considered valid. If not specified, the
145      default value of <code>false</code> will be used.</p>
146    </td></tr></table>
147
148</blockquote></td></tr></table><table cellpadding="2" cellspacing="0" border="0"><tr><td bgcolor="#525D76"><font face="arial,helvetica.sanserif" color="#ffffff"><a name="Other"><strong>Other</strong></a></font></td></tr><tr><td><blockquote>
149
150  <table cellpadding="5" border="1"><tr><th bgcolor="#023264" width="15%"><font color="#ffffff">Property</font></th><th bgcolor="#023264" width="85%"><font color="#ffffff">Description</font></th></tr><tr><td valign="center" align="left"><code>catalina.useNaming</code></td><td valign="center" align="left">
151      <p>If this is <code>false</code> it will override the
152      <code>useNaming</code> attribute for all <a href="context.html">
153      Context</a> elements.</p>
154    </td></tr><tr><td valign="center" align="left"><code>jvmRoute</code></td><td valign="center" align="left">
155      <p>Provides a default value for the <code>jvmRoute</code> attribute of the
156      <a href="engine.html">Engine</a> element. It does not override the a value
157      configured on the <a href="engine.html">Engine</a> element.</p>
158    </td></tr><tr><td valign="center" align="left"><code>org.apache.catalina.loader. WebappClassLoader.ENABLE_CLEAR_REFERENCES</code></td><td valign="center" align="left">
159      <p>If <code>true</code>, Tomcat attempts to null out any static or final
160      fields from loaded classes when a web application is stopped as a work
161      around for apparent garbage collection bugs and application coding errors.
162      </p>
163      <p>There have been some issues reported with log4j when this option is
164      <code>true</code>.</p>
165      <p>Applications without memory leaks using recent JVMs should operate
166      correctly with this option set to <code>false</code>.</p>
167      <p>If not specified, the default value of <code>true</code> will be used.
168      </p>
169    </td></tr><tr><td valign="center" align="left"><code>catalina.config</code></td><td valign="center" align="left">
170      <p>The URL for the catalina.properties configuration file.</p>
171    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.byte.enabled</code></td><td valign="center" align="left">
172      <p>If <code>true</code>, the String cache is enabled for
173      <code>ByteChunk</code>. If not specified, the default value of
174      <code>false</code> will be used.</p>
175    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.char.enabled</code></td><td valign="center" align="left">
176      <p>If <code>true</code>, the String cache is enabled for
177      <code>CharChunk</code>. If not specified, the default value of
178      <code>false</code> will be used.</p>
179    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.trainThreshold</code></td><td valign="center" align="left">
180      <p>The number of times <code>toString()</code> must be called before the
181      cache is activated. If not specified, the default value of
182      <code>20000</code> will be used.</p>
183    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.cacheSize</code></td><td valign="center" align="left">
184      <p>The size of the String cache. If not specified, the default value of
185      <code>200</code> will be used.</p>
186    </td></tr><tr><td valign="center" align="left"><code>tomcat.util.buf.StringCache.maxStringSize</code></td><td valign="center" align="left">
187      <p>The maximum length of String that will be cached. If not specified, the
188      default value of <code>128</code> will be used.</p>
189    </td></tr><tr><td valign="center" align="left"><code>org.apache.tomcat.util. http.FastHttpDateFormat.CACHE_SIZE</code></td><td valign="center" align="left">
190      <p>The size of the cache to use parsed and formatted date value. If not
191      specified, the default value of <code>1000</code> will be used.</p>
192    </td></tr><tr><td valign="center" align="left"><code>org.apache.tomcat.util. net.NioSelectorShared</code></td><td valign="center" align="left">
193      <p>If <code>true</code>, use a shared selector for servlet write/read. If
194      not specified, the default value of <code>true</code> will be used.</p>
195    </td></tr></table>
196
197</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr size="1" noshade></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font size="-1" color="#525D76"><em>
198        Copyright &copy; 1999-2008, Apache Software Foundation
199        </em></font></div></td></tr></table></body></html>
Note: See TracBrowser for help on using the repository browser.