Eclipse startup is controlled by the options in
$ECLIPSE_HOME is not defined, the default
eclipse.ini in your Eclipse installation directory is used.
eclipse.ini is a text file containing command-line options that are added to the command line used when Eclipse is started up. There are many options available, please see here.
- Each option and each argument to an option must be on its own line.
- All lines after
-vmargsare passed as arguments to the JVM, so all arguments and options for eclipse must be specified before
-vmargs(just like when you use arguments on the command-line)
eclipse.ini contains something like
-showsplash org.eclipse.platform --launcher.XXMaxPermSize 256m -vmargs -Xms40m -Xmx256m
which sets the heap space to 40MB initially and a maximum of 256MB, and also specifies a maximum PermGen size of 256MB.
One of the most recommended options to use is to specify a specific JVM for Eclipse to run on. The following
eclipse.ini demonstrates correct usage of the -vm option (for a Windows system):
-showsplash org.eclipse.platform --launcher.XXMaxPermSize 256m -vm C:\Java\JDK\1.5\bin\javaw.exe -vmargs -Xms40m -Xmx512m
On a Linux system, the file looks quite similar:
-showsplash org.eclipse.platform --launcher.XXMaxPermSize 256m -vm /opt/sun-jdk-1.6.0.02/bin/java -vmargs -Xms40m -Xmx512m
On a Mac OS X system, to specify Java 6:
-showsplash org.eclipse.platform --launcher.XXMaxPermSize 256m -vm /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/bin/java -vmargs -Xms40m -Xmx512m
Note the format as it is important to be exact:
-vmoption and its value (the path) must be on separate lines.
- The value must be the full absolute path to the Java executable, not just to the Java home directory.
- FAQ How do I run Eclipse?
- FAQ How do I increase the heap size available to Eclipse?
- FAQ How do I increase the permgen size available to Eclipse?
This FAQ was originally published in Official Eclipse 3.0 FAQs. Copyright 2004, Pearson Education, Inc. All rights reserved. This text is made available here under the terms of the Eclipse Public License v1.0.