JAVA啓動參數大全之一:標準參數

前段時間系統升級時遭遇了OOM,具體解決過程見 遭遇OutOfMemoryError
爲了鞏固對於java啓動各項參數的認識,決定將所有參數列舉出來,並一一解釋,以便後查;

java啓動參數共分爲三類;
其一是標準參數 (-),所有的JVM實現都必須實現這些參數的功能,而且向後兼容;
其二是非標準參數 (-X),默認jvm實現這些參數的功能,但是並不保證所有jvm實現都滿足,且不保證向後兼容;
其三是非Stable參數 (-XX),此類參數各個jvm實現會有所不同,將來可能會隨時取消,需要慎重使用;
本文主要描述標準參數部分,剩下的兩個部分將會陸續推出;

標準參數列表如下:
-client
 設置jvm使用client模式,特點是啓動速度比較快,但運行時性能和內存管理效率不高,通常用於客戶端應用程序或者PC應用開發和調試。

-server
 設置jvm使server模式,特點是啓動速度比較慢,但運行時性能和內存管理效率很高,適用於生產環境。在具有64位能力的jdk環境下將默認啓用該模式,而忽略-client參數。

-agentlib:libname[=options]
 用於裝載本地lib包;
 其中 libname爲本地代理庫文件名,默認搜索路徑爲環境變量PATH中的路徑,options爲傳給本地庫啓動時的參數,多個參數之間用逗號分隔。在 Windows平臺上jvm搜索本地庫名爲libname.dll的文件,在linux上jvm搜索本地庫名爲libname.so的文件,搜索路徑環境 變量在不同系統上有所不同,比如Solaries上就默認搜索LD_LIBRARY_PATH。
 比如:-agentlib:hprof
 用來獲取jvm的運行情況,包括CPU、內存、線程等的運行數據,並可輸出到指定文件中;windows中搜索路徑爲JRE_HOME/bin/hprof.dll。

-agentpath:pathname[=options]
 按全路徑裝載本地庫,不再搜索PATH中的路徑;其他功能和agentlib相同;更多的信息待續,在後續的JVMTI部分會詳述。

-classpath classpath
-cp classpath

 告知jvm搜索目錄名、jar文檔名、zip文檔名,之間用分號;分隔;使用-classpath後jvm將不再使用CLASSPATH中的類搜索路徑,如果-classpath和CLASSPATH都沒有設置,則jvm使用當前路徑(.)作爲類搜索路徑。
 jvm搜索類的方式和順序爲:Bootstrap,Extension,User。
 Bootstrap中的路徑是jvm自帶的jar或zip文件,jvm首先搜索這些包文件,用System.getProperty("sun.boot.class.path")可得到搜索路徑。
 Extension是位於JRE_HOME/lib/ext目錄下的jar文件,jvm在搜索完Bootstrap後就搜索該目錄下的jar文件,用System.getProperty("java.ext.dirs")可得到搜索路徑。
 User搜索順序爲當前路徑.、CLASSPATH、-classpath,jvm最後搜索這些目錄,用System.getProperty("java.class.path")可得到搜索路徑。

-Dproperty=value
 設置系統屬性名/值對,運行在此jvm之上的應用程序可用System.getProperty("property")得到value的值。
 如果value中有空格,則需要用雙引號將該值括起來,如-Dname="space string"。
 該參數通常用於設置系統級全局變量值,如配置文件路徑,以便該屬性在程序中任何地方都可訪問。

-enableassertions[:<package name>"..." | :<class name> ]
-ea[:<package name>"..." | :<class name> ]

 上述參數就用來設置jvm是否啓動斷言機制(從JDK 1.4開始支持),缺省時jvm關閉斷言機制。
 用 -ea 可打開斷言機制,不加<packagename>和classname時運行所有包和類中的斷言,如果希望只運行某些包或類中的斷言,可將包 名或類名加到-ea之後。例如要啓動包com.wombat.fruitbat中的斷言,可用命令java -ea:com.wombat.fruitbat...<Main Class>。

-disableassertions[:<package name>"..." | :<class ; ]
-da[:<package name>"..." | :<class name> ]

 用來設置jvm關閉斷言處理,packagename和classname的使用方法和-ea相同,jvm默認就是關閉狀態。
 該參數一般用於相同package內某些class不需要斷言的場景,比如com.wombat.fruitbat需要斷言,但是com.wombat.fruitbat.Brickbat該類不需要,則可以如下運行:
 java -ea:com.wombat.fruitbat...-da:com.wombat.fruitbat.Brickbat <Main Class>。
 
-enablesystemassertions
-esa

 激活系統類的斷言。
 
-disablesystemassertions
-dsa

 關閉系統類的斷言。

-jar
 指定以jar包的形式執行一個應用程序。
 要這樣執行一個應用程序,必須讓jar包的manifest文件中聲明初始加載的Main-class,當然那Main-class必須有public static void main(String[] args)方法。

-javaagent:jarpath[=options]
 指定jvm啓動時裝入java語言設備代理。
 Jarpath 文件中的mainfest文件必須有Agent-Class屬性。代理類也必須實現公共的靜態public static void premain(String agentArgs, Instrumentation inst)方法(和main方法類似)。當jvm初始化時,將按代理類的說明順序調用premain方法;具體參見 java.lang.instrument軟件包的描述。

-verbose
-verbose:class

 輸出jvm載入類的相關信息,當jvm報告說找不到類或者類衝突時可此進行診斷。
-verbose:gc
 輸出每次GC的相關情況。
-verbose:jni
 輸出native方法調用的相關情況,一般用於診斷jni調用錯誤信息。
 
-version
 輸出java的版本信息,比如jdk版本、vendor、model。
-version:release
 指定class或者jar運行時需要的jdk版本信息;若指定版本未找到,則以能找到的系統默認jdk版本執行;一般情況下,對於jar文件,可以在manifest文件中指定需要的版本信息,而不是在命令行。
 release中可以指定單個版本,也可以指定一個列表,中間用空格隔開,且支持複雜組合,比如:
 -version:"1.5.0_04 1.5*&1.5.1_02+"
 指定class或者jar需要jdk版本爲1.5.0_04或者是1.5系列中比1.5.1_02更高的所有版本。

-showversion
 輸出java版本信息(與-version相同)之後,繼續輸出java的標準參數列表及其描述。
 
-?
-help

 輸出java標準參數列表及其描述。

-X
 輸出非標準的參數列表及其描述。

以上的這些參數我們經常會在很多情況下用到多個的組合,比如我們在用JProfiler進行跟蹤監控時,需要在被監控java啓動參數中加上如下配置:
-agentlib:jprofilerti=port=8849  -Xbootclasspath/a:/usr/local/jprofiler5/bin/agent.jar
其中就用到兩個-agentlib和-X參數,bootclasspath參數的詳細信息將會在非標準參數中詳細說明。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章