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=70 | GC後java堆中空閒量佔的最大比例 |
-XX:MaxNewSize=size | 新生成物件能佔用記憶體的最大值 |
-XX:MaxPermSize=64m | 老生代物件能佔用記憶體的最大值 |
-XX:MinHeapFreeRatio=40 | GC後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堆資訊、列印併發鎖……