Eclipse futási beállítások

3.1 változat - Utolsó felülvizsgált: 2005. június 15.

Az Eclipse platform rendkívül jól konfigurálható. A konfiguráció bevitele parancssori paraméterek formájában és rendszertulajdonságok megadásával történik. Számos esetben a parancssori paraméterek egyszerűen gyorsbillentyűk a kapcsolódó rendszertulajdonságok megadására. A valóságban sokkal több rendszertulajdonság-beállítás létezik, mint parancssori paraméter.

Parancssori paraméterek

Az alábbiakban az Eclipse futási környezet különböző részei által feldolgozott parancssori paramétereket soroljuk fel. Ezek nagy része rendszertulajdonságokkal is meghatározható, vagy a parancssorban a -D VM paraméterekkel, az értékek megadásával a config.ini fájlban vagy egy <launcher>.ini fájl segítségével. A két utóbbi technika alkalmazásával a parancssori paraméterek használatának teljes mellőzésével lehet személyre szabni az Eclipse-et.

A lista minden paraméteréhez meg van adva a megfelelő rendszertulajdonság-kulcs (kapcsos zárójelek között). Megadtuk azt az Eclipse futási réteget is, ahol a parancssori paraméter feldolgozásra kerül (sima zárójelek között). Ez azok számára hasznos, akik le szeretnék cserélni a futási környezet részeit valamilyen speciális igénynek megfelelően.

