Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 126599

Summary: [doc] Update runtime options for 3.2
Product: [Eclipse Project] Equinox Reporter: DJ Houghton <dj.houghton>
Component: CompendiumAssignee: equinox.compendium-inbox <equinox.compendium-inbox>
Status: RESOLVED FIXED QA Contact:
Severity: normal    
Priority: P3 Keywords: Documentation
Version: 3.2   
Target Milestone: 3.2 RC4   
Hardware: PC   
OS: Windows XP   
Whiteboard:
Attachments:
Description Flags
patch none

Description DJ Houghton CLA 2006-02-06 11:39:41 EST
We need to update all of the System properties and runtime options for the 3.2 release. This bug report can be used to collect the list of all that needs to be updated.

-----
osgi.nl.user - System property which is set when the user explicitly adds -nl to the command-line arguments. See bug 79232 for details.
Comment 1 Roy Paterson CLA 2006-02-06 16:17:17 EST
declarativeservices.cacheXML - System property used by org.eclipse.equinox.ds bundle.  Controls whether DS caches the results of parsing component XML.  Defaults to TRUE.
Comment 2 Thomas Watson CLA 2006-02-09 09:28:43 EST
From bug 113718

osgi.bundlefile.limit

The property can be used to limit the number of jar files the framework will keep open.  The minimum value allowed is 10.  By default the value is unlimited.
Comment 3 Simon Kaegi CLA 2006-02-09 09:41:21 EST
osgi.framework.useSystemProperties [true / false]

This system property controls whether the FrameworkProperties are backed by System or held privately per instance of the framework. By default FrameworkProperties are backed by System [e.g. true].
Comment 4 Thomas Watson CLA 2006-02-16 12:39:17 EST
osgi.filepermissions.command

specifies an optional OS specific command to set file permissions on extracted native code.  On some operating systems it is required that native libraries be set to executable.  This optional property allows you to specify the command.  For example, on a UNIX style OS you could have the following value

osgi.filepermissions.command="chmod +rx [fullpath]"

The [fullpath] is used to substitute the actual file path by the framework.
Comment 5 Thomas Watson CLA 2006-03-06 14:48:58 EST
osgi.support.signiture.verify = (true | false) default is false

When set to true the framework will load certificates from signed jars and verify the content is not corrupted at runtime.  

The certificates will also be used to answer the following methods on Class:

Class.getSigners()
Class.getProtectionDomain().getCodeSource().getCertificates()

Comment 6 Thomas Watson CLA 2006-03-06 15:25:17 EST
In comment 5
The property name had a typo, the property name should be:

osgi.support.signature.verify = (true | false) default is false
             ^^^^^^^^^
Comment 7 Thomas Watson CLA 2006-04-12 09:31:19 EDT
From bug 105941

osgi.console.encoding

If set then the specified value is used as the encoding for the console (see osgi.console).  If not set then the value of the file.encoding property is used.  If file.encoding is not set then iso8859-1 is used as the default.
Comment 8 Thomas Watson CLA 2006-04-12 16:33:19 EDT
from bug 133343

osgi.framework.library.extensions

Specifies a comma ',' separated list of additional library file extensions that must be searched for.  If not set then only the library name returned by System.mapLibraryName(String) will be used to search.  This is needed for certain operating systems which allow more than one extension for a library.  For example AIX allows library extensions of .a and .so, but System.mapLibraryName(String) will only return names with the .a extension.
Comment 9 Thomas Watson CLA 2006-04-19 17:51:53 EDT
from bug 136860

osgi.contextClassLoaderParent

The classloader type to use as the parent classloader of the context classloader used by the Framework.  The valid types are the following:

 - app - the application classloader
 - boot - the boot classloader
 - ext - the ext classloader
 - fwk - the framework classloader
 - ccl - the original context classloader that was set when the framework launched (default value)
Comment 10 Thomas Watson CLA 2006-04-21 15:39:41 EDT
options for the new framework adaptor hooks:

osgi.hook.configurators

Specifies the comma ',' separated list of hook configurators.  If this property is set then the list of configurators specified will be the only configurators used.  Any hook configurators specified in hookconfigurators.properties files will be ignored.

osgi.hook.configurators.include

Specifies a comma ',' separated list of additional hook configuratiors.  This is helpful for configuring optional hook configurators.  This option is ignored if the osgi.hook.configurators option is used

osgi.hook.configurators.exclude

Specifies a comma ',' separated list of hook configurators to exclude.  This is helpful for disabling hook configurators that are specified in hook configurator properties files.  This option is ignored if the osgi.hook.configurators option is used

Comment 11 Thomas Watson CLA 2006-05-01 17:03:45 EDT
eclipse.stateSaveDelayInterval

Specifies the delay interval (in milliseconds) for persisting state change requests.  The default is 30000 ms (30 seconds).  State change requests are delayed to prevent massive amounts of disk writes while performing administrative operations (e.g. installing bundles).  The delay interval is used to wait for a period of inactivity before persisting the framework state information.
Comment 12 Thomas Watson CLA 2006-05-08 14:21:59 EDT
Created attachment 40625 [details]
patch

Patch to add the new runtime options.  DJ can you review/release?  I do not have write access to the org.eclipse.platform.doc.isv project.
Comment 13 DJ Houghton CLA 2006-05-08 14:35:11 EDT
Released.