1. 程式人生 > >JVM啟動引數大全

JVM啟動引數大全

 

前段時間系統升級時遭遇了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引數的詳細資訊將會在非標準引數中詳細說明。


http://blog.csdn.net/sfdev/archive/2008/01/24/2063464.aspx

非標準引數又稱為擴充套件引數,其列表如下:
-Xint
 設定jvm以解釋模式執行,所有的位元組碼將被直接執行,而不會編譯成本地碼。
 
-Xbatch
 關閉後臺程式碼編譯,強制在前臺編譯,編譯完成之後才能進行程式碼執行;
 預設情況下,jvm在後臺進行編譯,若沒有編譯完成,則前臺執行程式碼時以解釋模式執行。
 
-Xbootclasspath:bootclasspath
 讓jvm從指定路徑(可以是分號分隔的目錄、jar、或者zip)中載入bootclass,用來替換jdk的rt.jar;若非必要,一般不會用到;
-Xbootclasspath/a:path
 將指定路徑的所有檔案追加到預設bootstrap路徑中;
-Xbootclasspath/p:path
 讓jvm優先於bootstrap預設路徑載入指定路徑的所有檔案;
 
-Xcheck:jni
 對JNI函式進行附加check;此時jvm將校驗傳遞給JNI函式引數的合法性,在原生代碼中遇到非法資料時,jmv將報一個致命錯誤而終止;使用該引數後將造成效能下降,請慎用。
 
-Xfuture
 讓jvm對類檔案執行嚴格的格式檢查(預設jvm不進行嚴格格式檢查),以符合類檔案格式規範,推薦開發人員使用該引數。
 
-Xnoclassgc
 關閉針對class的gc功能;因為其阻止記憶體回收,所以可能會導致OutOfMemoryError錯誤,慎用;
 
-Xincgc
 開啟增量gc(預設為關閉);這有助於減少長時間GC時應用程式出現的停頓;但由於可能和應用程式併發執行,所以會降低CPU對應用的處理能力。
 
-Xloggc:file
 與-verbose:gc功能類似,只是將每次GC事件的相關情況記錄到一個檔案中,檔案的位置最好在本地,以避免網路的潛在問題。
 若與verbose命令同時出現在命令列中,則以-Xloggc為準。
 
-Xmsn
 指定jvm堆的初始大小,預設為實體記憶體的1/64,最小為1M;可以指定單位,比如k、m,若不指定,則預設為位元組。
 
-Xmxn
 指定jvm堆的最大值,預設為實體記憶體的1/4或者1G,最小為2M;單位與-Xms一致。
 
-Xprof
 跟蹤正執行的程式,並將跟蹤資料在標準輸出輸出;適合於開發環境除錯。
 
-Xrs
 減少jvm對作業系統訊號(signals)的使用,該引數從1.3.1開始有效;
 從jdk1.3.0開始,jvm允許程式在關閉之前還可以執行一些程式碼(比如關閉資料庫的連線池),即使jvm被突然終止;
 jvm關閉工具通過監控控制檯的相關事件而滿足以上的功能;更確切的說,通知在關閉工具執行之前,先註冊控制檯的控制handler,然後對CTRL_C_EVENT, CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT, and CTRL_SHUTDOWN_EVENT這幾類事件直接返回true。
 但如果jvm以服務的形式在後臺執行(比如servlet引擎),他能接收CTRL_LOGOFF_EVENT事件,但此時並不需要初始化關閉程式;為了避免類似衝突的再次出現,從jdk1.3.1開始提供-Xrs引數;當此引數被設定之後,jvm將不接收控制檯的控制handler,也就是說他不監控和處理CTRL_C_EVENT, CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT, or CTRL_SHUTDOWN_EVENT事件。
 
-Xssn
 設定單個執行緒棧的大小,一般預設為512k。 

上面這些引數中,比如-Xmsn、-Xmxn……都是我們效能優化中很重要的引數;
-Xprof、-Xloggc:file等都是在沒有專業跟蹤工具情況下排錯的好手;
在上一小節中提到的關於JProfiler的配置中就使用到了-Xbootclasspath/a:path


http://blog.csdn.net/sfdev/archive/2008/01/24/2063928.aspx

前面我們提到用-XX作為字首的引數列表在jvm中可能是不健壯的,SUN也不推薦使用,後續可能會在沒有通知的情況下就直接取消了;但是由於這些引數中的確有很多是對我們很有用的,比如我們經常會見到的-XX:PermSize、-XX:MaxPermSize等等;

下面我們將就Java HotSpot VM中-XX:的可配置引數列表進行描述;
這些引數可以被鬆散的聚合成三類:
行為引數(Behavioral Options):用於改變jvm的一些基礎行為;
效能調優(Performance Tuning):用於jvm的效能調優;
除錯引數(Debugging Options):一般用於開啟跟蹤、列印、輸出等jvm引數,用於顯示jvm更加詳細的資訊;