-application <id> (futási környezet)
megfelel annak, ha az eclipse.application paraméter számára <id> értéket adunk meg.
-arch <architecture> (OSGi)
megfelel annak, ha az osgi.arch paraméter számára <architecture> értéket adunk meg.
-clean (OSGi)
megfelel annak, ha az osgi.clean paraméter számára "true" értéket adunk meg.
-configuration <location> (fő réteg)
megfelel annak, ha az osgi.configuration.area paraméter számára <location> értéket adunk meg.
-console [port] (OSGi)
megfelel annak, ha az osgi.console paraméter számára a [port] értéket adjuk meg, illetve egy üres karaktersorozatot, ha az alapértelmezett portot kell használni (vagyis ha a port nincs megadva).
-consoleLog (futási környezet)
megfelel annak, ha az eclipse.consoleLog paraméter számára "true" értéket adunk meg.
-data <location> (OSGi)
megfelel annak, ha az osgi.instance.area paraméter számára <location> értéket adunk meg.
-debug [options fájl] (OSGi)
megfelel annak, ha azosgi.debug paraméter számára az [options fájl] értéket adjuk meg, vagy egy üres karaktersorozatot, amellyel egyszerűen engedélyezzük a hibakeresést (ha az options fájl helye nincs megadva).
-dev [bejegyzések] (OSGi)
megfelel annak, ha az osgi.dev paraméter számára a [bejegyzések] értéket adjuk meg, vagy egy üres karaktersorozatot, amellyel egyszerűen engedélyezzük a dev módot (ha nincsenek megadva bejegyzések).
-endSplash <command> (fő réteg)
meghatározza, hogy milyen paranccsal tüntethető el a nyitóképernyő. Általában az Eclipse végrehajtható fájl adja meg.
-feature <feature id> (futási környezet)
megfelel annak, ha azeclipse.product paraméter számára <feature id> értéket adunk meg.
-framework <location> (Main)
megfelel annak, ha az osgi.framework paraméter számára <location> értéket adunk meg.
-initialize (fő réteg)
inicializálja a futtatott konfigurációt. Minden, a futási környezethez kapcsolódó adatstruktúra és gyorsítótár frissítésre kerül. Semmilyen felhasználók vagy bedolgozók által megadott konfigurációs adat nem kerül kiürítésre. Egyetlen alkalmazás sem fut, minden termékspecifikáció figyelmen kívül hagyásra kerül, és semmilyen felhasználói felület sem jelenik meg (pl. nem tűnik el a nyitóképernyő).
-install <location> (fő réteg)
megfelel annak, ha az osgi.install.area paraméter számára <location> értéket adunk meg.
-keyring <location> (futási környezet)
a hitelesítési adatbázis helye a lemezen. Ezt a paramétert együtt kell használni a -password paraméterrel.
-name <string> NEW
Az alkalmazás indításakor a feladatsoron megjelenítendő név. Ha nincs beállítva, akkor a név a végrehajtható fájl neve.
-nl <locale> (OSGi)
megfelel annak, ha az osgi.nl paraméter számára <locale> értéket adunk meg.
-noExit (OSGi)
megegyezik az osgi.noShutdown "true" értékre állításával
-noLazyRegistryCacheLoading (futási környezet)
megfelel annak, ha az eclipse.noLazyRegistryCacheLoading paraméter számára "true" értéket adunk meg.
-noRegistryCache (futási környezet)
megfelel annak, ha az eclipse.noRegistryCache paraméter számára "true" értéket adunk meg.
-noSplash (végrehajtható, fő réteg)
azt vezérli, hogy a nyitóképernyő megjelenjen vagy ne jelenjen meg.
-os <operating system> (OSGi)
megfelel annak, ha az osgi.os <operating system> értéket adunk meg.
-password <password> (futási környezet)
A hitelesítési adatbázis jelszava.
-pluginCustomization <location> (futási környezet)
megfelel annak, ha az eclipse.pluginCustomization paraméter számára <location> értéket adunk meg.
-product <id> (OSGi)
megfelel annak, ha azeclipse.product paraméter számára <id> értéket adunk meg.
-showSplash <command> (fő réteg)
meghatározza, hogy milyen paranccsal jeleníthető meg a nyitóképernyő. Általában az Eclipse végrehajtható fájl adja meg.
-startup <location> (végrehajtható) NEW
Az Eclipse indításához használt jar helye. A hivatkozott jar fájl Main-Class attribútumát be kell állítani. Ha ez a paraméter nincs beállítva, akkor az a startup.jar kerül felhasználásra, amelyik ugyanabban a mappán található, mint a végrehajtható fájl.
-user <location> (OSGi)
megfelel annak, ha az osgi.user.area paraméter számára <location> értéket adunk meg.
-vm <path to java executable> (végrehajtható, fő réteg)
amikor átadásra kerül az Eclipse végrehajtható fájlnak, ez a beállítás kerül felhasználásra az Eclipse-et futtató Java virtuális gép megkeresésére. A megfelelő Java végrehajtható fájl teljes fájlrendszeri elérési útjának kell lennie. Ha nincs megadva, az Eclipse végrehajtható fájl egy keresési algoritmust használ a megfelelő virtuális gép felkutatására. Bármelyik esetben a végrehajtható fájl ezután átadja az elérési utat a Java főréteg által használt aktuális virtuális gépnek a -vm paraméter használatával. A Java főréteg ezután eltárolja ezt az értéket az eclipse.vm-ben.
-vmargs [vmargs*] (végrehajtható, fő)
amikor átadásra kerül az Eclipse-nek, ez a beállítás kerül felhasználásra az Eclipse-et futtató Java virtuális gép tevékenységének személyre szabására. Ha meg van adva, akkor ennek a beállításnak a parancssor végén kell jönnie. Még ha nincs is megadva a végrehajtható parancssorban, a végrehajtható fájl automatikusan hozzáadja a fontos paramétereket (köztük az elindított osztályt) a -vmargs paraméterrel a Javába továbbított parancssorhoz. A Java főréteg ezután eltárolja ezt az értéket az eclipse.vmargs-ban.
-ws <window system> (OSGi)
megfelel annak, ha az osgi.ws paraméter számára <window system> értéket adunk meg.

Elavult parancssori paraméterek

A következő parancssori paraméterek már nem relevánsak vagy meghaladottak, azokat a futási környezet felemésztette és nem kerültek átadásra a futtatott alkalmazásnak a visszamenőleges kompatibilitás fenntartására. .

-boot
lásd: -configuration
-classLoaderProperties
már nem releváns
-firstUse
már nem releváns
-newUpdates
már nem releváns
-noPackagePrefixes
már nem releváns
-noUpdate
már nem releváns
-plugins
már nem releváns
-update
már nem releváns

