Bug 3057 - Add section for relative FilePermission for CPA
@@ -1625,6 +1625,34 @@ public void manage(ConditionalPermissionAdmin admin,
</section>
</section>
+ <section>
+ <title>File Permission for Relative Path Names</title>
+
+ <para>A <code>java.io.FilePermission</code> assigned to a bundle via a
+ condition must receive special treatment if the
+ path argument for the <code>FilePermission</code> is a relative path
+ name. A relative path name is one that is not absolute. See the
+ <code>java.io.File.isAbsolute</code> method for more information on
+ absolute path names.</para>
+
+ <para>When a bundle is assigned a <code>FilePermission</code> for a
+ relative path name, the path name is taken to be relative to the
+ bundle's persistent storage area. This allows additional permissions,
+ such as <code>execute</code>, to be assigned to files in the bundle's
+ persistent storage area. For example:</para>
+
+ <programlisting> java.io.FilePermission "-" "execute"</programlisting>
+
+ <para>can be used to allow a bundle to execute any file in the bundle's
+ persistent storage area.</para>
+
+ <para>This only applies to <code>FilePermission</code> objects assigned
+ to a bundle via a condition. Any <code>FilePermission</code> object
+ with a relative path name must be ignored by the
+ <code>AccessControlContext</code> object returned by the
+ <code>getAccessControlContext</code> method.</para>
+ </section>
+
<section xml:id="i1712960">
<title>Implementing Conditions</title>
