| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
| "http://www.w3.org/TR/html4/loose.dtd"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <title>Arguments Tab</title> |
| <link href="../../book.css" rel="stylesheet" type="text/css"> |
| <style type="text/css"> |
| <!-- |
| .style1 { |
| font-size: 18px; |
| font-weight: bold; |
| } |
| .style2 { |
| font-size: 12pt; |
| font-weight: bold; |
| } |
| --> |
| </style> |
| </head> |
| |
| <body> |
| <p class="style1">Arguments Tab</p> |
| <p>You can easily test your bundle under different conditions by customizing the launching program and VM arguments on the <strong>Arguments Tab</strong>. </p> |
| <p><img src="../../images/launchers/launcher_equinox_arguments.png" alt="Equinox Arguments Tab" hspace="30"></p> |
| <p> </p> |
| <p class="style2">Program and VM Arguments</p> |
| <p><strong>Program arguments</strong> are values that the <em>Equinox OSGi Framework</em> expects and processes. For example, the <em>-console</em> argument enables the <em>OSGi</em> console allowing you to execute many commands such as installing, starting and stopping bundles. The <em>-console</em> argument is added by default to all newly-created <em>Equinox OSGi Framework</em> launch configurations. </p> |
| <p><strong>VM arguments</strong> are typically values that change the behaviour of the <em>Java Virtual Machine</em> (JVM). For example, the <em>-Xmx256M</em> argument allows the Java heap to grow to 256MB. </p> |
| <p>The <em>Equinox OSGi Framework</em> is also configurable via many system properties which can be passed as VM arguments in the form: <em>-DpropertyName=propertyValue</em>. For example, <em>-Dosgi.clean=true</em> clears all data cached by the OSGi framework.</p> |
| <p>For a list of the program and VM arguments supported by the <em>Equinox OSGi Framework</em>, refer to the following documents: </p> |
| <ul> |
| <li><a href="../../../../org.eclipse.platform.doc.user/tasks/running_eclipse.htm">Running Eclipse</a></li> |
| <li><a href="../../../../org.eclipse.platform.doc.isv/reference/misc/runtime-options.html">Eclipse Runtime Options </a></li> |
| </ul> |
| <p>If you would like the same set of program and VM arguments to be used for all your launch configurations, it is recommended that you use the <a href="../preference_pages/launching_args.htm">Launching Arguments</a> tab on the <strong>Window > Preferences... > Plug-in Development > Target Platform</strong> preference page to create a template that gets propagated into all newly-created launch configurations. </p> |
| <p> </p> |
| <p class="style2">Working Directory</p> |
| <p>The <strong>Working Directory</strong> specifies the directory in which the <em>Equinox OSGi Framework</em> executes (e.g. read and write files into the working directory, etc.). By default, the working directory is the root directory of the Eclipse installation; but, it can be configured by the user to be any writable directory they wish. </p> |
| <p> </p> |
| </body> |
| </html> |