Egyebek

A következő parancssori paramétereket különféle Eclipse bedolgozók határozzák meg, és csak akkor támogatottak, ha a meghatározó bedolgozó telepítve van, valamint feloldva és aktiválva.

-noVersionCheck (munkaterület)
<description>
-perspective (munkaterület)
<description>
-refresh (org.eclipse.core.resources)
<description>
-showLocation (org.eclipse.ui.ide.workbench)
<description>
-allowDeadlock
<description>

Rendszertulajdonságok

A következő rendszertulajdonságokat az Eclipse használja. Figyeljen rá, hogy az "osgi" szóval kezdődők az OSGi keretrendszer-implementációra jellemzők, míg az "eclipse" kezdetűek az OSGi keretrendszer fölött elhelyezkedő Eclipse futási környezet szempontjából különlegesek.

Ezek közül a tulajdonságok közül sok rendelkezik parancssori paraméter megfelelővel (lásd a parancssori paraméterek részt, valamint a kapcsos zárójelben található értékeket). A felhasználók szabadon választhatnak aközött, hogy a parancssort vagy a tulajdonságbeállítást használják egy adott érték megadására. A tulajdonságok a következő módokon állíthatók be:

eclipse.application {-application}
a futtatandó alkalmazás azonosítója. Az itt megadott érték felülír minden, a futtatott termék által (lásd: eclipse.product) meghatározott alkalmazást
eclipse.commands
a parancssori paraméterek új sor karakterrel elválasztott listája, amely az Eclipse indításakor átadásra kerül
eclipse.consoleLog
ha az érték "true", minden naplófájl-kimenet elküldésre kerül a Java System.out eleme számára is (jellemzően vissza a parancs shellnek, ha van ilyen). Rendkívül kényelmes a -debug paraméterrel együtt használva.
eclipse.debug.startupTime
a jelenlegi munkamenetben elindított Java virtuális gép elindításától eltelt idő ezredmásodpercekben.
eclipse.exitcode
<description>
eclipse.exitdata
<description>
eclipse.log.backup.max
a mentési naplófájlok maximálisan engedélyezhető száma. Ha a mentési naplófájlok elérik a maximális számot, akkor a naplófájlok forgatásának hatására a legrégebbi mentési fájl törlésre kerül. Az alapértelmezett érték "10". Negatív vagy nulla érték megadása esetén az alapértelmezett érték kerül alkalmazásra.
eclipse.log.size.max
a naplófájl maximális mérete kilobyte-ban. A naplófájl forgatásra kerül, ha a fájl mérete meghaladja a maximális értéket. Az alapértelmezett érték az "1000". Negatív érték megadása esetén az alapértelmezett érték kerül alkalmazásra. A nulla azt jelenti, hogy nincs maximális naplóméret.
eclipse.noExtensionMunging
ha az érték "true", a régebbi nyilvántartások abban az állapotban maradnak, ahogy vannak. Az ilyen kiterjesztések alapértelmezésben frissítésre kerülnek az Eclipse 3.0-s verziójában található új kiterjesztési pont azonosítók használatához.
eclipse.noLazyRegistryCacheLoading {-noLazyRegistryCacheLoading}
ha az érték "true", a platform bedolgozó nyilvántartási gyorsítótár betöltési optimalizálása leállításra kerül. A konfigurációs elemek alapértelmezésben csak az igényeknek megfelelően kerülnek betöltésre a nyilvántartási gyorsítótárból (ha elérhető) a memóriafoglaltság csökkentésére. Ez a beállítás kikényszeríti, hogy a nyilvántartási gyorsítótár teljes egészében töltődjön be az indításkor.
eclipse.noRegistryCache {-noRegistryCache}
ha az érték "true", a belső nyilvántartási gyorsítótárat sem írni, sem olvasni nem lehet.
eclipse.pluginCustomization {-pluginCustomization}
a bedolgozó-beállítások alapértelmezett beállításait tartalmazó tulajdonságfájl fájlrendszeri helye. Ezek az alapértelmezett beállítások felülbírálják az elsődleges szolgáltatásban megadott alapértelmezett beállításokat. A relatív útvonalak magától az Eclipse saját aktuális munkakönyvtárától vannak értelmezve.
eclipse.product {-product}
a futó termék azonosítója. Ez vezérli a különféle arculati információkat, és hogy melyik alkalmazás van használatban.
eclipse.startTime
A tulajdonság az Eclipse elindításakor kerül beállításra. A tulajdonság értéke a System.currentTimeMillis() által visszaadott érték karaktersorozat ábrázolása. Ezt az értéket nem a felhasználók állítják be.
eclipse.vm {-vm}
az az útvonal, amelyet a Java végrehajtható fájl használ az Eclipse futtatására. Ez az információ az újraindítási parancssorok összeállítására használatos.
eclipse.vmargs {-vmargs}
felsorolja az Eclipse futtatásánál használt virtuális gép paramétereket. Ez az információ az újraindítási parancssorok összeállítására használatos.
osgi.adaptor
a használandó OSGi keretrendszer-átalakító osztályneve.
osgi.arch {-arch}
lásd: -arch
osgi.baseConfiguration.area
egy alapkonfigurációt ad meg, amely akkor kerül felhasználásra, ha az osgi.configuration.area nincs megadva.
osgi.bundles
Vesszőkkel elválasztott lista azokról a kötegekről, amelyek automatikusan telepítésre kerülnek és opcionálisan elindulnak, ha a rendszer felállt és fut. Az egyes bejegyzések formája:
    <URL | egyszerű köteghely>[@ [<indítási szint>]
[":start"]]
Ha az indítási szint (>0 egész) ki van hagyva, akkor a keretrendszer az alapértelmezett indítási szintet fogja használni a köteghez. Ha a "start" címke hozzá van adva, akkor a köteg elindítottként lesz megjelölve a telepítést követően. Az egyszerű csomaghelyek a keretrendszer szülőkönyvtárához képest kerülnek értelmezésre. Az indítási szint jelzi azt az OSGi indítási szintet, amelyen a kötegnek futnia kell. Ha ez az érték nincs megadva, a rendszer kiszámít egy megfelelő alapértelmezést.
osgi.clean
ha az érték "true", minden, az OSGi keretrendszer és az Eclipse futási környezet által használt gyorsítótárazott adat kitörlődik. Ki fogja törölni a köteg-függőségek feloldásának tárolására használt gyorsítótárat, illetve az Eclipse kiterjesztési nyilvántartási adatokat is. A beállítás használata kikényszeríti, hogy az Eclipse újrainicializálja ezeket a gyorsítótárakat.
osgi.configuration.cascaded
ha "true" értékre van állítva, ez a beállítás rárakódik egy szülő beállításra. A szülőkonfigurációt az osgi.sharedConfiguration.area adja meg. További részletekért lásd a helyszínek részt.
osgi.configuration.area {-configuration}
a platform e futtatásának a konfigurációs adatainak a helye. A konfiguráció meghatározza azt, hogy mely bedolgozók fognak futni, valamint különféle más beállításokat is. További részletekért lásd a helyszínek részt.
osgi.configuration.area.default
a platform e futtatásának a konfigurációs adatainak alapértelmezett helye. A konfiguráció meghatározza azt, hogy mely bedolgozók fognak futni, valamint különféle más beállításokat is. Ez az érték (vagyis az alapértelmezett beállítás) csak akkor használható, ha nincs beállítva érték az osgi.configuration.area számára. További részletekért lásd a helyszínek részt.
osgi.console {-console}
ha nem nulla értékre van állítva, az OSGi konzol (amennyiben telepítve van) állapota engedélyezett. Ha az érték egy megfelelő egész szám, akkor azt a rendszer egy portként értelmezi, amelyen a konzol figyel, és kimeneteit az adott portra irányítja. Kényelmes megoldás a rendszere állapotának vizsgálatához.
osgi.console.class
a kérésre futó konzol osztályneve
osgi.debug {-debug}
ha nem nulla értékre van állítva, a platform hibakeresési módba kapcsol. Ha az érték egy karaktersorozat, akkor azt a .options fájl helyeként értelmezi a rendszer. Ez a fájl jelzi, hogy mely hibakeresési pontok állnak rendelkezésre egy bedolgozóhoz, és hogy ezek engedélyezettek-e vagy nem. Ha a hely nincs megadva, a platform a telepítési könyvtár alatt keresi a .options fájlt.
osgi.dev {-dev}
ha üres karaktersorozatra van állítva, egyszerűen bekapcsol a dev mód. Ez a tulajdonság osztályútvonal-bejegyzések vesszővel elválasztott listájaként is meg lehet adva, amelyek hozzáadásra kerülnek az egyes bedolgozók osztályútvonalához, vagy tartalmazhatja a bedolgozók készletének egyéni osztályútvonal-kiegészítéseit hordozó Java tulajdonságfájl URL-jét is. Minden egyes bedolgozóhoz, amelyik egyéni fejlesztési idejű osztályútvonalat igényel, a fájlban található egy
    <bedolgozó azonosító>=<felveendő