由於sun官方文件中對各引數的描述也都非常少(大多隻有一句話),而且大多涉及OS層面的東西,很難描述清楚,所以以下是挑選了一些我們開發中可能會用得比較多的配置項,若需要檢視所有引數列表,可以點選HotSpot VM Specific Options.檢視原文;

首先來介紹行為引數

引數及其預設值描述
-XX:-DisableExplicitGC禁止呼叫System.gc();但jvm的gc仍然有效
-XX:+MaxFDLimit最大化檔案描述符的數量限制
-XX:+ScavengeBeforeFullGC新生代GC優先於Full GC執行
-XX:+UseGCOverheadLimit在丟擲OOM之前限制jvm耗費在GC上的時間比例
-XX:-UseConcMarkSweepGC對老生代採用併發標記交換演算法進行GC
-XX:-UseParallelGC啟用並行GC
-XX:-UseParallelOldGC對Full GC啟用並行,當-XX:-UseParallelGC啟用時該項自動啟用
-XX:-UseSerialGC啟用序列GC
-XX:+UseThreadPriorities啟用本地執行緒優先順序
















上面表格中黑體的三個引數代表著jvm中GC執行的三種方式,即序列、並行、併發
序列(SerialGC)是jvm的預設GC方式,一般適用於小型應用和單處理器,演算法比較簡單,GC效率也較高,但可能會給應用帶來停頓;
並行(ParallelGC)是指GC執行時,對應用程式執行沒有影響,GC和app兩者的執行緒在併發執行,這樣可以最大限度不影響app的執行;
併發(ConcMarkSweepGC)是指多個執行緒併發執行GC,一般適用於多處理器系統中,可以提高GC的效率,但演算法複雜,系統消耗較大;


效能調優
引數列表:

引數及其預設值描述
-XX:LargePageSizeInBytes=4m設定用於Java堆的大頁面尺寸
-XX:MaxHeapFreeRatio=70GC後java堆中空閒量佔的最大比例
-XX:MaxNewSize=size新生成物件能佔用記憶體的最大值
-XX:MaxPermSize=64m老生代物件能佔用記憶體的最大值
-XX:MinHeapFreeRatio=40GC後java堆中空閒量佔的最小比例
-XX:NewRatio=2新生代記憶體容量與老生代記憶體容量的比例
-XX:NewSize=2.125m新生代物件生成時佔用記憶體的預設值
-XX:ReservedCodeCacheSize=32m保留程式碼佔用的記憶體容量
-XX:ThreadStackSize=512設定執行緒棧大小,若為0則使用系統預設值
-XX:+UseLargePages使用大頁面記憶體

我們在日常效能調優中基本上都會用到以上黑體的這幾個屬性; 

除錯引數列表:

引數及其預設值描述
-XX:-CITime列印消耗在JIT編譯的時間
-XX:ErrorFile=./hs_err_pid<pid>.log儲存錯誤日誌或者資料到檔案中
-XX:-ExtendedDTraceProbes開啟solaris特有的dtrace探針
-XX:HeapDumpPath=./java_pid<pid>.hprof指定匯出堆資訊時的路徑或檔名
-XX:-HeapDumpOnOutOfMemoryError當首次遭遇OOM時匯出此時堆中相關資訊
-XX:OnError="<cmd args>;<cmd args>"出現致命ERROR之後執行自定義命令
-XX:OnOutOfMemoryError="<cmd args>;<cmd args>"當首次遭遇OOM時執行自定義命令
-XX:-PrintClassHistogram遇到Ctrl-Break後列印類例項的柱狀資訊,與jmap -histo功能相同
-XX:-PrintConcurrentLocks遇到Ctrl-Break後列印併發鎖的相關資訊,與jstack -l功能相同
-XX:-PrintCommandLineFlags列印在命令列中出現過的標記
-XX:-PrintCompilation當一個方法被編譯時列印相關資訊
-XX:-PrintGC每次GC時列印相關資訊
-XX:-PrintGC Details每次GC時列印詳細資訊
-XX:-PrintGCTimeStamps列印每次GC的時間戳
-XX:-TraceClassLoading跟蹤類的載入資訊
-XX:-TraceClassLoadingPreorder跟蹤被引用到的所有類的載入資訊
-XX:-TraceClassResolution跟蹤常量池
-XX:-TraceClassUnloading跟蹤類的解除安裝資訊
-XX:-TraceLoaderConstraints跟蹤類載入器約束的相關資訊


































當系統出現問題的時候,又不能使用外部跟蹤工具(比如JProfiler……)的情況下,以上的這些引數就會發揮重大作用了,比如dump堆資訊、列印併發鎖……