svn commit: r1341573 - in /db/derby/docs/trunk/src: devguide/cdevbabejgjd.dita ref/rrefproperextdiagsevlevel.dita

[ch...@apache.org]

Author: chaase3
Date: Tue May 22 17:53:40 2012
New Revision: 1341573

URL: http://svn.apache.org/viewvc?rev=1341573&view=rev
Log:
DERBY-5590  Document optional modifyThreadGroup permssion in java 2 security permissions 

Modified a Reference Manual and a Developer's Guide topic.

Patch: DERBY-5590.diff

Modified:
    db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita
    db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita

Modified: db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita?rev=1341573&r1=1341572&r2=1341573&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita (original)
+++ db/derby/docs/trunk/src/devguide/cdevbabejgjd.dita Tue May 22 17:53:40 2012
@@ -109,6 +109,14 @@ in the <ph conref="../conrefs.dita#pub/c
 <dt>permission java.lang.RuntimePermission "getClassLoader"</dt>
 <dd> This permission is also needed when setting the context class loader to avoid class loader leaks. The class loader for the parent is saved and set to null before creation of the thread and restored afterwards. </dd>
 </dlentry><dlentry>
+<dt>permission java.lang.RuntimePermission "getStackTrace";</dt>
+<dt>permission java.lang.RuntimePermission "modifyThreadGroup";</dt>
+<dd>These two permissions are needed to allow extended diagnostics, specifically
+the stack traces of all threads, to be dumped to <i>derby.log</i> on severe
+errors and when the <i>derby.stream.error.extendedDiagSeverityLevel</i> property
+is set. See the documentation of this property in the
+<ph conref="../conrefs.dita#pub/citref"></ph> for details.</dd>
+</dlentry><dlentry>
 <dt>permission javax.management.MBeanServerPermission "createMBeanServer";</dt>
 <dd>Allows <ph conref="../conrefs.dita#prod/productshortname"></ph> to create an
 MBean server. If the JVM running

Modified: db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita?rev=1341573&r1=1341572&r2=1341573&view=diff
==============================================================================
--- db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita (original)
+++ db/derby/docs/trunk/src/ref/rrefproperextdiagsevlevel.dita Tue May 22 17:53:40 2012
@@ -32,6 +32,11 @@ error. If errors have a severity level g
 diagnostic information will appear in the <i>derby.log</i> file. In addition,
 with IBM Java Virtual Machines (JVMs), a javacore file with additional
 information is created.</p>
+<p>To allow the information to be dumped to the log, you must grant two
+permissions to <ph conref="../conrefs.dita#prod/productshortname"></ph> in your
+security policy file. See "Granting permissions to
+<ph conref="../conrefs.dita#prod/productshortname"></ph>" in the
+<ph conref="../conrefs.dita#pub/citdevelop"></ph>.</p>
 <p>Any error raised in a
 <ph conref="../conrefs.dita#prod/productshortname"></ph> system is given a level
 of severity. This property indicates the minimum severity necessary for an error