osztályútvonal-bejegyzések>
formátumú bejegyzés, ahol a bedolgozó azonosító"*" illeszkedik az egyébként nem említett bedolgozókhoz.
osgi.framework
az OSGi keretrendszer URL-helyszíne. Akkor hasznos, ha az Eclipse telepítés szétesett. További részletekért lásd a helyszínek részt.
osgi.frameworkClassPath
az OSGi keretrendszer-implementáció osztályútvonal-bejegyzéseinek vesszőkkel elválasztott listája. A relatív helyek a keretrendszer helyéhez (lásd: osgi.framework) képest vannak értelmezve.
osgi.framework.extensions
a keretrendszer-kiterjesztések vesszővel elválasztott listája. Az egyes bejegyzések formája:
    <URL | simple bundle location>
Ha egy egyszerű köteghely van megadva (nem egy URL), akkor az org.eclipse.osgi köteg szülőkönyvtárában keresés kerül hajtásra. A keretrendszer-kiterjesztések segítségével az Eclipse különböző keretrendszer-átalakítóval futtatható. A keretrendszer-kiterjesztés tartalmazhat egy eclipse.properties fájlt a rendszertulajdonságok beállításához. A keretrendszer-átalakítót biztosító keretrendszer-kiterjesztés például az osgi.adaptor tulajdonság beállításával megadhatja, hogy mi az átalakítóosztály.
osgi.framework.shape
az Eclipse keretrendszer-megvalósítás alakjára van állítva. Ez a tulajdonság akkor kerül beállításra, amikor az Eclipse platform elindításra került és a felhasználó nem kívánja beállítani. A "jar" érték jelzi, hogy az Eclipse OSGi keretrendszert egy jar tartalmazza. A "folder" érték jelzi, hogy az Eclipse OSGi keretrendszert egy könyvtár tartalmazza.
osgi.java.profile
a használandó JRE profil URL címe. A JRE profil az org.osgi.framework.system.packages és org.osgi.framework.bootdelegation tulajdonság értékeit tartalmazza. Ha az osgi.java.profile nincs beállítva, akkor a profil a futó JRE java.specification.version értéke alapján kerül kiválasztásra.
osgi.java.profile.bootdelegation
az osgi.java.profile java profil tartalmazhat egy "org.osgi.framework.bootdelegation" tulajdonságot. Ez az érték az "org.osgi.framework.bootdelegation" rendszertulajdonság beállításához használható. Az osgi.java.profile.bootdelegation jelzi a használandó rendszerinítás-átruházási (bootdelegation) irányelvét. Az alábbi értékek érvényesek (az alapértelmezés a figyelmen kívül hagyás):
osgi.install.area {-install}
a platform telepítési helye. Ez a beállítás jelzi az alap Eclipse bedolgozók helyét, és hasznos, ha az Eclipse telepítés szétesett. További részletekért lásd a helyszínek részt.
osgi.instance.area {-data}
a példányadatok helye ehhez a szekcióhoz. A bedolgozók az adataik tárolására használják ezt a helyet. A Resources bedolgozó például ezt használja a projektek alapértelmezett helyeként (más néven munkaterületként). További részletekért lásd a helyszínek részt.
osgi.instance.area.default
a példányadatok alapértelmezett helye ehhez a szekcióhoz. A bedolgozók az adataik tárolására használják ezt a helyet. A Resources bedolgozó például ezt használja a projektek alapértelmezett helyeként (más néven munkaterületként). Ez az érték (vagyis az alapértelmezett beállítás) csak akkor használható, ha nincs beállítva érték az osgi.instance.area számára. További részletekért lásd a helyszínek részt.
osgi.locking
a platform ezen futásához használandó zárolási típus. Érvényes zárolási típusok: "java.io", "java.nio" és "none". Az alapértelmezett érték a "java.nio", kivéve, ha a JRE nem támogatja a "java.nio" értéket. Ebben az esetben a "java.io" az alapértelmezett.
osgi.manifest.cache
az a hely, ahol a létrejövő leírófájlok felfedezésre és elkészítésre kerülnek. Az alapértelmezés a konfigurációs terület, de a leírófájl gyorsítótára külön is tárolható.
osgi.nl {-nl}
annak a területi beállításnak a neve, amelyen az Eclipse platform futni fog. Az NL értékeknek követniük kell a szabványos Java területi beállítás elnevezési megállapodásokat.
osgi.noShutdown {-noExit}
Ha "true", akkor a VM az Eclipse alkalmazás befejezése után nem lép ki. Ez az OSGi keretrendszer megvizsgálásához hasznos, miután az Eclipse alkalmazás befejeződött.
osgi.os {-os}
az operációs rendszer értéke. Az értéknek az Eclipse által ismert Eclipse processzorarchitektúra-nevek valamelyikének kell lennie (pl.: x86, sparc, ...).
osgi.parentClassLoader
a szülő-osztálybetöltőként használandó osztálybetöltő-típus a keretrendszeren telepített kötegekhez. Érvényes típusok a következők:
osgi.requiredJavaVersion
Az Eclipse indításához szükséges minimális java verzió. Az alapértelmezett érték az "1.4.1".
osgi.resolverMode
a keretrendszeren telepített kötegeket feloldó mód. A "strict" érték a feloldót szigorú módba állítja. Az alapértelmezett feloldó mód nem szigorú. Ha a feloldó szigorú módban van, akkor a keretrendszer hozzáférés-korlátozási szabályokat kényszerít ki az exportált csomagok osztályainak és erőforrásainak betöltésekor, amely az x-internal vagy x-friends direktívát adja meg.
osgi.sharedConfiguration.area
a platform ezen futásának megosztott konfigurációs helye. Ha az osgi.configuration.cascaded tulajdonság értéke "true", akkor a megosztott konfigurációs terület kerül alkalmazásra szülőkonfigurációként.
osgi.splashLocation
az Eclipse indítása során megjelenített nyitóképernyő (.bmp fájl) abszolút URL-helyszíne. Ez a beállítás minden, az osgi.splashPath tulajdonságban beállított értéket felülír.
osgi.splashPath
URL-címek vesszővel elválasztott listája, amelyeken a rendszer egy splash.bmp nevű fájlt keres. Ezt a tulajdonságot az osgi.splashLocation elemben megadott bármilyen érték felülírja.
osgi.syspath
azon elérési útra van állítva, amelyen az OSGi keretrendszer (org.eclipse.osgi) megvalósítás található. Például: "<eclipse telepítési útvonal>/eclipse/plugins". Ez a tulajdonság akkor kerül beállításra, amikor az Eclipse platform elindításra került és a felhasználó nem kívánja beállítani.
osgi.user.area {-user}
a felhasználói terület helye. A felhasználói terület adatokat (például beállításokat) tartalmaz, amelyek jellemzőek az operációs rendszer felhasználójára, és függetlenek bármely Eclipse telepítéstől, beállítástól vagy példánytól. További részletekért lásd a helyszínek részt.
osgi.user.area.default
a felhasználói terület alapértelmezett helye. A felhasználói terület adatokat (például beállításokat) tartalmaz, amelyek jellemzőek az operációs rendszer felhasználójára, és függetlenek bármely Eclipse telepítéstől, beállítástól vagy példánytól. Ez az érték (vagyis az alapértelmezett beállítás) csak akkor használható, ha nincs beállítva érték az osgi.user.area számára. További részletekért lásd a helyszínek részt.
osgi.ws {-ws}
az ablakrendszer értéke. Az értéknek az Eclipse által ismert Eclipse ablakrendszer-nevek valamelyikének kell lennie (pl.: win32, motif, ...).

