Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html lang="en">
<head>
<meta name="copyright" content="Copyright (c) IBM Corporation and others 2006, 2009. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<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">
</head>

<body>
<h1>Arguments Tab</h1>
<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" ></p>

<h2>Program and VM Arguments</h2>
<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="../target_shared/edit_target_arguments_tab.htm">Launching Arguments</a> setting when editing your <a href="../../../concepts/target.htm">Target Platform</a> to create a template that gets propagated into all newly-created launch configurations. </p>

<h2>Working Directory</h2>
<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><img src="../../../images/ngrelr.png" alt="Related reference"></p>
<p>
  <a href="equinox_launcher.htm">OSGi Framework Launcher</a><br>
  <a href="eclipse_application_launcher.htm">Eclipse Application Launcher</a><br>
  <a href="junit_launcher.htm">JUnit Plug-in Test Launcher</a><br>
  <a href="equinox_plugins.htm">Bundles Tab</a><br>
  <a href="equinox_args.htm">Arguments Tab</a><br>
  <a href="equinox_settings.htm">Settings Tab</a><br>
  <a href="tracing.htm">Tracing Tab</a><br>
  <a href="environment.htm">Environment Tab</a><br>
  <a href="common.htm">Common Tab</a>
</p>

</body>
</html>
New to GrepCode? Check out our FAQ X