Helyszínek

Az Eclipse futási környezet meghatároz egy sor helyet, amelyek kontextust biztosítanak a bedolgozó-fejlesztők számára az adatok olvasásához/tárolásához, illetve biztosítják az Eclipse felhasználóknak az ellenőrzést az adatmegosztás hatóköre és a láthatóság felett. Az Eclipse a következő helyfogalmakat határozza meg:

Felhasználói (-user) {osgi.user.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
A felhasználói helyszínek a felhasználókra jellemzők. A felhasználói helyszín általában a Java user.home rendszertulajdonság-értékén alapszik, de felülírható. Az olyan információk, mint például a felhasználói hatókörű beállítások és a bejelentkezési információk, a felhasználói helyszínen lehetnek megtalálhatók.
Telepítési (-install) {osgi.install.area} [@user.home, @user.dir, filepath, url]
Telepítési helyszín az, ahová maga az Eclipse telepítésre került. A gyakorlatban ez a helyszín az a könyvtár (általában az "eclipse"), amely a startup.jar vagy az eclipse.exe futtatási szülőkönyvtára. Ennek a helyszínnek írásvédettnek kell lennie a normál felhasználók számára, ha egy telepítés több felhasználó között lehet megosztva. Be lehet állítani a telepítési helyszínt, és kettéválasztani a startup.jar állományt és az Eclipse többi részét.
Beállítási (-configuration) {osgi.configuration.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
A beállítási helyszínek fájlokat tartalmaznak, amelyek egy telepítő(al)készletet azonosítanak és kezelnek a futtatáshoz. Ilyen módon telepítőnként több konfiguráció is lehet. A telepítők alapértelmezett beállítási területtel is érkezhetnek, de az általános indítási szituáció az, hogy a futási környezet megkísérel egy jobban írható konfigurációs helyszínt találni.
Példány (-data) {osgi.instance.area} [@none, @noDefault, @user.home, @user.dir, filepath, url]
A példányhelyszínek felhasználók által megadott adattermékeket tartalmaznak. A Resource bedolgozó például a példány területet használja munkaterület helyszínként, és így ez a projektek alapértelmezett saját helye. Más bedolgozók szabadon írhatnak fájlokat erre a helyre.

Miközben a felhasználók e helyek bármelyikét beállíthatják, az Eclipse ki fogja számítani az ésszerű alapértelmezéseket, ha az értékek nincsenek megadva. A helymegadás leggyakoribb használati területe a példány terület, vagy IDE kontextusban a munkaterület. Az alapértelmezett Eclipse konfiguráció futtatásához egy adott adatkészlettel megadhatja a következőt:

    eclipse -data c:\mydata

További részletek

A helyek URL-címek. Az egyszerűség kedvéért a fájlelérési útvonalak is elfogadottak, és automatikusan file: URL-ekké konvertálódnak. A jobb kézbentarthatóság és a kényelem érdekében egy sor szimbolikus hely is használható. Figyeljen rá, hogy a helytípusok és a szimbolikus értékek nem minden kombinációja érvényes. Az alábbi tábla részletesen ismerteti, hogy mely kombinációk lehetségesek. Mivel az alapértelmezett eset minden helyhez beállítandó, érvényes és írható, bizonyos bedolgozók lehet, hogy hibát fognak jelezni más beállításoknál, még ha lehetségesként is vannak felsorolva. Ésszerűtlen például elvárni, hogy egy felhasználói adatokra fókuszáló bedolgozó (például az Eclipse Resources bedolgozó) túl sokra jusson, ha a példány terület nincs megadva. A bedolgozófejlesztőktől függ, hogy kiválasszák azokat a beállításokat, amelyeket támogatnak, és ennek megfelelően tervezzék a szolgáltatásokat.

@none
Jelzi, hogy a vonatkozó hely soha ne legyen sem kifejezetten beállítva, sem alapértelmezett értékére állítva. Egy PCP-stílusú alkalmazás például, amelynek nincsenek felhasználói adatai, annak megelőzésére használhatja az osgi.instance.area=@none beállítást, hogy idegen fájlok kerüljenek a lemezre írásra. A @none után nem következhet semmilyen további elérési út szegmens.
@noDefault
Kikényszeríti, hogy egy hely meghatározatlan vagy kifejezetten meghatározott legyen (vagyis hogy az Eclipse ne számítsa ki automatikusan az alapértelmezett értéket). Ez akkor hasznos, ha engedélyezni szeretné a megfelelő helyen található adatokat, de az Eclipse alapértelmezett értéke nem jó. A @noDefault után nem következhet semmilyen további elérési út szegmens.
@user.home
Arra utasítja az Eclipse-et, hogy számítsa ki a hely értékét a felhasználó saját könyvtárához képest. A @user.home után további elérési útvonal szegmensek következhetnek. A "@user.home" karaktersorozat minden esetben egyszerűen behelyettesítésre kerül a Java "user.home" rendszertulajdonság-értékével. Az
    osgi.instance.area=@user.home/myWorkspace
beállítás például a
    file:/users/bob/myWorkspace értéket eredményezi.
@user.dir
Arra utasítja az Eclipse-et, hogy számítsa ki a hely értékét a jelenlegi munkakönyvtárhoz képest. A @user.dir után további elérési útvonal szegmensek következhetnek. A "@user.dir" karaktersorozat minden esetben egyszerűen behelyettesítésre kerül a Java "user.dir" rendszertulajdonság-értékével. Az
    osgi.instance.area=@user.dir/myWorkspace
beállítás például a
    file:/usr/share/eclipse/myWorkspace értéket eredményezheti.
hely/érték
alapértelmezés támogatása
fájl/URL
@none
@noDefault
@user.home
@user.dir
példány
igen
igen
igen
igen
igen
igen (alapértelmezett)
beállítás
igen
igen
igen*
igen*
igen
igen
telepítés
nem
igen
nem
nem
igen
igen
felhasználó
igen
igen
igen
igen
igen
igen

* jelzi, hogy ez a beállítás technikailag lehetséges, de a gyakorlatban meglehetősen bonyolultan kezelhető. Főleg, mert egy konfigurációs hely nélkül az Eclipse futási környezet csak az OSGi keretrendszer elindításáig jut.

Írásvédett helyek

A hely a ".readOnly" helytulajdonsághoz adásával és a "true" érték beállításával írásvédettként adható meg. Az alábbi tulajdonságok segítségével a megfelelő helyek megadhatók írásvédettként:

Indító ini fájl

Az eclipse.exe és az RCP alkalmazások még általánosabb végrehajtható fájljai a paramétereiket egy társított ini fájlból olvassák. Ez a fájl egy platform-független módszert biztosít az argumentumok átadásához, amelyeket korábban közvetlenül a parancssorban kellett megadni, mint például a vm vagy vm argumentumok. Minden paraméter megadható ebben a fájlban, de a különböző telepítések közötti karbantarthatóság és konzisztencia érdekében csak a vm helyet és az vm argumentumokat adja meg ebben az ini fájlban, a többihez pedig a config.ini fájlt használja.

Fájlformátum

A fájl a végrehajtható fájl neve alapján kell elnevezni (az eclipse.exe például eclipse.ini lesz, a launcher.exe pedig launcher.ini) és minden paramétert a fájl új sorában kell megadni. Az alábbiakban egy ilyen fájlra látható példa, amely a vm helyet és néhány paramétert ad meg:

-vm
c:/myVm/java.exe
-vmargs
-Dms40M